{"_flat_rows": [{"action": "system.ping", "aliases": ["discovery.health"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "system", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.system.gen1"], "id": "system.ping", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "System Ping", "when_to_use": "Use to verify MCP server connectivity."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "system", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.system.gen1"], "id": "system.ping", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "System Ping", "when_to_use": "Use to verify MCP server connectivity."}, "domain": "system", "domain_title": "System MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"request": {"params": {}, "tool": "system.ping"}, "response": {"pong": true, "status": "ok", "timestamp": "2026-01-01T00:00:00Z"}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.system.gen1"], "instruction_hint": "Use to verify MCP server connectivity.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.system", "owner_gene": "core.mcp.system.gen1", "requires_preflight": false, "risk_class": "read", "safe_action": "system_ping", "semantic_input_mode": "inherit_workflow", "summary": "Health check tool — always succeeds, no authentication required.", "title": "System Ping", "when_to_use": "Use to verify MCP server connectivity.", "write_mode": null}, {"action": "system.version", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "system", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.system.gen1"], "id": "system.version", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "System Version", "when_to_use": "Smoke / deploy matrix version probe — same auth as system.ping."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "system", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.system.gen1"], "id": "system.version", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "System Version", "when_to_use": "Smoke / deploy matrix version probe — same auth as system.ping."}, "domain": "system", "domain_title": "System MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.system.gen1"], "instruction_hint": "Smoke / deploy matrix version probe — same auth as system.ping.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.system", "owner_gene": "core.mcp.system.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "system_version", "semantic_input_mode": "inherit_workflow", "summary": "Platform core version string (deploy probes; prefer over removed legacy aliases).", "title": "System Version", "when_to_use": "Smoke / deploy matrix version probe — same auth as system.ping.", "write_mode": null}, {"action": "discovery.get_platform_surfaces", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.get_platform_surfaces", "related_tools": ["discovery.search", "discovery.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Get Platform Surfaces", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Platform route inventory for Compass/docs — not tenant MCP."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.get_platform_surfaces", "related_tools": ["discovery.search", "discovery.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Get Platform Surfaces", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Platform route inventory for Compass/docs — not tenant MCP."}, "domain": "discovery", "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Platform route inventory for Compass/docs — not tenant MCP.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.search", "discovery.list"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_get_platform_surfaces", "semantic_input_mode": "inherit_workflow", "summary": "List canonical platform routes from generated platform-surface-audit.json.", "title": "Discovery Get Platform Surfaces", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Platform route inventory for Compass/docs — not tenant MCP.", "write_mode": null}, {"action": "discovery.list", "aliases": ["actions.list", "discovery.actions", "discovery.catalog", "discovery.dynamic_tools", "discovery.get_dynamic_tools", "discovery.list_actions", "discovery.mcp.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.list", "related_tools": ["discovery.summary", "discovery.search", "preflight.check", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "MCP catalog alias — same wire family as GET /mcp/actions. Default is a compact page (≤50 rows, server cap 50); pass domain= or q= to narrow. Do not cursor-walk the full catalog without filters — use d"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.list", "related_tools": ["discovery.summary", "discovery.search", "preflight.check", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "MCP catalog alias — same wire family as GET /mcp/actions. Default is a compact page (≤50 rows, server cap 50); pass domain= or q= to narrow. Do not cursor-walk the full catalog without filters — use d"}, "domain": "discovery", "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list"}, "examples": [{"name": "Compact domain page", "request": {"params": {"domain": "generation", "limit": 20, "project_id": 1}, "tool": "discovery.list"}, "response": {"data": {"compact": true, "has_more": false, "total_matched": 12}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Full plane map: agentstack://planes. Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; pri…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"actions": {"description": "array", "items": {"type": "object"}, "type": "array"}, "catalog_etag": {"description": "string", "type": "string"}, "compact": {"description": "bool", "type": "boolean"}, "has_more": {"description": "bool", "type": "boolean"}, "next_cursor": {"description": "string", "type": "string"}, "schemas_mode": {"description": "string", "type": "string"}, "source": {"description": "string", "type": "string"}, "total_matched": {"description": "integer", "type": "integer"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_map_resource": "agentstack://planes", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "recipe_id": "mcp_platform_flows_v1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.summary", "discovery.search", "preflight.check", "agents.work_next"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_list", "semantic_input_mode": "inherit_workflow", "summary": "List MCP actions — default compact page (50 rows). Set full_catalog=true for the full GET /mcp/actions body (~900 tools). Includes execute_budget (sync 60s / one heavy LLM step) and write_modes (merge", "title": "Discovery List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "MCP catalog alias — same wire family as GET /mcp/actions. Default is a compact page (≤50 rows, server cap 50); pass domain= or q= to narrow. Do not cursor-walk the full catalog without filters — use d", "write_mode": null}, {"action": "discovery.changelog", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.changelog", "related_tools": ["discovery.summary", "discovery.list", "discovery.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Changelog", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass since= as a release tag (e.g. since=0.4.22) — discovery.changelog is not discovery.list; omit domain= and q=.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate (Bearer or API key) before changelog read", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only MCP wire/catalog changelog stamp — deploy G-7 probe and operator drift checks; not a substitute for discovery.summary totals."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.changelog", "related_tools": ["discovery.summary", "discovery.list", "discovery.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Changelog", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass since= as a release tag (e.g. since=0.4.22) — discovery.changelog is not discovery.list; omit domain= and q=.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate (Bearer or API key) before changelog read", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only MCP wire/catalog changelog stamp — deploy G-7 probe and operator drift checks; not a substitute for discovery.summary totals."}, "domain": "discovery", "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Pass since= as a release tag (e.g. since=0.4.22) — discovery.changelog is not discovery.list; omit domain= and q=.", "unauthorized": "Authenticate (Bearer or API key) before changelog read"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Read-only MCP wire/catalog changelog stamp — deploy G-7 probe and operator drift checks; not a subs…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.summary", "discovery.list", "discovery.status"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_changelog", "semantic_input_mode": "inherit_workflow", "summary": "MCP wire and Work Graph contract changes since a release tag (e.g. since=0.4.22). Cheap read for agent upgrade notes.", "title": "Discovery Changelog", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass since= as a release tag (e.g. since=0.4.22) — discovery.changelog is not discovery.list; omit domain= and q=.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate (Bearer or API key) before changelog read", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only MCP wire/catalog changelog stamp — deploy G-7 probe and operator drift checks; not a substitute for discovery.summary totals.", "write_mode": null}, {"action": "discovery.summary", "aliases": ["discovery.actions_summary"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.summary", "related_tools": ["discovery.list", "discovery.status", "discovery.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Summary", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Optional read-only health check (recipe mcp_read_bootstrap) — catalog totals and etag without full catalog. Session bootstrap is mcp_session_setup, not this action. Deploy/gate probes: use this (or di"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.summary", "related_tools": ["discovery.list", "discovery.status", "discovery.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Summary", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Optional read-only health check (recipe mcp_read_bootstrap) — catalog totals and etag without full catalog. Session bootstrap is mcp_session_setup, not this action. Deploy/gate probes: use this (or di"}, "domain": "discovery", "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list"}, "execution_class": "plain_read", "flows": [{"action": "hosting.project.status", "approval": "high_risk", "id": "site", "intent": "app.edit", "phrasings": "change the site|изменить сайт|alterar site|build a website|сделай сайт|rollback the site|откати сайт", "recipe_id": "mcp_site_growth_v1", "rollback_action": "hosting.release.promote", "success": "primary_public_url set and hosting.site.edge_health edge_ready after publish", "tip": "If primary_public_url exists, edit that bucket. Do not quick_start another site. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session. Do not call MCP auth.login for the visitor.", "verify_action": "hosting.project.status", "when": "Publish or edit a hosted site"}, {"action": "notifications.deliver", "id": "notify", "recipe_id": "mcp_notify_channels_v1", "success": "notifications.list_prefs shows channel preferences", "tip": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "verify_action": "notifications.list_prefs", "when": "Email or bot notice to a user"}, {"action": "crm.list_contacts", "approval": "never", "id": "crm", "intent": "crm.contact.manage", "phrasings": "add a contact|добавь клиента|adicionar contato", "recipe_id": "mcp_crm_contact_deal", "rollback_action": "crm.erase_contact", "success": "crm.get_contact_360 returns the contact", "tip": "One CRM. An empty list after upsert is the sandbox head — crm.get_contact_360. Do not insert a second contact. crm.list_board readiness=pending follows next_actions. Do not create_deal. Do not promote.", "verify_action": "crm.get_contact_360", "when": "Contacts and deals"}, {"action": "knowledge.health", "approval": "never", "cancel": "unsupported", "id": "knowledge", "intent": "knowledge.ingest", "phrasings": "upload documents|загрузи документы|base de conhecimento", "recipe_id": "mcp_knowledge_ingest", "success": "knowledge.health reports the collection", "tip": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "verify_action": "knowledge.health", "when": "Ground answers in project docs"}, {"action": "agents.list", "approval": "high_risk", "id": "agents", "intent": "agent.promote", "phrasings": "run an agent|запусти агента|rodar agente", "recipe_id": "mcp_agents_run_approve", "rollback_action": "agents.stop", "success": "agents.list shows the fleet", "tip": "Templates: agents.templates_list. One heavy run per batch. An empty agents.list is valid. Do not create a second agent.", "verify_action": "agents.list", "when": "Run a fleet agent"}, {"action": "hosting.project.status", "approval": "on_request", "id": "design_landing", "intent": "design.redesign", "phrasings": "redesign landing page|переделай лендинг|redesenhar landing", "recipe_id": "mcp_site_growth_v1", "success": "browser_verification.passed or primary_public_url updated", "tip": "Route via design.redesign taxonomy; verify with browser_verification.passed when step tagged verify.", "verify_action": "hosting.project.status", "when": "Redesign or review landing UX"}, {"action": "bots.list", "approval": "never", "id": "bots", "intent": "bot.go_live", "phrasings": "create a telegram bot|создай бота|criar bot", "recipe_id": "mcp_bots_simulate", "success": "bots.list shows the channel bot", "tip": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "verify_action": "bots.list", "when": "Create or test a channel bot"}, {"action": "payments.get_balance", "approval": "high_risk", "id": "payments", "intent": "payments.inspect", "phrasings": "billing|invoice|расход|gasto", "recipe_id": "mcp_integrations_checkout_crm", "success": "payments.get_balance returns the wallet", "tip": "Fiat is AgentPay. On-chain AGNT is agentnet.balance, not a second checkout. An empty balance is valid. Do not open a second checkout.", "verify_action": "integrations.connection_health", "when": "Checkout or wallet balance"}, {"action": "generation.list", "id": "generation", "recipe_id": "mcp_generation_diff", "success": "generation.list shows sandbox anchors", "tip": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "verify_action": "generation.list", "when": "Change tenant 8DNA safely"}, {"action": "social.support.inbox", "id": "support", "recipe_id": "mcp_support_inbox", "success": "social.support.inbox lists open threads", "tip": "Reply stays on the support thread. It is not social.chat and not a bot transcript.", "verify_action": "social.support.inbox", "when": "Staff support inbox"}, {"action": "rbac.get_roles", "id": "access", "recipe_id": "mcp_user_access_safe", "success": "rbac.get_roles returns project roles", "tip": "Field policy is data_access.set_policy, not a new permission table.", "verify_action": "rbac.get_roles", "when": "Roles and field access"}, {"action": "logic.list", "id": "rules", "recipe_id": "mcp_integrations_webhook_scheduler", "success": "logic.list shows automations", "tip": "Preview with logic.dry_run. The server keeps the sandbox head. Cancel a schedule with scheduler.cancel_task, not create_task.", "verify_action": "logic.list", "when": "When X then Y"}, {"action": "assets.list", "id": "catalog", "recipe_id": "mcp_site_growth_v1", "success": "hosting.project.status and assets.list on canonical slice", "tip": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "verify_action": "hosting.project.status", "when": "Digital goods or a storefront"}, {"action": "shop.orders.get", "approval": "never", "id": "shop_order_status", "intent": "shop.order.lookup", "phrasings": "order status|order_id|статус заказа|status do pedido", "recipe_id": "mcp_shop_order_lookup_v1", "success": "shop.orders.get returned order state", "tip": "Read-only order lookup — not payments.create and not shop.checkout.create.", "verify_action": "shop.orders.get", "when": "Check shop order or payment status by order_id"}, {"action": "payments.get_balance", "approval": "never", "id": "commerce_read", "intent": "business.status", "phrasings": "business status|статус бизнеса|status do negocio", "recipe_id": "mcp_commerce_orient", "success": "payments.get_balance and wallets.list loaded", "tip": "Open a wallet, then deposit in the next recipe with the copied wallet_id. This is the business status read. Do not call thirty raw payment tools. For shop order_id status use shop.orders.get — not this atom.", "verify_action": "payments.get_balance", "when": "See balance, wallets, and assets"}, {"action": "logic.list", "approval": "never", "id": "logic", "intent": "automation.create", "phrasings": "when a lead|каждый новый|quando um lead", "recipe_id": "mcp_logic_orient", "success": "logic.list contains the rule", "tip": "Create with mcp_logic_create. Dry-run needs the returned logic_id. An empty logic.list is this scope. Do not create a second rule.", "verify_action": "logic.list", "when": "Create a when-then rule"}, {"action": "storage.get_quota", "approval": "never", "id": "files", "intent": "files.inspect", "phrasings": "storage quota|квота|quota de arquivos", "recipe_id": "mcp_storage_orient", "success": "storage.get_quota returns used bytes", "tip": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "verify_action": "storage.get_quota", "when": "Check storage quota or list files"}, {"action": "scheduler.list_tasks", "approval": "never", "id": "schedule", "intent": "scheduler.daily", "phrasings": "every morning|каждый день|todo dia", "recipe_id": "mcp_scheduler_orient", "rollback_action": "scheduler.cancel_task", "success": "scheduler.list_tasks shows the cron", "tip": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "verify_action": "scheduler.list_tasks", "when": "Run something on a cron"}, {"action": "guidance.match_playbook", "id": "compass", "recipe_id": "mcp_guidance_match", "success": "guidance.match_playbook returns a playbook id", "tip": "Copy the playbook id into mcp_guidance_start.", "verify_action": "guidance.match_playbook", "when": "Start a guided Compass path"}, {"action": "finance.project.portfolio", "id": "treasury", "recipe_id": "mcp_treasury_read", "success": "finance.project.portfolio returns treasury snapshot", "tip": "AgentNet proofs stay on agentnet.*.", "verify_action": "finance.project.portfolio", "when": "Project treasury versus user wallets"}, {"action": "projects.orchestrator.get", "id": "orchestrator", "recipe_id": "mcp_agents_orchestrator_configure", "success": "projects.orchestrator.get shows routing config", "tip": "Then mcp_orch_faq_desk, mcp_orch_support_desk, or mcp_orch_api_desk. One channel owner.", "verify_action": "projects.orchestrator.get", "when": "Route replies across chat, bot, or an external API"}, {"action": "auth.get_profile", "approval": "never", "id": "session", "intent": "project.inspect", "phrasings": "what is in my project|посмотри проект|o que tem no projeto", "recipe_id": "mcp_session_setup", "success": "auth.get_profile session_ready", "tip": "One jti covers every project membership allows. mutation_allowed true: do not switch_project and do not log in again. A restart rehydrates that jti from 8DNA. A page at /s/{id}/ uses the hosted cookie, not this jti.", "verify_action": "auth.get_profile", "when": "Use one login across projects"}, {"action": "discovery.status", "approval": "never", "id": "diagnose", "intent": "project.diagnose", "phrasings": "what is broken|что сломано|o que quebrou", "recipe_id": "mcp_readonly_audit_v1", "success": "diagnostics.consistency.scan finished with no writes", "tip": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "verify_action": "discovery.status", "when": "Inspect health before any repair"}, {"action": "seo.health.check", "id": "seo", "recipe_id": "mcp_seo_health_v1", "success": "seo.health.check reports registry readiness", "tip": "Registry caps live in shared/seo — not hosting.bucket.file.patch. After copy deploy: seo.cache.clear.", "verify_action": "seo.health.check", "when": "Marketing meta readiness and sample path meta"}, {"action": "showcase.catalog.get", "id": "showcase", "recipe_id": "mcp_showcase_catalog_safe", "success": "showcase.catalog.get returns demo entries", "tip": "Bind project_id=1. Diff vs fixture before upsert. Tenant DNA uses generation.promote, not showcase.catalog.", "verify_action": "showcase.catalog.get", "when": "Read the ecosystem demo gallery (project 1 only)"}, {"action": "showcase.sources.sync_status", "id": "showcase_vps", "recipe_id": "mcp_showcase_vps_ops", "success": "showcase.health.probe stamps ok for proof entries", "tip": "Deploy: showcase_build_all or deploy.showcase_* steps. MCP documents sync contract; build via hosting.site.build or VPS script.", "verify_action": "showcase.health.probe", "when": "Platform proof static sites (1438–1443) — VPS-primary build and republish"}, {"action": "shop.enablement.status", "approval": "never", "id": "commerce", "intent": "tenant_iap_checkout", "phrasings": "in-app purchase|shop checkout|tenant iap|купить в приложении", "recipe_id": "mcp_tenant_iap_checkout_v1", "success": "shop.checkout.create returns order_id in sandbox or live per enablement", "tip": "Hosted game or app shop: shop.enablement.status → shop.products.list → shop.checkout.create with idempotency_key. Not bare payments.create for IAP orders.", "verify_action": "shop.orders.get", "when": "Buyer in-app purchase / tenant shop checkout"}, {"action": "shop.products.upsert", "approval": "project_write", "id": "tenant_iap_catalog", "intent": "tenant_iap_catalog", "phrasings": "iap catalog|server priced sku|shop.products.upsert|каталог iap|catálogo iap", "recipe_id": "mcp_tenant_iap_catalog_v1", "success": "shop.products.list shows active SKU rows", "tip": "Owner ladder: shop.enablement.status → assets.create → shop.products.upsert (active) → shop.products.list — not commerce.sell.activate for game IAP SKUs.", "verify_action": "shop.products.list", "when": "Owner builds server-priced IAP SKUs (enablement → asset → upsert)"}, {"action": "commerce.channel_pass.configure", "approval": "project_write", "id": "channel_pass_owner", "intent": "channel_pass_owner", "phrasings": "channel pass|closed channel|telegram subscription|nebula|пропуск канал", "recipe_id": "mcp_channel_pass_owner_v1", "success": "binding leaf present; active channel_pass SKU", "tip": "commerce.channel_pass.configure → shop.products.upsert (channel_pass grant) → scheduler.create_task (commerce.channel_pass.sweep).", "verify_action": "commerce.channel_pass.binding.get", "when": "Owner sells Telegram closed-channel access (bot /passes)"}, {"action": "commerce.checkout.session", "approval": "never", "id": "marketplace_buyer_checkout", "intent": "commerce.checkout.session", "phrasings": "marketplace checkout|buy listing|купить листинг|checkout marketplace", "recipe_id": "mcp_marketplace_checkout_v1", "success": "commerce.checkout.session returns session_id", "tip": "Buyer path: commerce.checkout.session with listing_id, idempotency_key, and rail — not commerce.sell.activate.", "verify_action": "commerce.checkout.session", "when": "Marketplace buyer checkout session (listing + rail)"}, {"action": "commerce.sell.activate", "approval": "project_write", "id": "commerce_seller_activate", "intent": "commerce.sell.activate", "phrasings": "start selling|seller activate|начать продавать|ativar vendedor", "recipe_id": "mcp_commerce_seller_activate_v1", "success": "commerce.sell.activate returns activation state", "tip": "Seller rail — commerce.sell.activate with idempotency_key. Not buyer checkout session.", "verify_action": "commerce.sell.activate", "when": "Seller onboarding / sell.activate on tenant commerce"}, {"action": "safety.evaluate", "id": "safety", "recipe_id": "mcp_safety_probe", "success": "safety.evaluate returns probe verdict", "tip": "safety.evaluate is a rules-first read. Playbook overlays go through generation.promote, not a second safety model.", "verify_action": "safety.evaluate", "when": "Probe one text before ingest or bot reply"}], "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Optional read-only health check (recipe mcp_read_bootstrap) — catalog totals and etag without full …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "recipe_id": "mcp_platform_flows_v1", "registry_counter_contract": {"catalog_actions_public": "Marketing constant MCP_CATALOG_ACTIONS.", "domain_count": "Domains in catalog payload map (includes REST-only domains).", "domains_public": "Marketing floor MCP_ACTION_DOMAINS — not a third live count.", "executable_domain_count": "domain_count minus REST-only domains.", "mcp_executable_total": "Catalog actions minus REST-only commerce_rest / rest.* domains (registry_dimensions).", "public_total": "Doc-audience public+tenant tools among economy-visible registry rows (catalog_scope); not the same as principal_visible_total (L1 service_caps).", "registry_tools": "Live @mcp_tool rows in MCP_TOOLS_REGISTRY after economy_crypto_policy visibility filter.", "registry_total": "All registered tools in discovery.status populations.", "total_actions": "Catalog total_actions from cache when present; otherwise matches registry_tools on summary miss."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.list", "discovery.status", "discovery.search"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_summary", "semantic_input_mode": "inherit_workflow", "summary": "Lightweight MCP catalog totals (alias for GET /mcp/actions/summary).", "title": "Discovery Summary", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Optional read-only health check (recipe mcp_read_bootstrap) — catalog totals and etag without full catalog. Session bootstrap is mcp_session_setup, not this action. Deploy/gate probes: use this (or di", "write_mode": null}, {"action": "discovery.status", "aliases": ["discovery.bootstrap"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.status", "related_tools": ["discovery.search", "discovery.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Step 2 discovery ladder — registry totals/etag before full catalog load. Deploy matrix G-02 default probe (set AGENTSTACK_MATRIX_FULL_SPINE=1 for discovery.summary + plan_get spine)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.status", "related_tools": ["discovery.search", "discovery.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Step 2 discovery ladder — registry totals/etag before full catalog load. Deploy matrix G-02 default probe (set AGENTSTACK_MATRIX_FULL_SPINE=1 for discovery.summary + plan_get spine)."}, "domain": "discovery", "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Step 2 discovery ladder — registry totals/etag before full catalog load. Deploy matrix G-02 default…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.search", "discovery.list"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_status", "semantic_input_mode": "inherit_workflow", "summary": "Registry status — version, catalog etag, action/domain/recipe totals.", "title": "Discovery Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Step 2 discovery ladder — registry totals/etag before full catalog load. Deploy matrix G-02 default probe (set AGENTSTACK_MATRIX_FULL_SPINE=1 for discovery.summary + plan_get spine).", "write_mode": null}, {"action": "discovery.recipes", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.recipes", "related_tools": ["discovery.describe", "discovery.search", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Recipes", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass recipe filter (domain, tag) or options.recipe_id — not discovery.list domain/q filters.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "recipe_not_found": "Unknown recipe_id — discovery.describe the recipe or discovery.search workflow playbooks.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate before listing named recipes for agentstack.execute recipe_id.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Onboarding subset of recipes — full registry GET /mcp/recipes or discovery.search. Execute via options.recipe_id on agentstack.execute; recipes are not discovery.describe actions. Tenant business assi"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.recipes", "related_tools": ["discovery.describe", "discovery.search", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Recipes", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass recipe filter (domain, tag) or options.recipe_id — not discovery.list domain/q filters.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "recipe_not_found": "Unknown recipe_id — discovery.describe the recipe or discovery.search workflow playbooks.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate before listing named recipes for agentstack.execute recipe_id.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Onboarding subset of recipes — full registry GET /mcp/recipes or discovery.search. Execute via options.recipe_id on agentstack.execute; recipes are not discovery.describe actions. Tenant business assi"}, "domain": "discovery", "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Pass recipe filter (domain, tag) or options.recipe_id — not discovery.list domain/q filters.", "recipe_not_found": "Unknown recipe_id — discovery.describe the recipe or discovery.search workflow playbooks.", "unauthorized": "Authenticate before listing named recipes for agentstack.execute recipe_id."}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Onboarding subset of recipes — full registry GET /mcp/recipes or discovery.search. Execute via opti…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.describe", "discovery.search", "preflight.check"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_recipes", "semantic_input_mode": "inherit_workflow", "summary": "List onboarding MCP recipes (instruction plane SoT).", "title": "Discovery Recipes", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass recipe filter (domain, tag) or options.recipe_id — not discovery.list domain/q filters.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "recipe_not_found": "Unknown recipe_id — discovery.describe the recipe or discovery.search workflow playbooks.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate before listing named recipes for agentstack.execute recipe_id.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Onboarding subset of recipes — full registry GET /mcp/recipes or discovery.search. Execute via options.recipe_id on agentstack.execute; recipes are not discovery.describe actions. Tenant business assi", "write_mode": null}, {"action": "discovery.domain", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.domain", "related_tools": ["discovery.search", "discovery.describe"], "returns": {"instruction_packet": "object — hoisted step contract (allowed_actions, step_id, goal_verification)", "observed": "object — inverse slots echoed when passed in params", "recommended_actions": "array", "response_mode": "string — workflow when goal router selects a playbook", "routed_goal": "object — intent_id / primary_action from goal resolution", "selected_workflow": "object — playbook shell; slots.instruction_packet when response_mode=workflow", "semantic_contract": "object — fingerprinted goal facets (effect_constraints, forbidden_concepts)"}, "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Domain", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "domain_required": "Pass domain= for discovery.domain (e.g. crm, storage, knowledge).", "invalid_parameters": "Pass domain= for discovery.domain (e.g. crm, storage, knowledge).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Browse one catalog domain without the full catalog — compact path shared with discovery.search. Requires domain= (e.g. crm, generation, storage); then discovery.describe on a canonical action id."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.domain", "related_tools": ["discovery.search", "discovery.describe"], "returns": {"instruction_packet": "object — hoisted step contract (allowed_actions, step_id, goal_verification)", "observed": "object — inverse slots echoed when passed in params", "recommended_actions": "array", "response_mode": "string — workflow when goal router selects a playbook", "routed_goal": "object — intent_id / primary_action from goal resolution", "selected_workflow": "object — playbook shell; slots.instruction_packet when response_mode=workflow", "semantic_contract": "object — fingerprinted goal facets (effect_constraints, forbidden_concepts)"}, "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Domain", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "domain_required": "Pass domain= for discovery.domain (e.g. crm, storage, knowledge).", "invalid_parameters": "Pass domain= for discovery.domain (e.g. crm, storage, knowledge).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Browse one catalog domain without the full catalog — compact path shared with discovery.search. Requires domain= (e.g. crm, generation, storage); then discovery.describe on a canonical action id."}, "domain": "discovery", "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"domain_required": "Pass domain= for discovery.domain (e.g. crm, storage, knowledge)."}, "examples": [{"name": "Single-domain catalog slice", "request": {"params": {"domain": "generation", "limit": 20, "project_id": 1}, "tool": "discovery.domain"}, "response": {"data": {"actions": [{"action": "generation.promote", "domain": "generation"}]}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Browse one catalog domain without the full catalog — compact path shared with discovery.search. Req…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.search", "discovery.describe"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_domain", "semantic_input_mode": "inherit_workflow", "summary": "List actions in one catalog domain (wrapper over discovery.search).", "title": "Discovery Domain", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "domain_required": "Pass domain= for discovery.domain (e.g. crm, storage, knowledge).", "invalid_parameters": "Pass domain= for discovery.domain (e.g. crm, storage, knowledge).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Browse one catalog domain without the full catalog — compact path shared with discovery.search. Requires domain= (e.g. crm, generation, storage); then discovery.describe on a canonical action id.", "write_mode": null}, {"action": "discovery.search", "aliases": ["actions.search", "catalog.search", "discovery.search_actions", "help"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.search", "recovery_blocks": {"work_next_hydrate_failed": {"next_actions": [{"action": "agents.work_next", "params": {"repair": true}}], "reason": "work_next_hydrate_failed"}}, "related_tools": ["agents.work_next", "discovery.describe", "discovery.list", "discovery.status", "discovery.recipes", "preflight.check", "shop.enablement.status", "payments.list_methods"], "returns": {"instruction_packet": "object — hoisted step contract (allowed_actions, step_id, goal_verification)", "observed": "object — inverse slots echoed when passed in params", "recommended_actions": "array", "response_mode": "string — workflow when goal router selects a playbook", "routed_goal": "object — intent_id / primary_action from goal resolution", "selected_workflow": "object — playbook shell; slots.instruction_packet when response_mode=workflow", "semantic_contract": "object — fingerprinted goal facets (effect_constraints, forbidden_concepts)"}, "semantic_input_mode": "per_step_nl", "source": "overlay", "title": "Discovery Search", "when_blocked": {"batch_semantic_anchor_conflict": "Align step NL with batch goal anchor — use one goal_text for the batch or split batches", "batch_semantic_anchor_required": "Batch includes a mutating or non-plain-read step: set options.execution_intent=direct for authorized CRUD, or options.goal, focus_node_id, or plan_execute_mode for workflow. Plain reads and validate_only (e.g. script.put) may run without goal. Use preflight.check simulate_batch_actions + simulate_batch_params (or execution_intent) to preview anchor.", "batch_semantic_goal_mismatch": "Step discovery.search q diverges from the batch goal — align q with options.goal_text, omit the goal, or run the search in its own execute. The server compares them whether or not semantic_strict is set.", "conflicting_semantic_anchor": "Alias for batch_semantic_anchor_conflict — align step NL with batch options.goal", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "discovery_contract_conflict": "Compiled discovery contract blocked this query — read execution_contract.violations, forbidden_actions, and semantic_contract; fix NL anchor or run discovery.describe on allowed_actions[0] only. Do not execute actions outside instruction_packet.", "discovery_search_failed": "discovery.search failed after ranking — retry once with a narrower q; read discovery_stage_failed and X-Trace-Id in logs; do not parallel-spam discovery.search.", "discovery_search_recursion": "Unified discovery graph exceeded depth — narrow q, use discovery.describe on one action id, or split into another execute (do not retry the same query blob). Playbook: docs/operations/MCP_CLIENT_MISUSE_PLAYBOOK.md", "discovery_search_reentrant": "Nested discovery.search in one execute — at most one search per batch; reuse actions[] from the first result, then discovery.describe.", "discovery_search_truncated": "Discovery graph depth or duplicate query — narrow q, use discovery.describe on one canonical action id, or split into another execute.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Unknown or empty discovery params — use q= / query= / intent= for NL search; prefix= is aliased to domain= when it is a single token. Run discovery.describe on one canonical action id after a single discovery.search.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_project": "Bind context.project_id — workspace switcher or agents.work_next with project scope.", "no_match": "Broaden q or use discovery.list domain= — no_match is not a missing product", "node_scope_empty": "Bind context.project_id — workspace switcher or agents.work_next with project scope.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "semantic_contract_fingerprint_required": "Omit client semantic_contract blobs unless you implement the fingerprint contract — prefer options.goal_text on the batch or a plain discovery.search q= without semantic_contract.", "session_setup_required": "Run agentstack_session_setup — bind context.project_id before domain search", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix params against discovery.describe schema — discovery.search uses q= (natural language), not prefix= unless the tool schema documents prefix. Negative example: prefix=hosting.git → validation_error; use q=hosting git journal instead.", "work_next_hydrate_failed": "Work-graph hydrate failed during discovery — run agents.work_next with repair=true and detail=compact; narrow discovery.search q or retry without scope=node hydrate.", "work_next_next_action_present": "Packet has next_action — run agents.work_next / follow prefer_action before catalog search; WG-SLO-04 compliance. Audit batches: loop_mode=audit or allow_catalog_while_next_action."}, "when_not_to_use": "Do not call until context.project_id is bound. Do not call when agents.work_next packet.next_action is present — run that action first.", "when_to_use": "After VPS backend restart, first agents.work_next may fail while MCP tools import — wait ~15s and retry once (not a plan graph bug). Bound project: agents.work_next (recipe mcp_work_loop_v1) before ca"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.search", "recovery_blocks": {"work_next_hydrate_failed": {"next_actions": [{"action": "agents.work_next", "params": {"repair": true}}], "reason": "work_next_hydrate_failed"}}, "related_tools": ["agents.work_next", "discovery.describe", "discovery.list", "discovery.status", "discovery.recipes", "preflight.check", "shop.enablement.status", "payments.list_methods"], "returns": {"instruction_packet": "object — hoisted step contract (allowed_actions, step_id, goal_verification)", "observed": "object — inverse slots echoed when passed in params", "recommended_actions": "array", "response_mode": "string — workflow when goal router selects a playbook", "routed_goal": "object — intent_id / primary_action from goal resolution", "selected_workflow": "object — playbook shell; slots.instruction_packet when response_mode=workflow", "semantic_contract": "object — fingerprinted goal facets (effect_constraints, forbidden_concepts)"}, "semantic_input_mode": "per_step_nl", "source": "overlay", "title": "Discovery Search", "when_blocked": {"batch_semantic_anchor_conflict": "Align step NL with batch goal anchor — use one goal_text for the batch or split batches", "batch_semantic_anchor_required": "Batch includes a mutating or non-plain-read step: set options.execution_intent=direct for authorized CRUD, or options.goal, focus_node_id, or plan_execute_mode for workflow. Plain reads and validate_only (e.g. script.put) may run without goal. Use preflight.check simulate_batch_actions + simulate_batch_params (or execution_intent) to preview anchor.", "batch_semantic_goal_mismatch": "Step discovery.search q diverges from the batch goal — align q with options.goal_text, omit the goal, or run the search in its own execute. The server compares them whether or not semantic_strict is set.", "conflicting_semantic_anchor": "Alias for batch_semantic_anchor_conflict — align step NL with batch options.goal", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "discovery_contract_conflict": "Compiled discovery contract blocked this query — read execution_contract.violations, forbidden_actions, and semantic_contract; fix NL anchor or run discovery.describe on allowed_actions[0] only. Do not execute actions outside instruction_packet.", "discovery_search_failed": "discovery.search failed after ranking — retry once with a narrower q; read discovery_stage_failed and X-Trace-Id in logs; do not parallel-spam discovery.search.", "discovery_search_recursion": "Unified discovery graph exceeded depth — narrow q, use discovery.describe on one action id, or split into another execute (do not retry the same query blob). Playbook: docs/operations/MCP_CLIENT_MISUSE_PLAYBOOK.md", "discovery_search_reentrant": "Nested discovery.search in one execute — at most one search per batch; reuse actions[] from the first result, then discovery.describe.", "discovery_search_truncated": "Discovery graph depth or duplicate query — narrow q, use discovery.describe on one canonical action id, or split into another execute.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Unknown or empty discovery params — use q= / query= / intent= for NL search; prefix= is aliased to domain= when it is a single token. Run discovery.describe on one canonical action id after a single discovery.search.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_project": "Bind context.project_id — workspace switcher or agents.work_next with project scope.", "no_match": "Broaden q or use discovery.list domain= — no_match is not a missing product", "node_scope_empty": "Bind context.project_id — workspace switcher or agents.work_next with project scope.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "semantic_contract_fingerprint_required": "Omit client semantic_contract blobs unless you implement the fingerprint contract — prefer options.goal_text on the batch or a plain discovery.search q= without semantic_contract.", "session_setup_required": "Run agentstack_session_setup — bind context.project_id before domain search", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix params against discovery.describe schema — discovery.search uses q= (natural language), not prefix= unless the tool schema documents prefix. Negative example: prefix=hosting.git → validation_error; use q=hosting git journal instead.", "work_next_hydrate_failed": "Work-graph hydrate failed during discovery — run agents.work_next with repair=true and detail=compact; narrow discovery.search q or retry without scope=node hydrate.", "work_next_next_action_present": "Packet has next_action — run agents.work_next / follow prefer_action before catalog search; WG-SLO-04 compliance. Audit batches: loop_mode=audit or allow_catalog_while_next_action."}, "when_not_to_use": "Do not call until context.project_id is bound. Do not call when agents.work_next packet.next_action is present — run that action first.", "when_to_use": "After VPS backend restart, first agents.work_next may fail while MCP tools import — wait ~15s and retry once (not a plan graph bug). Bound project: agents.work_next (recipe mcp_work_loop_v1) before ca"}, "do_not_use_when": "Do not call until context.project_id is bound. Do not call when agents.work_next packet.next_action is present — run that action first.", "domain": "discovery", "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "effect_kind": "read", "errors": {"batch_semantic_anchor_conflict": "Align step NL with batch goal anchor — use one goal_text for the batch or split batches", "batch_semantic_anchor_required": "Batch includes a mutating or non-plain-read step: set options.execution_intent=direct for authorized CRUD, or options.goal, focus_node_id, or plan_execute_mode for workflow. Plain reads and validate_only (e.g. script.put) may run without goal. Use preflight.check simulate_batch_actions + simulate_batch_params (or execution_intent) to preview anchor.", "batch_semantic_goal_mismatch": "Step discovery.search q diverges from the batch goal — align q with options.goal_text, omit the goal, or run the search in its own execute. The server compares them whether or not semantic_strict is set.", "conflicting_semantic_anchor": "Alias for batch_semantic_anchor_conflict — align step NL with batch options.goal", "discovery_contract_conflict": "Compiled discovery contract blocked this query — read execution_contract.violations, forbidden_actions, and semantic_contract; fix NL anchor or run discovery.describe on allowed_actions[0] only. Do not execute actions outside instruction_packet.", "discovery_search_failed": "discovery.search failed after ranking — retry once with a narrower q; read discovery_stage_failed and X-Trace-Id in logs; do not parallel-spam discovery.search.", "discovery_search_recursion": "Unified discovery graph exceeded depth — narrow q, use discovery.describe on one action id, or split into another execute (do not retry the same query blob). Playbook: docs/operations/MCP_CLIENT_MISUSE_PLAYBOOK.md", "discovery_search_reentrant": "Nested discovery.search in one execute — at most one search per batch; reuse actions[] from the first result, then discovery.describe.", "discovery_search_truncated": "Discovery graph depth or duplicate query — narrow q, use discovery.describe on one canonical action id, or split into another execute.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Unknown or empty discovery params — use q= / query= / intent= for NL search; prefix= is aliased to domain= when it is a single token. Run discovery.describe on one canonical action id after a single discovery.search.", "missing_project": "Bind context.project_id — workspace switcher or agents.work_next with project scope.", "no_match": "Broaden q or use discovery.list domain= — no_match is not a missing product", "node_scope_empty": "Bind context.project_id — workspace switcher or agents.work_next with project scope.", "semantic_contract_fingerprint_required": "Omit client semantic_contract blobs unless you implement the fingerprint contract — prefer options.goal_text on the batch or a plain discovery.search q= without semantic_contract.", "session_setup_required": "Run agentstack_session_setup — bind context.project_id before domain search", "validation_error": "Fix params against discovery.describe schema — discovery.search uses q= (natural language), not prefix= unless the tool schema documents prefix. Negative example: prefix=hosting.git → validation_error; use q=hosting git journal instead.", "work_next_hydrate_failed": "Work-graph hydrate failed during discovery — run agents.work_next with repair=true and detail=compact; narrow discovery.search q or retry without scope=node hydrate.", "work_next_next_action_present": "Packet has next_action — run agents.work_next / follow prefer_action before catalog search; WG-SLO-04 compliance. Audit batches: loop_mode=audit or allow_catalog_while_next_action."}, "examples": [{"name": "NL query with slim contract fast-path", "request": {"params": {"project_id": 1, "q": "view analytics dashboard", "semantic_contract": {"effect_constraints": ["read_only"], "fingerprint": "example-fp-discovery", "primary_intent": "analytics.view"}}, "tool": "discovery.search"}, "response": {"data": {"discovery_resolution": {"primary_intent": "analytics.view"}, "semantic_contract": {"fingerprint": "example-fp-discovery"}}, "success": true}}, {"name": "Tenant IAP buyer NL search", "request": {"params": {"limit": 8, "project_id": 1444, "q": "visitor in-app purchase checkout game store", "schemas_mode": "none"}, "tool": "discovery.search"}, "response": {"data": {"ranking_mode": "tenant_iap_intent_lock", "recommended_recipe": "mcp_tenant_iap_checkout_v1"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Full plane map: agentstack://planes. Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; pri…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"actions": {"description": "array — compact catalog rows (≤limit)", "items": {"type": "object"}, "type": "array"}, "actions_semantics": {"description": "string — catalog row role hints (candidate vs primary)", "type": "string"}, "canonical_route": {"additionalProperties": true, "description": "object", "type": "object"}, "domain_projection": {"additionalProperties": true, "description": "object — covered vs unprojected platform domains", "type": "object"}, "instruction_packet": {"additionalProperties": true, "description": "object — hoisted step contract (allowed_actions, step_id, goal_verification)", "type": "object"}, "intent_confidence": {"description": "number", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "meta": {"additionalProperties": true, "description": "object — pagination, locale, contract_fallback", "type": "object"}, "needs_work_graph": {"description": "boolean — goal requires work graph plane", "type": "boolean"}, "observed": {"additionalProperties": true, "description": "object — inverse slots echoed when passed in params", "type": "object"}, "playbook_hint": {"description": "string — Compass route hint when present", "type": "string"}, "primary_actions": {"description": "array", "items": {"type": "string"}, "type": "array"}, "primary_workflow": {"additionalProperties": true, "description": "object — taxonomy primary workflow when resolved", "type": "object"}, "probable_intent": {"description": "string", "type": "string"}, "recommended_actions": {"description": "array", "items": {"type": "string"}, "type": "array"}, "recommended_actions_filter": {"additionalProperties": true, "description": "object — dropped_unregistered or forbidden_effects rollup + recovery_hint", "type": "object"}, "recommended_actions_semantics": {"description": "string — how to interpret recommended_actions scores", "type": "string"}, "recommended_recipe": {"additionalProperties": true, "description": "object|null — onboarding recipe hint", "type": "object"}, "response_mode": {"description": "string — workflow when goal router selects a playbook", "type": "string"}, "routed_goal": {"additionalProperties": true, "description": "object — intent_id / primary_action from goal resolution", "type": "object"}, "selected_workflow": {"additionalProperties": true, "description": "object — playbook shell; slots.instruction_packet when response_mode=workflow", "type": "object"}, "semantic_contract": {"additionalProperties": true, "description": "object — fingerprinted goal facets (effect_constraints, forbidden_concepts)", "type": "object"}, "semantic_fingerprint": {"description": "string — stable digest of semantic_contract", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_map_resource": "agentstack://planes", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "recipe_id": "mcp_platform_flows_v1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["agents.work_next", "discovery.describe", "discovery.list", "discovery.status", "discovery.recipes", "preflight.check", "shop.enablement.status", "payments.list_methods"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_search", "semantic_input_mode": "per_step_nl", "summary": "Compact catalog search — returns ≤50 matching actions (not full discovery.list). Rows omit JSON schemas unless schemas_mode is set. Instruction text is one locale.", "team_create_rank_policy": "Team-create goals (agents.team.create): discovery rank demotes integrations.* — prefer agents.team.create / agents.orchestrate / agents.plan_* over integrations.oauth_begin.", "title": "Discovery Search", "when_blocked": {"batch_semantic_anchor_conflict": "Align step NL with batch goal anchor — use one goal_text for the batch or split batches", "batch_semantic_anchor_required": "Batch includes a mutating or non-plain-read step: set options.execution_intent=direct for authorized CRUD, or options.goal, focus_node_id, or plan_execute_mode for workflow. Plain reads and validate_only (e.g. script.put) may run without goal. Use preflight.check simulate_batch_actions + simulate_batch_params (or execution_intent) to preview anchor.", "batch_semantic_goal_mismatch": "Step discovery.search q diverges from the batch goal — align q with options.goal_text, omit the goal, or run the search in its own execute. The server compares them whether or not semantic_strict is set.", "conflicting_semantic_anchor": "Alias for batch_semantic_anchor_conflict — align step NL with batch options.goal", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "discovery_contract_conflict": "Compiled discovery contract blocked this query — read execution_contract.violations, forbidden_actions, and semantic_contract; fix NL anchor or run discovery.describe on allowed_actions[0] only. Do not execute actions outside instruction_packet.", "discovery_search_failed": "discovery.search failed after ranking — retry once with a narrower q; read discovery_stage_failed and X-Trace-Id in logs; do not parallel-spam discovery.search.", "discovery_search_recursion": "Unified discovery graph exceeded depth — narrow q, use discovery.describe on one action id, or split into another execute (do not retry the same query blob). Playbook: docs/operations/MCP_CLIENT_MISUSE_PLAYBOOK.md", "discovery_search_reentrant": "Nested discovery.search in one execute — at most one search per batch; reuse actions[] from the first result, then discovery.describe.", "discovery_search_truncated": "Discovery graph depth or duplicate query — narrow q, use discovery.describe on one canonical action id, or split into another execute.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Unknown or empty discovery params — use q= / query= / intent= for NL search; prefix= is aliased to domain= when it is a single token. Run discovery.describe on one canonical action id after a single discovery.search.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_project": "Bind context.project_id — workspace switcher or agents.work_next with project scope.", "no_match": "Broaden q or use discovery.list domain= — no_match is not a missing product", "node_scope_empty": "Bind context.project_id — workspace switcher or agents.work_next with project scope.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "semantic_contract_fingerprint_required": "Omit client semantic_contract blobs unless you implement the fingerprint contract — prefer options.goal_text on the batch or a plain discovery.search q= without semantic_contract.", "session_setup_required": "Run agentstack_session_setup — bind context.project_id before domain search", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix params against discovery.describe schema — discovery.search uses q= (natural language), not prefix= unless the tool schema documents prefix. Negative example: prefix=hosting.git → validation_error; use q=hosting git journal instead.", "work_next_hydrate_failed": "Work-graph hydrate failed during discovery — run agents.work_next with repair=true and detail=compact; narrow discovery.search q or retry without scope=node hydrate.", "work_next_next_action_present": "Packet has next_action — run agents.work_next / follow prefer_action before catalog search; WG-SLO-04 compliance. Audit batches: loop_mode=audit or allow_catalog_while_next_action."}, "when_blocked_locales": {"batch_semantic_anchor_conflict": {"en-US": "Per-step q/query conflicts with batch goal_text or semantic_contract — use one NL anchor per batch, split batches, or discovery.search without per-step query", "pt-BR": "q do passo conflita com anchor do batch — um anchor NL por batch ou separe execute.", "ru-RU": "q шага конфликтует с batch semantic anchor — один NL anchor на batch или разделите execute."}, "batch_semantic_goal_mismatch": {"en-US": "Step discovery.search q diverges from the batch goal — align q with options.goal_text, omit the goal, or run the search in its own execute. The server compares them whether or not semantic_strict is set.", "pt-BR": "q do passo diverge do anchor do batch com semantic_strict — alinhe q ao goal_text ou execute separado.", "ru-RU": "q шага расходится с batch anchor при semantic_strict — выровняйте q с goal_text или отдельный execute."}, "discovery_search_failed": {"en-US": "discovery.search failed after ranking — retry once with a narrower q; read discovery_stage_failed and X-Trace-Id in logs; do not parallel-spam discovery.search.", "pt-BR": "discovery.search falhou após ranking — estreite q, tente uma vez; veja discovery_stage_failed e X-Trace-Id; não dispare searches paralelos.", "ru-RU": "discovery.search упал после ранжирования — сузьте q, повторите один раз; смотрите discovery_stage_failed и X-Trace-Id; не спамьте параллельные search."}, "discovery_search_reentrant": {"en-US": "Nested discovery.search in one execute — at most one search per batch; reuse actions[] from the first result, then discovery.describe.", "pt-BR": "discovery.search aninhado no mesmo execute — no máximo um search; reuse actions[] e discovery.describe.", "ru-RU": "Вложенный discovery.search в одном execute — не более одного search; reuse actions[] и discovery.describe."}, "discovery_search_truncated": {"en-US": "Discovery graph depth or duplicate query — narrow q, use discovery.describe on one canonical action id, or split into another execute.", "pt-BR": "Profundidade discovery ou q duplicado — estreite q, discovery.describe em um action id.", "ru-RU": "Глубина discovery или дубликат q — сузьте q, discovery.describe на один action id."}, "invalid_cursor": {"en-US": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "pt-BR": "cursor — offset não negativo na lista filtrada; omita ou 0; não reuse após mudar q — discovery.list.", "ru-RU": "cursor — неотрицательное смещение в отфильтрованном списке; omit или 0; не reuse после смены q — discovery.list."}, "work_next_next_action_present": {"en-US": "Packet has next_action — run agents.work_next / follow prefer_action before catalog search; WG-SLO-04 compliance. Audit batches: loop_mode=audit or allow_catalog_while_next_action.", "pt-BR": "Pacote já tem next_action — rode agents.work_next / prefer_action antes do catálogo; WG-SLO-04. Audit: loop_mode=audit ou allow_catalog_while_next_action.", "ru-RU": "В пакете уже есть next_action — сначала agents.work_next / prefer_action, не catalog search; WG-SLO-04. Audit: loop_mode=audit или allow_catalog_while_next_action."}}, "when_not_to_use": "Do not call until context.project_id is bound. Do not call when agents.work_next packet.next_action is present — run that action first.", "when_to_use": "After VPS backend restart, first agents.work_next may fail while MCP tools import — wait ~15s and retry once (not a plan graph bug). Bound project: agents.work_next (recipe mcp_work_loop_v1) before ca", "write_mode": null}, {"action": "discovery.describe", "aliases": ["actions.describe", "actions.describe_action", "actions.get_schema", "actions.schema", "agents.describe", "agents.describe_action", "agents.get_schema", "discovery.action", "discovery.action_info", "discovery.action_schema", "discovery.describe_action", "discovery.get", "discovery.get_action", "discovery.get_tool", "meta.describe", "system.describe_tool"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.describe", "related_tools": ["discovery.describe_many", "discovery.list", "preflight.check", "discovery.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Describe", "when_blocked": {"action_not_found": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "action_required": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "auth_required": "Authenticate first: MCP OAuth Connect (PKCE), Device Code (/api/oauth2/device/authorize), MCP auth.login, or X-API-Key. oauth-token accepts authorization_code and refresh_token only. Then GET /mcp/prompts/get?name=agentstack_session_setup.", "batch_semantic_anchor_required": "Set options.execution_intent=direct for one read/CRUD, or options.goal / focus_node_id for multi-step batches — see MCP_CLIENT_MISUSE_PLAYBOOK.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "domain_required": "Pass domain= for discovery.domain (e.g. crm, storage, knowledge).", "hosted_app_required": "Mint hosted_app session cookie — not operator MCP Bearer on /s/{pid}/mcp.", "hosted_cookie_missing": "Visitor /s/{pid}/ uses hosted session cookie — not operator MCP Bearer. Use POST /api/hosted-apps/{pid}/session after page login.", "hosted_project_mismatch": "Align cookie project_id, X-Hosted-App-Path, and step params.project_id.", "hosted_step_project_id_invalid": "Step project_id must be an integer matching the storefront pid.", "hosted_step_project_id_required": "Each hosted batch step needs integer params.project_id (SDK mcpBatchStep).", "invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestration_step_violation": "Follow agents.work_next packet.next_action; do not nest off-spine mutations. Use agents.plan_reclaim_stale then work_next if leases expired.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "server_busy": "Event-loop lag — backoff and use discovery.summary instead of discovery.list full_catalog=true.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate first. GPT chat connector (chatgpt.com/connector/oauth), chat settings (chatgpt.com/backend-api/oauth/callback), and Apps plugin (platform.openai.com/apps-manage/oauth) finish when document GET oauth-authorize returns 302 to redirect_uri with code and state. IDE plugins: Device Code or Connect; programmatic: MCP auth.login or X-API-Key Bearer on POST /mcp. Dual headers: valid X-API-Key wins; placeholder ${…} in X-API-Key is skipped so OAuth Bearer applies. oauth-token is not for user password — use auth.login or Connect. Then GET /mcp/prompts/get?name=agentstack_session_setup (auth -> project -> context.project_id). MCP OAuth Connect often binds JWT project_id=1 — set context.project_id to your tenant (e.g. 1444) on every execute batch; use auth.get_profile session_ready before graph reads.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use "}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.describe", "related_tools": ["discovery.describe_many", "discovery.list", "preflight.check", "discovery.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Describe", "when_blocked": {"action_not_found": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "action_required": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "auth_required": "Authenticate first: MCP OAuth Connect (PKCE), Device Code (/api/oauth2/device/authorize), MCP auth.login, or X-API-Key. oauth-token accepts authorization_code and refresh_token only. Then GET /mcp/prompts/get?name=agentstack_session_setup.", "batch_semantic_anchor_required": "Set options.execution_intent=direct for one read/CRUD, or options.goal / focus_node_id for multi-step batches — see MCP_CLIENT_MISUSE_PLAYBOOK.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "domain_required": "Pass domain= for discovery.domain (e.g. crm, storage, knowledge).", "hosted_app_required": "Mint hosted_app session cookie — not operator MCP Bearer on /s/{pid}/mcp.", "hosted_cookie_missing": "Visitor /s/{pid}/ uses hosted session cookie — not operator MCP Bearer. Use POST /api/hosted-apps/{pid}/session after page login.", "hosted_project_mismatch": "Align cookie project_id, X-Hosted-App-Path, and step params.project_id.", "hosted_step_project_id_invalid": "Step project_id must be an integer matching the storefront pid.", "hosted_step_project_id_required": "Each hosted batch step needs integer params.project_id (SDK mcpBatchStep).", "invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestration_step_violation": "Follow agents.work_next packet.next_action; do not nest off-spine mutations. Use agents.plan_reclaim_stale then work_next if leases expired.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "server_busy": "Event-loop lag — backoff and use discovery.summary instead of discovery.list full_catalog=true.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate first. GPT chat connector (chatgpt.com/connector/oauth), chat settings (chatgpt.com/backend-api/oauth/callback), and Apps plugin (platform.openai.com/apps-manage/oauth) finish when document GET oauth-authorize returns 302 to redirect_uri with code and state. IDE plugins: Device Code or Connect; programmatic: MCP auth.login or X-API-Key Bearer on POST /mcp. Dual headers: valid X-API-Key wins; placeholder ${…} in X-API-Key is skipped so OAuth Bearer applies. oauth-token is not for user password — use auth.login or Connect. Then GET /mcp/prompts/get?name=agentstack_session_setup (auth -> project -> context.project_id). MCP OAuth Connect often binds JWT project_id=1 — set context.project_id to your tenant (e.g. 1444) on every execute batch; use auth.get_profile session_ready before graph reads.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use "}, "domain": "discovery", "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"action_not_found": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "action_required": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "auth_required": "Authenticate first: MCP OAuth Connect (PKCE), Device Code (/api/oauth2/device/authorize), MCP auth.login, or X-API-Key. oauth-token accepts authorization_code and refresh_token only. Then GET /mcp/prompts/get?name=agentstack_session_setup.", "invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "unauthorized": "Authenticate first. GPT chat connector (chatgpt.com/connector/oauth), chat settings (chatgpt.com/backend-api/oauth/callback), and Apps plugin (platform.openai.com/apps-manage/oauth) finish when document GET oauth-authorize returns 302 to redirect_uri with code and state. IDE plugins: Device Code or Connect; programmatic: MCP auth.login or X-API-Key Bearer on POST /mcp. Dual headers: valid X-API-Key wins; placeholder ${…} in X-API-Key is skipped so OAuth Bearer applies. oauth-token is not for user password — use auth.login or Connect. Then GET /mcp/prompts/get?name=agentstack_session_setup (auth -> project -> context.project_id). MCP OAuth Connect often binds JWT project_id=1 — set context.project_id to your tenant (e.g. 1444) on every execute batch; use auth.get_profile session_ready before graph reads."}, "examples": [{"name": "Slim schema lookup before execute", "request": {"params": {"action": "agents.plan_get", "descriptor": "slim", "expand": ["schema"]}, "tool": "discovery.describe"}, "response": {"data": {"action": "agents.plan_get", "capability_descriptor_slim": {"action": "agents.plan_get"}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discov…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"action": {"description": "string", "type": "string"}, "annotations": {"additionalProperties": true, "description": "object — MCP tools", "type": "object"}, "apply_compact": {"additionalProperties": true, "description": "object — optional when action=agents.plan_apply_proposal (slim|default); CAS apply", "type": "object"}, "capability_descriptor": {"additionalProperties": true, "description": "object — slim alias or full when descriptor=full", "type": "object"}, "capability_descriptor_slim": {"additionalProperties": true, "description": "object — slim CapabilityDescriptor when projected", "type": "object"}, "channel": {"description": "string — rest on REST-only rows", "type": "string"}, "claim_compact": {"additionalProperties": true, "description": "object — optional when action=agents.plan_claim (slim|default); CAS hot_loop", "type": "object"}, "descriptor_source": {"description": "string — when descriptor=full", "type": "string"}, "effect": {"additionalProperties": true, "description": "object — projected effect wire (discovery profile)", "type": "object"}, "errors": {"additionalProperties": true, "description": "object — described action errors map when present", "type": "object"}, "example_params": {"additionalProperties": true, "description": "object — hot-pilot sample params (schemas=hot parity)", "type": "object"}, "example_request": {"additionalProperties": true, "description": "object — {action, params} execute-shaped sample", "type": "object"}, "examples": {"description": "array — up to 3 from described action decorator", "items": {"type": "string"}, "type": "array"}, "execution_class": {"description": "string — read | mutate | heavy", "type": "string"}, "graph_file_compact": {"additionalProperties": true, "description": "object — optional when action=agents.graph_file_put|graph_file_get (slim|default); storage↔node ladder", "type": "object"}, "inputSchema": {"additionalProperties": true, "description": "object — MCP tools", "type": "object"}, "instruction_locale": {"description": "string — MCP tools", "type": "string"}, "instruction_slice": {"additionalProperties": true, "description": "object", "type": "object"}, "limits_compact": {"additionalProperties": true, "description": "object — optional when action=script.put (slim|default); compile/size limits", "type": "object"}, "loop_compact": {"additionalProperties": true, "description": "object — optional when action=agents.work_next (slim|default); recipe mcp_work_loop_v1", "type": "object"}, "mcp_executable": {"description": "bool — false on REST-only rows", "type": "boolean"}, "ops_compact": {"additionalProperties": true, "description": "object — optional when action=agents.plan_patch (slim|default); canonical ops + archive_ids_only", "type": "object"}, "outputSchema": {"additionalProperties": true, "description": "object — described action output_schema when present", "type": "object"}, "params_compact": {"description": "array — top param names/types for default/slim wire", "items": {"type": "string"}, "type": "array"}, "path": {"description": "string — REST route on REST-only rows", "type": "string"}, "propose_compact": {"additionalProperties": true, "description": "object — optional when action=agents.plan_propose (slim|default); modes hot_loop", "type": "object"}, "recovery_compact": {"additionalProperties": true, "description": "object — optional when action=agents.plan_recovery_scan (slim|default); scan hot_loop", "type": "object"}, "related_surfaces": {"description": "array — MCP tools", "items": {"type": "string"}, "type": "array"}, "requested": {"description": "string — client alias when != canonical action", "type": "string"}, "requires_preflight": {"description": "bool — true when preflight.check recommended", "type": "boolean"}, "semantic_input_mode": {"description": "string — structured | natural_language", "type": "string"}, "slice_compact": {"additionalProperties": true, "description": "object — optional when action=agents.plan_get (slim|default); hot_loop slice knobs", "type": "object"}, "summary": {"description": "string", "type": "string"}, "surface": {"description": "string — rest on REST-only rows", "type": "string"}, "when_to_use": {"description": "string — capability when_to_use (default wire)", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.describe_many", "discovery.list", "preflight.check", "discovery.search"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_describe", "semantic_input_mode": "inherit_workflow", "summary": "Schema and instruction_slice for one action, in the request locale. Default descriptor is slim. descriptor=full attaches the runtime CapabilityDescriptor (inputSchema/outputSchema only when expand inc", "title": "Discovery Describe", "when_blocked": {"action_not_found": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "action_required": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "auth_required": "Authenticate first: MCP OAuth Connect (PKCE), Device Code (/api/oauth2/device/authorize), MCP auth.login, or X-API-Key. oauth-token accepts authorization_code and refresh_token only. Then GET /mcp/prompts/get?name=agentstack_session_setup.", "batch_semantic_anchor_required": "Set options.execution_intent=direct for one read/CRUD, or options.goal / focus_node_id for multi-step batches — see MCP_CLIENT_MISUSE_PLAYBOOK.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "domain_required": "Pass domain= for discovery.domain (e.g. crm, storage, knowledge).", "hosted_app_required": "Mint hosted_app session cookie — not operator MCP Bearer on /s/{pid}/mcp.", "hosted_cookie_missing": "Visitor /s/{pid}/ uses hosted session cookie — not operator MCP Bearer. Use POST /api/hosted-apps/{pid}/session after page login.", "hosted_project_mismatch": "Align cookie project_id, X-Hosted-App-Path, and step params.project_id.", "hosted_step_project_id_invalid": "Step project_id must be an integer matching the storefront pid.", "hosted_step_project_id_required": "Each hosted batch step needs integer params.project_id (SDK mcpBatchStep).", "invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestration_step_violation": "Follow agents.work_next packet.next_action; do not nest off-spine mutations. Use agents.plan_reclaim_stale then work_next if leases expired.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "server_busy": "Event-loop lag — backoff and use discovery.summary instead of discovery.list full_catalog=true.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate first. GPT chat connector (chatgpt.com/connector/oauth), chat settings (chatgpt.com/backend-api/oauth/callback), and Apps plugin (platform.openai.com/apps-manage/oauth) finish when document GET oauth-authorize returns 302 to redirect_uri with code and state. IDE plugins: Device Code or Connect; programmatic: MCP auth.login or X-API-Key Bearer on POST /mcp. Dual headers: valid X-API-Key wins; placeholder ${…} in X-API-Key is skipped so OAuth Bearer applies. oauth-token is not for user password — use auth.login or Connect. Then GET /mcp/prompts/get?name=agentstack_session_setup (auth -> project -> context.project_id). MCP OAuth Connect often binds JWT project_id=1 — set context.project_id to your tenant (e.g. 1444) on every execute batch; use auth.get_profile session_ready before graph reads.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use", "write_mode": null}, {"action": "discovery.describe_many", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1", "core.mcp.self_description.gen1"], "id": "discovery.describe_many", "related_tools": ["discovery.describe", "discovery.list", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Describe Many", "when_blocked": {"action_not_found": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "action_required": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "actions_required": "discovery.describe_many requires actions=[...] with 1–6 canonical MCP ids (deduped in order). Default descriptor=slim — same wire as discovery.describe per row.", "auth_required": "Authenticate first: MCP OAuth Connect (PKCE), Device Code (/api/oauth2/device/authorize), MCP auth.login, or X-API-Key. oauth-token accepts authorization_code and refresh_token only. Then GET /mcp/prompts/get?name=agentstack_session_setup.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate first. GPT chat connector (chatgpt.com/connector/oauth), chat settings (chatgpt.com/backend-api/oauth/callback), and Apps plugin (platform.openai.com/apps-manage/oauth) finish when document GET oauth-authorize returns 302 to redirect_uri with code and state. IDE plugins: Device Code or Connect; programmatic: MCP auth.login or X-API-Key Bearer on POST /mcp. Dual headers: valid X-API-Key wins; placeholder ${…} in X-API-Key is skipped so OAuth Bearer applies. oauth-token is not for user password — use auth.login or Connect. Then GET /mcp/prompts/get?name=agentstack_session_setup (auth -> project -> context.project_id). MCP OAuth Connect often binds JWT project_id=1 — set context.project_id to your tenant (e.g. 1444) on every execute batch; use auth.get_profile session_ready before graph reads.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Batch slim describe for Copilot / UI: pass actions=[...] (≤6 ids) once instead of parallel discovery.describe. Same descriptor= and expand= apply to every row."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1", "core.mcp.self_description.gen1"], "id": "discovery.describe_many", "related_tools": ["discovery.describe", "discovery.list", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Describe Many", "when_blocked": {"action_not_found": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "action_required": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "actions_required": "discovery.describe_many requires actions=[...] with 1–6 canonical MCP ids (deduped in order). Default descriptor=slim — same wire as discovery.describe per row.", "auth_required": "Authenticate first: MCP OAuth Connect (PKCE), Device Code (/api/oauth2/device/authorize), MCP auth.login, or X-API-Key. oauth-token accepts authorization_code and refresh_token only. Then GET /mcp/prompts/get?name=agentstack_session_setup.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate first. GPT chat connector (chatgpt.com/connector/oauth), chat settings (chatgpt.com/backend-api/oauth/callback), and Apps plugin (platform.openai.com/apps-manage/oauth) finish when document GET oauth-authorize returns 302 to redirect_uri with code and state. IDE plugins: Device Code or Connect; programmatic: MCP auth.login or X-API-Key Bearer on POST /mcp. Dual headers: valid X-API-Key wins; placeholder ${…} in X-API-Key is skipped so OAuth Bearer applies. oauth-token is not for user password — use auth.login or Connect. Then GET /mcp/prompts/get?name=agentstack_session_setup (auth -> project -> context.project_id). MCP OAuth Connect often binds JWT project_id=1 — set context.project_id to your tenant (e.g. 1444) on every execute batch; use auth.get_profile session_ready before graph reads.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Batch slim describe for Copilot / UI: pass actions=[...] (≤6 ids) once instead of parallel discovery.describe. Same descriptor= and expand= apply to every row."}, "domain": "discovery", "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"action_not_found": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "action_required": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "actions_required": "discovery.describe_many requires actions=[...] with 1–6 canonical MCP ids (deduped in order). Default descriptor=slim — same wire as discovery.describe per row.", "auth_required": "Authenticate first: MCP OAuth Connect (PKCE), Device Code (/api/oauth2/device/authorize), MCP auth.login, or X-API-Key. oauth-token accepts authorization_code and refresh_token only. Then GET /mcp/prompts/get?name=agentstack_session_setup.", "invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "unauthorized": "Authenticate first. GPT chat connector (chatgpt.com/connector/oauth), chat settings (chatgpt.com/backend-api/oauth/callback), and Apps plugin (platform.openai.com/apps-manage/oauth) finish when document GET oauth-authorize returns 302 to redirect_uri with code and state. IDE plugins: Device Code or Connect; programmatic: MCP auth.login or X-API-Key Bearer on POST /mcp. Dual headers: valid X-API-Key wins; placeholder ${…} in X-API-Key is skipped so OAuth Bearer applies. oauth-token is not for user password — use auth.login or Connect. Then GET /mcp/prompts/get?name=agentstack_session_setup (auth -> project -> context.project_id). MCP OAuth Connect often binds JWT project_id=1 — set context.project_id to your tenant (e.g. 1444) on every execute batch; use auth.get_profile session_ready before graph reads."}, "examples": [{"name": "Copilot allowed-action effect batch", "request": {"params": {"actions": ["agents.plan_get", "agents.work_next"], "descriptor": "slim"}, "tool": "discovery.describe_many"}, "response": {"data": {"count": 2, "descriptor": "slim", "rows": []}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Batch slim describe for Copilot / UI: pass actions=[...] (≤6 ids) once instead of parallel discover…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.describe", "discovery.list", "preflight.check"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_describe_many", "semantic_input_mode": "inherit_workflow", "summary": "Slim discovery.describe for up to six canonical action ids in one read. Default descriptor=slim — same projection as discovery.describe per row.", "title": "Discovery Describe Many", "when_blocked": {"action_not_found": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "action_required": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "actions_required": "discovery.describe_many requires actions=[...] with 1–6 canonical MCP ids (deduped in order). Default descriptor=slim — same wire as discovery.describe per row.", "auth_required": "Authenticate first: MCP OAuth Connect (PKCE), Device Code (/api/oauth2/device/authorize), MCP auth.login, or X-API-Key. oauth-token accepts authorization_code and refresh_token only. Then GET /mcp/prompts/get?name=agentstack_session_setup.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate first. GPT chat connector (chatgpt.com/connector/oauth), chat settings (chatgpt.com/backend-api/oauth/callback), and Apps plugin (platform.openai.com/apps-manage/oauth) finish when document GET oauth-authorize returns 302 to redirect_uri with code and state. IDE plugins: Device Code or Connect; programmatic: MCP auth.login or X-API-Key Bearer on POST /mcp. Dual headers: valid X-API-Key wins; placeholder ${…} in X-API-Key is skipped so OAuth Bearer applies. oauth-token is not for user password — use auth.login or Connect. Then GET /mcp/prompts/get?name=agentstack_session_setup (auth -> project -> context.project_id). MCP OAuth Connect often binds JWT project_id=1 — set context.project_id to your tenant (e.g. 1444) on every execute batch; use auth.get_profile session_ready before graph reads.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Batch slim describe for Copilot / UI: pass actions=[...] (≤6 ids) once instead of parallel discovery.describe. Same descriptor= and expand= apply to every row.", "write_mode": null}, {"action": "discovery.instruction_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.instruction_get", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Discovery Instruction Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "When agentstack://instructions/* or /mcp/prompts/get URLs must be resolved via execute."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.instruction_get", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Discovery Instruction Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "When agentstack://instructions/* or /mcp/prompts/get URLs must be resolved via execute."}, "domain": "discovery", "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "unauthorized": "Authenticate (Bearer or API key) before catalog list"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "When agentstack://instructions/* or /mcp/prompts/get URLs must be resolved via execute.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_surfaces": [], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_instruction_get", "semantic_input_mode": "inherit_workflow", "summary": "Fetch MCP instruction/playbook text by id (read-only).", "title": "Discovery Instruction Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "When agentstack://instructions/* or /mcp/prompts/get URLs must be resolved via execute.", "write_mode": null}, {"action": "discovery.job_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not poll agents.run / run_uuid here — use agents.run_get with run_id from agents.run.", "anti_patterns": ["Do not poll agents.run / run_uuid here — use agents.run_get with run_id from agents.run.", "job_id is only from agentstack.execute with options.async=true."], "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.job_status", "related_tools": ["discovery.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Job Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Job scoped to enqueue owner only", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown job_id — re-check async handoff job_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After options.async execute returns job_id; poll until status is completed or failed."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.job_status", "related_tools": ["discovery.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Job Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Job scoped to enqueue owner only", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown job_id — re-check async handoff job_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After options.async execute returns job_id; poll until status is completed or failed."}, "domain": "discovery", "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "Job scoped to enqueue owner only", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "not_found": "Unknown job_id — re-check async handoff job_id", "unauthorized": "Authenticate (Bearer or API key) before catalog list"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "After options.async execute returns job_id; poll until status is completed or failed.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.search"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_job_status", "semantic_input_mode": "inherit_workflow", "summary": "Poll an async agentstack.execute job (options.async=true). Cheap. Use after a multi-step heavy batch; do not re-run bots.simulate to check status.", "title": "Discovery Job Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Job scoped to enqueue owner only", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown job_id — re-check async handoff job_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After options.async execute returns job_id; poll until status is completed or failed.", "write_mode": null}, {"action": "channels.list_identities", "aliases": ["channel.list_identities"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.list_identities", "related_tools": ["notifications.deliver", "bots.list", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels List Identities", "when_blocked": {"unauthorized": "auth.get_profile — linked bot identities are per signed-in user"}, "when_to_use": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.list_identities", "related_tools": ["notifications.deliver", "bots.list", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels List Identities", "when_blocked": {"unauthorized": "auth.get_profile — linked bot identities are per signed-in user"}, "when_to_use": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first."}, "domain": "channels", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.deliver", "bots.list", "notifications.list_prefs"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "channels_list_identities", "semantic_input_mode": "inherit_workflow", "summary": "List linked bot channel identities for the signed-in user.", "title": "Channels List Identities", "when_blocked": {"unauthorized": "auth.get_profile — linked bot identities are per signed-in user"}, "when_to_use": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first.", "write_mode": null}, {"action": "channels.enroll_source", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.channel_plane.gen1"], "id": "channels.enroll_source", "related_tools": ["channels.delete_source", "channels.list_identities", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Enroll Source", "when_blocked": {"bot_channel_mismatch": "bots.list — source bot_id must match linked channel identity", "bot_not_accessible": "bots.list — bot missing, not live, or actor lacks project access", "channel_not_linked": "channels.list_identities — user must /login in the bot or complete OAuth link first", "forbidden": "auth.get_profile — enroll only for self unless admin", "invalid_parameters": "NotificationSource schema invalid — kind, bot_id, channel required where applicable", "validation_error": "Fix NotificationSource JSON — compare notifications.list_prefs sources shape"}, "when_to_use": "ReachabilityHub enroll or bot /notify_on parity. User must /login in bot first."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.channel_plane.gen1"], "id": "channels.enroll_source", "related_tools": ["channels.delete_source", "channels.list_identities", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Enroll Source", "when_blocked": {"bot_channel_mismatch": "bots.list — source bot_id must match linked channel identity", "bot_not_accessible": "bots.list — bot missing, not live, or actor lacks project access", "channel_not_linked": "channels.list_identities — user must /login in the bot or complete OAuth link first", "forbidden": "auth.get_profile — enroll only for self unless admin", "invalid_parameters": "NotificationSource schema invalid — kind, bot_id, channel required where applicable", "validation_error": "Fix NotificationSource JSON — compare notifications.list_prefs sources shape"}, "when_to_use": "ReachabilityHub enroll or bot /notify_on parity. User must /login in bot first."}, "domain": "channels", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "ReachabilityHub enroll or bot /notify_on parity. User must /login in bot first.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.delete_source", "channels.list_identities", "notifications.list_prefs"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "channels_enroll_source", "semantic_input_mode": "inherit_workflow", "summary": "Upsert a notification source (bot channel, web_push, email enrollment).", "title": "Channels Enroll Source", "when_blocked": {"bot_channel_mismatch": "bots.list — source bot_id must match linked channel identity", "bot_not_accessible": "bots.list — bot missing, not live, or actor lacks project access", "channel_not_linked": "channels.list_identities — user must /login in the bot or complete OAuth link first", "forbidden": "auth.get_profile — enroll only for self unless admin", "invalid_parameters": "NotificationSource schema invalid — kind, bot_id, channel required where applicable", "validation_error": "Fix NotificationSource JSON — compare notifications.list_prefs sources shape"}, "when_to_use": "ReachabilityHub enroll or bot /notify_on parity. User must /login in bot first.", "write_mode": null}, {"action": "channels.delete_source", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.channel_plane.gen1"], "id": "channels.delete_source", "related_tools": ["channels.enroll_source", "notifications.delete_source"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Delete Source", "when_blocked": {"invalid_parameters": "source_id required — notifications.list_prefs → prefs.delivery.sources", "unauthorized": "auth.get_profile — source delete is user-scoped"}, "when_to_use": "Profile unenroll / revoke bot notify source."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.channel_plane.gen1"], "id": "channels.delete_source", "related_tools": ["channels.enroll_source", "notifications.delete_source"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Delete Source", "when_blocked": {"invalid_parameters": "source_id required — notifications.list_prefs → prefs.delivery.sources", "unauthorized": "auth.get_profile — source delete is user-scoped"}, "when_to_use": "Profile unenroll / revoke bot notify source."}, "domain": "channels", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Profile unenroll / revoke bot notify source.", "mutation_kind": "entity", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.enroll_source", "notifications.delete_source"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "channels_delete_source", "semantic_input_mode": "inherit_workflow", "summary": "Remove a notification source by id.", "title": "Channels Delete Source", "when_blocked": {"invalid_parameters": "source_id required — notifications.list_prefs → prefs.delivery.sources", "unauthorized": "auth.get_profile — source delete is user-scoped"}, "when_to_use": "Profile unenroll / revoke bot notify source.", "write_mode": null}, {"action": "channels.deliver", "aliases": ["channel.deliver", "channels.notify", "channels.send"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Not a reply on the user's @agentstack.tech thread — messaging.inbox.reply.", "anti_patterns": ["Not a reply on the user's @agentstack.tech thread — messaging.inbox.reply.", "Not outbound personal mail from the claimed address — messaging.mail.send.", "Not claiming an address — messaging.mailbox.claim."], "capability_descriptor": {"complexity": "intermediate", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.deliver", "related_tools": ["channels.resolve_routing", "notifications.list_prefs", "bots.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Deliver", "when_blocked": {"channel_disabled": "notifications.list_prefs — user turned channel off or Mail Hub email is disabled", "channel_not_linked": "channels.create_bind_link — user must complete Telegram bind or /login in bot; not a batch DAG dependency_error", "dependency_error": "Batch DAG: fix the first failed step_id or poll verification_action — not a Telegram binding bug. Standalone deliver: channels.list_identities + user /login in bot for external_user_id", "digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — deliver to another user_id only as project admin", "handle_required": "This key owns several handles. Pass source_agent_id or start the text with @handle.", "invalid_parameters": "title or message required; channels[] via normalize_deliver_channels — discovery.describe. handle_required when this key owns several handles and neither source_agent_id nor @handle is set. Quote-reply on the sent turn routes to the stamped mailbox. Leading @handle on text stamps author only; @OtherHandle in the body wakes that mailbox webhook. Cross-agent mailbox writes use bots.bus.deliver to_handle.", "no_channel_target": "bots.list + user /login in the bot — deliver skips channels without external_user_id", "no_eligible_channels": "notifications.list_prefs + notifications.update_prefs — transport/prefs intersection empty; dry_run:true to preview skip_reasons before send", "operation_failed": "channels.delivery_status with correlation_key — provider rejected; check bot token and channel id", "orchestration_step_violation": "preflight.check then notifications.deliver — or follow packet.next_action / inverse_resume; do not call deliver outside the current workflow step allow-list", "prefs_filter_failed": "notifications.list_prefs — corrupt prefs leaf; list_prefs re-seeds plane or fix JSON via update_prefs", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "quota": "buffs.get_effective_limits — project notice caps before retry; not rag_embed_quota or storage_quota", "source_agent_forbidden": "source_agent_id or @handle must be a mailbox bound to this API key", "source_not_enrolled": "channels.enroll_source after channels.list_identities — source not enrolled for user", "template_missing": "projects.config.notifications.templates — pass title/message or notifications.register_category with a matching template name", "unauthorized": "auth.get_profile — signed-in user or service key with notify caps"}, "when_to_use": "One call, explicit channels. OS-only push remains notifications.send_push."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.deliver", "related_tools": ["channels.resolve_routing", "notifications.list_prefs", "bots.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Deliver", "when_blocked": {"channel_disabled": "notifications.list_prefs — user turned channel off or Mail Hub email is disabled", "channel_not_linked": "channels.create_bind_link — user must complete Telegram bind or /login in bot; not a batch DAG dependency_error", "dependency_error": "Batch DAG: fix the first failed step_id or poll verification_action — not a Telegram binding bug. Standalone deliver: channels.list_identities + user /login in bot for external_user_id", "digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — deliver to another user_id only as project admin", "handle_required": "This key owns several handles. Pass source_agent_id or start the text with @handle.", "invalid_parameters": "title or message required; channels[] via normalize_deliver_channels — discovery.describe. handle_required when this key owns several handles and neither source_agent_id nor @handle is set. Quote-reply on the sent turn routes to the stamped mailbox. Leading @handle on text stamps author only; @OtherHandle in the body wakes that mailbox webhook. Cross-agent mailbox writes use bots.bus.deliver to_handle.", "no_channel_target": "bots.list + user /login in the bot — deliver skips channels without external_user_id", "no_eligible_channels": "notifications.list_prefs + notifications.update_prefs — transport/prefs intersection empty; dry_run:true to preview skip_reasons before send", "operation_failed": "channels.delivery_status with correlation_key — provider rejected; check bot token and channel id", "orchestration_step_violation": "preflight.check then notifications.deliver — or follow packet.next_action / inverse_resume; do not call deliver outside the current workflow step allow-list", "prefs_filter_failed": "notifications.list_prefs — corrupt prefs leaf; list_prefs re-seeds plane or fix JSON via update_prefs", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "quota": "buffs.get_effective_limits — project notice caps before retry; not rag_embed_quota or storage_quota", "source_agent_forbidden": "source_agent_id or @handle must be a mailbox bound to this API key", "source_not_enrolled": "channels.enroll_source after channels.list_identities — source not enrolled for user", "template_missing": "projects.config.notifications.templates — pass title/message or notifications.register_category with a matching template name", "unauthorized": "auth.get_profile — signed-in user or service key with notify caps"}, "when_to_use": "One call, explicit channels. OS-only push remains notifications.send_push."}, "domain": "channels", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Eligibility dry_run with fallback_chain", "request": {"category": "security", "channels": ["telegram"], "dry_run": true, "fallback_chain": ["email", "in_app"], "message": "No send — dry_run only.", "title": "Channel plane check"}}], "execution_class": "cheap", "instruction_hint": "One call, explicit channels. OS-only push remains notifications.send_push.", "mutation_kind": "entity", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.resolve_routing", "notifications.list_prefs", "bots.list"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "channels_deliver", "semantic_input_mode": "inherit_workflow", "summary": "Send via unified channel plane (same bus as notifications.deliver).", "title": "Channels Deliver", "when_blocked": {"channel_disabled": "notifications.list_prefs — user turned channel off or Mail Hub email is disabled", "channel_not_linked": "channels.create_bind_link — user must complete Telegram bind or /login in bot; not a batch DAG dependency_error", "dependency_error": "Batch DAG: fix the first failed step_id or poll verification_action — not a Telegram binding bug. Standalone deliver: channels.list_identities + user /login in bot for external_user_id", "digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — deliver to another user_id only as project admin", "handle_required": "This key owns several handles. Pass source_agent_id or start the text with @handle.", "invalid_parameters": "title or message required; channels[] via normalize_deliver_channels — discovery.describe. handle_required when this key owns several handles and neither source_agent_id nor @handle is set. Quote-reply on the sent turn routes to the stamped mailbox. Leading @handle on text stamps author only; @OtherHandle in the body wakes that mailbox webhook. Cross-agent mailbox writes use bots.bus.deliver to_handle.", "no_channel_target": "bots.list + user /login in the bot — deliver skips channels without external_user_id", "no_eligible_channels": "notifications.list_prefs + notifications.update_prefs — transport/prefs intersection empty; dry_run:true to preview skip_reasons before send", "operation_failed": "channels.delivery_status with correlation_key — provider rejected; check bot token and channel id", "orchestration_step_violation": "preflight.check then notifications.deliver — or follow packet.next_action / inverse_resume; do not call deliver outside the current workflow step allow-list", "prefs_filter_failed": "notifications.list_prefs — corrupt prefs leaf; list_prefs re-seeds plane or fix JSON via update_prefs", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "quota": "buffs.get_effective_limits — project notice caps before retry; not rag_embed_quota or storage_quota", "source_agent_forbidden": "source_agent_id or @handle must be a mailbox bound to this API key", "source_not_enrolled": "channels.enroll_source after channels.list_identities — source not enrolled for user", "template_missing": "projects.config.notifications.templates — pass title/message or notifications.register_category with a matching template name", "unauthorized": "auth.get_profile — signed-in user or service key with notify caps"}, "when_to_use": "One call, explicit channels. OS-only push remains notifications.send_push.", "write_mode": null}, {"action": "channels.delivery_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": true, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.delivery_status", "related_tools": ["channels.test_delivery", "channels.list_failed_deliveries", "notifications.delivery_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Delivery Status", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "invalid_parameters": "correlation_key required — pass key from channels.deliver result", "not_found": "No receipts yet — deliver first or channels.delivery_snapshot for recent rows"}, "when_to_use": "Track OTP / alert / test ping outcome after channels.test_delivery."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": true, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.delivery_status", "related_tools": ["channels.test_delivery", "channels.list_failed_deliveries", "notifications.delivery_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Delivery Status", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "invalid_parameters": "correlation_key required — pass key from channels.deliver result", "not_found": "No receipts yet — deliver first or channels.delivery_snapshot for recent rows"}, "when_to_use": "Track OTP / alert / test ping outcome after channels.test_delivery."}, "domain": "channels", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Track OTP / alert / test ping outcome after channels.test_delivery.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.test_delivery", "channels.list_failed_deliveries", "notifications.delivery_status"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "channels_delivery_status", "semantic_input_mode": "inherit_workflow", "summary": "Read delivery receipts for a correlation_key from user DNA.", "title": "Channels Delivery Status", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "invalid_parameters": "correlation_key required — pass key from channels.deliver result", "not_found": "No receipts yet — deliver first or channels.delivery_snapshot for recent rows"}, "when_to_use": "Track OTP / alert / test ping outcome after channels.test_delivery.", "write_mode": null}, {"action": "channels.delivery_snapshot", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.channel_plane.gen1", "core.messaging.delivery.gen1"], "id": "channels.delivery_snapshot", "related_tools": ["channels.delivery_status", "channels.digest_depth", "notifications.list_prefs", "channels.list_failed_deliveries"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Delivery Snapshot", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "unauthorized": "auth.get_profile — reachability snapshot requires signed-in user"}, "when_to_use": "Profile reachability / matrix — same as GET /users/me/notification-delivery-status."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.channel_plane.gen1", "core.messaging.delivery.gen1"], "id": "channels.delivery_snapshot", "related_tools": ["channels.delivery_status", "channels.digest_depth", "notifications.list_prefs", "channels.list_failed_deliveries"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Delivery Snapshot", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "unauthorized": "auth.get_profile — reachability snapshot requires signed-in user"}, "when_to_use": "Profile reachability / matrix — same as GET /users/me/notification-delivery-status."}, "domain": "channels", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Profile reachability / matrix — same as GET /users/me/notification-delivery-status.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.delivery_status", "channels.digest_depth", "notifications.list_prefs", "channels.list_failed_deliveries"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "channels_delivery_snapshot", "semantic_input_mode": "inherit_workflow", "summary": "Reachability snapshot: recent receipts, failed subset, and can_deliver flags (same as GET /users/me/notification-delivery-status).", "title": "Channels Delivery Snapshot", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "unauthorized": "auth.get_profile — reachability snapshot requires signed-in user"}, "when_to_use": "Profile reachability / matrix — same as GET /users/me/notification-delivery-status.", "write_mode": null}, {"action": "channels.sources_health", "aliases": ["channel.sources_health", "channels.list_sources_health"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.channel_plane.gen1", "core.messaging.delivery.gen1"], "id": "channels.sources_health", "related_tools": ["notifications.list_prefs", "channels.delivery_snapshot", "channels.enroll_source"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Sources Health", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "unauthorized": "auth.get_profile — sources health is user-scoped"}, "when_to_use": "SourcesList health dots — prefer one call over per-source GET."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.channel_plane.gen1", "core.messaging.delivery.gen1"], "id": "channels.sources_health", "related_tools": ["notifications.list_prefs", "channels.delivery_snapshot", "channels.enroll_source"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Sources Health", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "unauthorized": "auth.get_profile — sources health is user-scoped"}, "when_to_use": "SourcesList health dots — prefer one call over per-source GET."}, "domain": "channels", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "SourcesList health dots — prefer one call over per-source GET.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.list_prefs", "channels.delivery_snapshot", "channels.enroll_source"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "channels_sources_health", "semantic_input_mode": "inherit_workflow", "summary": "Batch health for all enrolled notification sources (same as GET /users/me/notification-sources/health).", "title": "Channels Sources Health", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "unauthorized": "auth.get_profile — sources health is user-scoped"}, "when_to_use": "SourcesList health dots — prefer one call over per-source GET.", "write_mode": null}, {"action": "channels.source_health", "aliases": ["channel.source_health", "channels.get_source_health"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.channel_plane.gen1", "core.messaging.delivery.gen1"], "id": "channels.source_health", "related_tools": ["channels.sources_health", "channels.enroll_source", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Source Health", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "invalid_parameters": "source_id required", "unauthorized": "auth.get_profile — per-source health is user-scoped"}, "when_to_use": "Diagnose one SourcesList dot — REST GET …/notification-sources/{source_id}/health."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.channel_plane.gen1", "core.messaging.delivery.gen1"], "id": "channels.source_health", "related_tools": ["channels.sources_health", "channels.enroll_source", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Source Health", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "invalid_parameters": "source_id required", "unauthorized": "auth.get_profile — per-source health is user-scoped"}, "when_to_use": "Diagnose one SourcesList dot — REST GET …/notification-sources/{source_id}/health."}, "domain": "channels", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Diagnose one SourcesList dot — REST GET …/notification-sources/{source_id}/health.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.sources_health", "channels.enroll_source", "notifications.list_prefs"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "channels_source_health", "semantic_input_mode": "inherit_workflow", "summary": "Health for one enrolled notification source (REST GET /users/me/notification-sources/{source_id}/health).", "title": "Channels Source Health", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "invalid_parameters": "source_id required", "unauthorized": "auth.get_profile — per-source health is user-scoped"}, "when_to_use": "Diagnose one SourcesList dot — REST GET …/notification-sources/{source_id}/health.", "write_mode": null}, {"action": "channels.test_delivery", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Not a reply on the user's corporate mail thread — messaging.inbox.reply.", "anti_patterns": ["Not a reply on the user's corporate mail thread — messaging.inbox.reply.", "Not ecosystem admin SMTP — messaging.send_email."], "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.test_delivery", "related_tools": ["channels.delivery_status", "channels.deliver", "channels.resolve_routing"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Test Delivery", "when_blocked": {"channel_disabled": "notifications.list_prefs — user turned channel off or Mail Hub email is disabled", "channel_not_linked": "channels.create_bind_link — user must complete Telegram bind or /login in bot; not a batch DAG dependency_error", "dependency_error": "Batch DAG: fix the first failed step_id or poll verification_action — not a Telegram binding bug. Standalone deliver: channels.list_identities + user /login in bot for external_user_id", "digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — deliver to another user_id only as project admin", "handle_required": "This key owns several handles. Pass source_agent_id or start the text with @handle.", "invalid_parameters": "title or message required; channels[] via normalize_deliver_channels — discovery.describe. handle_required when this key owns several handles and neither source_agent_id nor @handle is set. Quote-reply on the sent turn routes to the stamped mailbox. Leading @handle on text stamps author only; @OtherHandle in the body wakes that mailbox webhook. Cross-agent mailbox writes use bots.bus.deliver to_handle.", "no_channel_target": "bots.list + user /login in the bot — deliver skips channels without external_user_id", "no_eligible_channels": "notifications.list_prefs + notifications.update_prefs — transport/prefs intersection empty; dry_run:true to preview skip_reasons before send", "operation_failed": "channels.delivery_status with correlation_key — provider rejected; check bot token and channel id", "orchestration_step_violation": "preflight.check then notifications.deliver — or follow packet.next_action / inverse_resume; do not call deliver outside the current workflow step allow-list", "prefs_filter_failed": "notifications.list_prefs — corrupt prefs leaf; list_prefs re-seeds plane or fix JSON via update_prefs", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "quota": "buffs.get_effective_limits — project notice caps before retry; not rag_embed_quota or storage_quota", "source_agent_forbidden": "source_agent_id or @handle must be a mailbox bound to this API key", "source_not_enrolled": "channels.enroll_source after channels.list_identities — source not enrolled for user", "template_missing": "projects.config.notifications.templates — pass title/message or notifications.register_category with a matching template name", "unauthorized": "auth.get_profile — signed-in user or service key with notify caps"}, "when_to_use": "Profile Reachability test ping; defaults correlation channel:test:{user_id}."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.test_delivery", "related_tools": ["channels.delivery_status", "channels.deliver", "channels.resolve_routing"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Test Delivery", "when_blocked": {"channel_disabled": "notifications.list_prefs — user turned channel off or Mail Hub email is disabled", "channel_not_linked": "channels.create_bind_link — user must complete Telegram bind or /login in bot; not a batch DAG dependency_error", "dependency_error": "Batch DAG: fix the first failed step_id or poll verification_action — not a Telegram binding bug. Standalone deliver: channels.list_identities + user /login in bot for external_user_id", "digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — deliver to another user_id only as project admin", "handle_required": "This key owns several handles. Pass source_agent_id or start the text with @handle.", "invalid_parameters": "title or message required; channels[] via normalize_deliver_channels — discovery.describe. handle_required when this key owns several handles and neither source_agent_id nor @handle is set. Quote-reply on the sent turn routes to the stamped mailbox. Leading @handle on text stamps author only; @OtherHandle in the body wakes that mailbox webhook. Cross-agent mailbox writes use bots.bus.deliver to_handle.", "no_channel_target": "bots.list + user /login in the bot — deliver skips channels without external_user_id", "no_eligible_channels": "notifications.list_prefs + notifications.update_prefs — transport/prefs intersection empty; dry_run:true to preview skip_reasons before send", "operation_failed": "channels.delivery_status with correlation_key — provider rejected; check bot token and channel id", "orchestration_step_violation": "preflight.check then notifications.deliver — or follow packet.next_action / inverse_resume; do not call deliver outside the current workflow step allow-list", "prefs_filter_failed": "notifications.list_prefs — corrupt prefs leaf; list_prefs re-seeds plane or fix JSON via update_prefs", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "quota": "buffs.get_effective_limits — project notice caps before retry; not rag_embed_quota or storage_quota", "source_agent_forbidden": "source_agent_id or @handle must be a mailbox bound to this API key", "source_not_enrolled": "channels.enroll_source after channels.list_identities — source not enrolled for user", "template_missing": "projects.config.notifications.templates — pass title/message or notifications.register_category with a matching template name", "unauthorized": "auth.get_profile — signed-in user or service key with notify caps"}, "when_to_use": "Profile Reachability test ping; defaults correlation channel:test:{user_id}."}, "domain": "channels", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Profile Reachability test ping; defaults correlation channel:test:{user_id}.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.delivery_status", "channels.deliver", "channels.resolve_routing"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "channels_test_delivery", "semantic_input_mode": "inherit_workflow", "summary": "Enqueue a short test message on one channel (self or admin).", "title": "Channels Test Delivery", "when_blocked": {"channel_disabled": "notifications.list_prefs — user turned channel off or Mail Hub email is disabled", "channel_not_linked": "channels.create_bind_link — user must complete Telegram bind or /login in bot; not a batch DAG dependency_error", "dependency_error": "Batch DAG: fix the first failed step_id or poll verification_action — not a Telegram binding bug. Standalone deliver: channels.list_identities + user /login in bot for external_user_id", "digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — deliver to another user_id only as project admin", "handle_required": "This key owns several handles. Pass source_agent_id or start the text with @handle.", "invalid_parameters": "title or message required; channels[] via normalize_deliver_channels — discovery.describe. handle_required when this key owns several handles and neither source_agent_id nor @handle is set. Quote-reply on the sent turn routes to the stamped mailbox. Leading @handle on text stamps author only; @OtherHandle in the body wakes that mailbox webhook. Cross-agent mailbox writes use bots.bus.deliver to_handle.", "no_channel_target": "bots.list + user /login in the bot — deliver skips channels without external_user_id", "no_eligible_channels": "notifications.list_prefs + notifications.update_prefs — transport/prefs intersection empty; dry_run:true to preview skip_reasons before send", "operation_failed": "channels.delivery_status with correlation_key — provider rejected; check bot token and channel id", "orchestration_step_violation": "preflight.check then notifications.deliver — or follow packet.next_action / inverse_resume; do not call deliver outside the current workflow step allow-list", "prefs_filter_failed": "notifications.list_prefs — corrupt prefs leaf; list_prefs re-seeds plane or fix JSON via update_prefs", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "quota": "buffs.get_effective_limits — project notice caps before retry; not rag_embed_quota or storage_quota", "source_agent_forbidden": "source_agent_id or @handle must be a mailbox bound to this API key", "source_not_enrolled": "channels.enroll_source after channels.list_identities — source not enrolled for user", "template_missing": "projects.config.notifications.templates — pass title/message or notifications.register_category with a matching template name", "unauthorized": "auth.get_profile — signed-in user or service key with notify caps"}, "when_to_use": "Profile Reachability test ping; defaults correlation channel:test:{user_id}.", "write_mode": null}, {"action": "channels.resolve_routing", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.resolve_routing", "related_tools": ["channels.deliver", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Resolve Routing", "when_blocked": {"forbidden": "auth.get_profile — resolve routing for another user_id only as admin", "not_found": "notifications.list_prefs — user or category routing missing"}, "when_to_use": "Routing read before deliver. Sending the notice is notifications.deliver."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.resolve_routing", "related_tools": ["channels.deliver", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Resolve Routing", "when_blocked": {"forbidden": "auth.get_profile — resolve routing for another user_id only as admin", "not_found": "notifications.list_prefs — user or category routing missing"}, "when_to_use": "Routing read before deliver. Sending the notice is notifications.deliver."}, "domain": "channels", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Preview security routing", "request": {"category": "security", "channels": ["email", "in_app"]}}], "execution_class": "plain_read", "instruction_hint": "Routing read before deliver. Sending the notice is notifications.deliver.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.deliver", "notifications.deliver"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "channels_resolve_routing", "semantic_input_mode": "inherit_workflow", "summary": "Preview effective channels after prefs ∩ sources ∩ project policy. Reads those prefs on the server and does not return the profile.", "title": "Channels Resolve Routing", "when_blocked": {"forbidden": "auth.get_profile — resolve routing for another user_id only as admin", "not_found": "notifications.list_prefs — user or category routing missing"}, "when_to_use": "Routing read before deliver. Sending the notice is notifications.deliver.", "write_mode": null}, {"action": "channels.list_failed_deliveries", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.list_failed_deliveries", "related_tools": ["channels.delivery_status", "channels.test_delivery"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels List Failed Deliveries", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "unauthorized": "auth.get_profile — failed delivery log is user-scoped"}, "when_to_use": "Profile delivery troubleshooting before re-test."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.list_failed_deliveries", "related_tools": ["channels.delivery_status", "channels.test_delivery"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels List Failed Deliveries", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "unauthorized": "auth.get_profile — failed delivery log is user-scoped"}, "when_to_use": "Profile delivery troubleshooting before re-test."}, "domain": "channels", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Profile delivery troubleshooting before re-test.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.delivery_status", "channels.test_delivery"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "channels_list_failed_deliveries", "semantic_input_mode": "inherit_workflow", "summary": "Recent failed/skipped delivery receipts for the user.", "title": "Channels List Failed Deliveries", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "unauthorized": "auth.get_profile — failed delivery log is user-scoped"}, "when_to_use": "Profile delivery troubleshooting before re-test.", "write_mode": null}, {"action": "channels.list_event_triggers", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.channel_plane.gen1"], "id": "channels.list_event_triggers", "related_tools": ["logic.create", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels List Event Triggers", "when_blocked": {"unauthorized": "auth.get_profile — event trigger catalog requires signed-in user"}, "when_to_use": "Attach Logic rules to delivery/enrollment/MFA channel events."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.channel_plane.gen1"], "id": "channels.list_event_triggers", "related_tools": ["logic.create", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels List Event Triggers", "when_blocked": {"unauthorized": "auth.get_profile — event trigger catalog requires signed-in user"}, "when_to_use": "Attach Logic rules to delivery/enrollment/MFA channel events."}, "domain": "channels", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Attach Logic rules to delivery/enrollment/MFA channel events.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["logic.create", "notifications.deliver"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "channels_list_event_triggers", "semantic_input_mode": "inherit_workflow", "summary": "Catalog of normalized channel neural_event kinds for Logic subscriptions.", "title": "Channels List Event Triggers", "when_blocked": {"unauthorized": "auth.get_profile — event trigger catalog requires signed-in user"}, "when_to_use": "Attach Logic rules to delivery/enrollment/MFA channel events.", "write_mode": null}, {"action": "channels.digest_depth", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.digest_depth", "related_tools": ["channels.flush_digest", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Digest Depth", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "unauthorized": "Signed-in user required"}, "when_to_use": "Read pending quiet-hours / digest_mode queue before flush. REST GET /users/me/notify-digest-depth. Not notifications.deliver."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.digest_depth", "related_tools": ["channels.flush_digest", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Digest Depth", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "unauthorized": "Signed-in user required"}, "when_to_use": "Read pending quiet-hours / digest_mode queue before flush. REST GET /users/me/notify-digest-depth. Not notifications.deliver."}, "domain": "channels", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read pending quiet-hours / digest_mode queue before flush. REST GET /users/me/notify-digest-depth. …", "mutation_kind": "none", "next_actions": ["channels.flush_digest", "notifications.list_prefs"], "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.flush_digest", "notifications.list_prefs"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "channels_digest_depth", "semantic_input_mode": "inherit_workflow", "summary": "Pending quiet-hours / digest_mode queue depth (same as GET /users/me/notify-digest-depth).", "title": "Channels Digest Depth", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "unauthorized": "Signed-in user required"}, "when_to_use": "Read pending quiet-hours / digest_mode queue before flush. REST GET /users/me/notify-digest-depth. Not notifications.deliver.", "write_mode": null}, {"action": "channels.flush_digest", "aliases": ["notifications.flush_digest", "notify.flush_digest"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.flush_digest", "related_tools": ["channels.digest_depth", "notifications.list_prefs", "channels.delivery_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Flush Digest", "when_blocked": {"digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — query another user_id only as admin", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "unauthorized": "Signed-in user required"}, "when_to_use": "Deliver batched user alerts now. Call channels.digest_depth first when unsure. REST POST /users/me/notify-flush-digest. Not Mail Hub messaging.send_email."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.flush_digest", "related_tools": ["channels.digest_depth", "notifications.list_prefs", "channels.delivery_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Flush Digest", "when_blocked": {"digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — query another user_id only as admin", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "unauthorized": "Signed-in user required"}, "when_to_use": "Deliver batched user alerts now. Call channels.digest_depth first when unsure. REST POST /users/me/notify-flush-digest. Not Mail Hub messaging.send_email."}, "domain": "channels", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Deliver batched user alerts now. Call channels.digest_depth first when unsure. REST POST /users/me/…", "mutation_kind": "none", "next_actions": ["channels.digest_depth", "channels.delivery_snapshot", "notifications.list_prefs"], "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.digest_depth", "notifications.list_prefs", "channels.delivery_snapshot"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "channels_flush_digest", "semantic_input_mode": "inherit_workflow", "summary": "Flush pending quiet-hours / digest notifications for the signed-in user.", "title": "Channels Flush Digest", "when_blocked": {"digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — query another user_id only as admin", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "unauthorized": "Signed-in user required"}, "when_to_use": "Deliver batched user alerts now. Call channels.digest_depth first when unsure. REST POST /users/me/notify-flush-digest. Not Mail Hub messaging.send_email.", "write_mode": null}, {"action": "channels.route", "ai_tips": "Bind the signed-in user's source channel to a delivery category, an agent, or a logic rule. The leaf is user.data.channel_routes on that user row. The first put keeps the email-to-chat template.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not subscribe the same logic_id to channel.event.inbound_message. This tool already queues that rule.", "anti_patterns": ["Do not subscribe the same logic_id to channel.event.inbound_message. This tool already queues that rule.", "Do not store message bodies on the route. The leaf holds ids and channel names only.", "An explicit items list replaces the email template. Remove the email-template row only when chat delivery should stop."], "capability_descriptor": {"complexity": "intermediate", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.channel_plane.gen1", "core.messaging.delivery.gen1"], "id": "channels.route", "related_tools": ["messaging.mailbox.agent.set", "messaging.inbox.list", "notifications.list_prefs", "channels.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Route", "when_blocked": {"invalid_parameters": "op list|put|remove; remove needs id", "not_found": "user row missing — confirm auth.get_profile user id", "route_cap": "Replace an existing route id — cap is ROUTE_CAP rows; see decorator anti_patterns", "unauthorized": "auth.get_profile — channel_routes are per signed-in user"}, "when_to_use": "Bind source channel to category, agent, or logic. op=list returns rows and email plan. Read ok/success on put/remove — not HTTP status."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.channel_plane.gen1", "core.messaging.delivery.gen1"], "id": "channels.route", "related_tools": ["messaging.mailbox.agent.set", "messaging.inbox.list", "notifications.list_prefs", "channels.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Route", "when_blocked": {"invalid_parameters": "op list|put|remove; remove needs id", "not_found": "user row missing — confirm auth.get_profile user id", "route_cap": "Replace an existing route id — cap is ROUTE_CAP rows; see decorator anti_patterns", "unauthorized": "auth.get_profile — channel_routes are per signed-in user"}, "when_to_use": "Bind source channel to category, agent, or logic. op=list returns rows and email plan. Read ok/success on put/remove — not HTTP status."}, "domain": "channels", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Bind source channel to category, agent, or logic. op=list returns rows and email plan. Read ok/succ…", "mutation_kind": "path", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["messaging.mailbox.agent.set", "messaging.inbox.list", "notifications.list_prefs", "channels.deliver"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "channels_route", "semantic_input_mode": "inherit_workflow", "summary": "List, put, or remove one channel binding for the signed-in user. op=list returns the stored rows and the email plan.", "title": "Channels Route", "when_blocked": {"invalid_parameters": "op list|put|remove; remove needs id", "not_found": "user row missing — confirm auth.get_profile user id", "route_cap": "Replace an existing route id — cap is ROUTE_CAP rows; see decorator anti_patterns", "unauthorized": "auth.get_profile — channel_routes are per signed-in user"}, "when_to_use": "Bind source channel to category, agent, or logic. op=list returns rows and email plan. Read ok/success on put/remove — not HTTP status.", "write_mode": null}, {"action": "channels.create_bind_link", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.channel_plane.gen1"], "id": "channels.create_bind_link", "related_tools": ["channels.list_identities", "channels.enroll_source", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Create Bind Link", "when_blocked": {"bot_not_accessible": "bots.list — no live bot or create_telegram_bind_deeplink failed; complete bots.go_live before bind", "invalid_parameters": "project_id required in params or context", "unauthorized": "auth.get_profile — bind link is per signed-in user"}, "when_to_use": "Telegram deliver blocked — list_identities empty (ch-02)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.channel_plane.gen1"], "id": "channels.create_bind_link", "related_tools": ["channels.list_identities", "channels.enroll_source", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Create Bind Link", "when_blocked": {"bot_not_accessible": "bots.list — no live bot or create_telegram_bind_deeplink failed; complete bots.go_live before bind", "invalid_parameters": "project_id required in params or context", "unauthorized": "auth.get_profile — bind link is per signed-in user"}, "when_to_use": "Telegram deliver blocked — list_identities empty (ch-02)."}, "domain": "channels", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Telegram deliver blocked — list_identities empty (ch-02).", "mutation_kind": "entity", "next_actions": ["channels.list_identities", "channels.enroll_source", "notifications.deliver"], "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.list_identities", "channels.enroll_source", "notifications.deliver"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "channels_create_bind_link", "semantic_input_mode": "inherit_workflow", "summary": "Self-serve Telegram deep link (/start bind_*) for the signed-in user.", "title": "Channels Create Bind Link", "when_blocked": {"bot_not_accessible": "bots.list — no live bot or create_telegram_bind_deeplink failed; complete bots.go_live before bind", "invalid_parameters": "project_id required in params or context", "unauthorized": "auth.get_profile — bind link is per signed-in user"}, "when_to_use": "Telegram deliver blocked — list_identities empty (ch-02).", "write_mode": null}, {"action": "channels.setup", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.channel_plane.gen1", "core.mcp.self_description.gen1"], "id": "channels.setup", "related_tools": ["channels.create_bind_link", "bots.list", "notifications.list_prefs", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Setup", "when_blocked": {"dependency_error": "Batch DAG blocked step — fix upstream step_id; standalone: run ladder tools in order", "no_channel_target": "channels.create_bind_link then user /start bind_* in Telegram — or channels.enroll_source after list_identities", "unauthorized": "auth.get_profile — ladder is user-scoped"}, "when_to_use": "Single entry before notifications.deliver when channel plane is unfamiliar."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.channel_plane.gen1", "core.mcp.self_description.gen1"], "id": "channels.setup", "related_tools": ["channels.create_bind_link", "bots.list", "notifications.list_prefs", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Setup", "when_blocked": {"dependency_error": "Batch DAG blocked step — fix upstream step_id; standalone: run ladder tools in order", "no_channel_target": "channels.create_bind_link then user /start bind_* in Telegram — or channels.enroll_source after list_identities", "unauthorized": "auth.get_profile — ladder is user-scoped"}, "when_to_use": "Single entry before notifications.deliver when channel plane is unfamiliar."}, "domain": "channels", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Single entry before notifications.deliver when channel plane is unfamiliar.", "mutation_kind": "none", "next_actions": ["bots.list", "notifications.list_prefs", "channels.create_bind_link", "notifications.deliver"], "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.create_bind_link", "bots.list", "notifications.list_prefs", "notifications.deliver"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "channels_setup", "semantic_input_mode": "inherit_workflow", "summary": "Guided notification channel setup (recipe mcp_notify_channels_v1 ladder).", "title": "Channels Setup", "when_blocked": {"dependency_error": "Batch DAG blocked step — fix upstream step_id; standalone: run ladder tools in order", "no_channel_target": "channels.create_bind_link then user /start bind_* in Telegram — or channels.enroll_source after list_identities", "unauthorized": "auth.get_profile — ladder is user-scoped"}, "when_to_use": "Single entry before notifications.deliver when channel plane is unfamiliar.", "write_mode": null}, {"action": "diagnostics.consistency.scan", "aliases": ["agents.graph_health"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not treat ok=true as promote-ready — read health_ok and graph_health.cycle.", "anti_patterns": ["Do not treat ok=true as promote-ready — read health_ok and graph_health.cycle.", "Info findings (empty KB, idle graph) do not set health_ok=false — only warning, error, critical, or a cycle.", "Do not sync_plan=true on production without reviewing finding codes first."], "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "evaluate", "mutates_when": {"sync_plan": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "effect_override": {"conditional_mutate": "sync_plan=true ingests findings into orchestrator task_list", "effect_depends_on_params": true, "kind": "evaluate", "mutates_when": {"sync_plan": true}}, "execution_class": "heavy", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.consistency.scan", "mutates_when": {"sync_plan": true}, "mutation_risk": "low", "related_tools": ["discovery.status", "agents.reconcile_binding", "agents.plan_reconcile_diagnostics", "agents.fleet_diagnostics", "agents.work_next", "agents.plan_recovery_scan", "knowledge.health", "guidance.recommend_skills"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Consistency Scan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_goal_facet": "agents.plan_propose mode=decompose_node — facet coverage incomplete on active goal", "provider_quota_exhausted": "buffs.get_effective_limits — wait/backoff; not a product bug", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "work_graph_contradiction": "agents.work_next — recovery rank mismatch vs stale claims; follow next_action", "work_graph_stale_claims": "agents.plan_reclaim_stale then agents.plan_get — stale lease before plan_claim"}, "when_to_use": "Incident triage before promote or after list anomalies. Set sync_plan=true to ingest actionable findings as plan tasks.", "write_when": ["params.sync_plan=true"]}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "evaluate", "mutates_when": {"sync_plan": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "effect_override": {"conditional_mutate": "sync_plan=true ingests findings into orchestrator task_list", "effect_depends_on_params": true, "kind": "evaluate", "mutates_when": {"sync_plan": true}}, "execution_class": "heavy", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.consistency.scan", "mutates_when": {"sync_plan": true}, "mutation_risk": "low", "related_tools": ["discovery.status", "agents.reconcile_binding", "agents.plan_reconcile_diagnostics", "agents.fleet_diagnostics", "agents.work_next", "agents.plan_recovery_scan", "knowledge.health", "guidance.recommend_skills"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Consistency Scan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_goal_facet": "agents.plan_propose mode=decompose_node — facet coverage incomplete on active goal", "provider_quota_exhausted": "buffs.get_effective_limits — wait/backoff; not a product bug", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "work_graph_contradiction": "agents.work_next — recovery rank mismatch vs stale claims; follow next_action", "work_graph_stale_claims": "agents.plan_reclaim_stale then agents.plan_get — stale lease before plan_claim"}, "when_to_use": "Incident triage before promote or after list anomalies. Set sync_plan=true to ingest actionable findings as plan tasks.", "write_when": ["params.sync_plan=true"]}, "domain": "diagnostics", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "effect_depends_on_params": true, "execution_class": "heavy", "generation": false, "kind": "evaluate", "mutates_when": {"sync_plan": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "effect_override": {"conditional_mutate": "sync_plan=true ingests findings into orchestrator task_list", "effect_depends_on_params": true, "kind": "evaluate", "mutates_when": {"sync_plan": true}}, "errors": {"env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self"}, "examples": [{"name": "Read-only project integrity scan", "request": {"params": {"project_id": 1, "sync_plan": false}, "tool": "diagnostics.consistency.scan"}, "response": {"data": {"finding_count": 0, "health_ok": true, "ok": true}, "success": true}}], "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Incident triage before promote or after list anomalies. Set sync_plan=true to ingest actionable fin…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["discovery.status", "agents.reconcile_binding", "agents.plan_reconcile_diagnostics", "agents.fleet_diagnostics", "agents.work_next", "agents.plan_recovery_scan", "knowledge.health", "guidance.recommend_skills"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_consistency_scan", "semantic_input_mode": "inherit_workflow", "summary": "Scan integrity; set sync_plan=true to append findings as plan tasks (default read-only).", "title": "Diagnostics Consistency Scan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_goal_facet": "agents.plan_propose mode=decompose_node — facet coverage incomplete on active goal", "provider_quota_exhausted": "buffs.get_effective_limits — wait/backoff; not a product bug", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "work_graph_contradiction": "agents.work_next — recovery rank mismatch vs stale claims; follow next_action", "work_graph_stale_claims": "agents.plan_reclaim_stale then agents.plan_get — stale lease before plan_claim"}, "when_to_use": "Incident triage before promote or after list anomalies. Set sync_plan=true to ingest actionable findings as plan tasks.", "write_mode": null}, {"action": "diagnostics.release_identity", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.release_identity", "related_tools": ["discovery.status", "system.version", "diagnostics.consistency.scan"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Release Identity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "W8/GAP-H drift probe after deploy — instruction_revision + catalog etag + core version without full consistency.scan. Compare to last prod evidence row."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.release_identity", "related_tools": ["discovery.status", "system.version", "diagnostics.consistency.scan"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Release Identity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "W8/GAP-H drift probe after deploy — instruction_revision + catalog etag + core version without full consistency.scan. Compare to last prod evidence row."}, "domain": "diagnostics", "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Post-deploy substrate identity", "request": {"params": {}, "tool": "diagnostics.release_identity"}, "response": {"data": {"release_identity": {"catalog_etag": "…", "core_version": "0.4.x", "instruction_revision": "…"}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "W8/GAP-H drift probe after deploy — instruction_revision + catalog etag + core version without full…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["discovery.status", "system.version", "diagnostics.consistency.scan"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_release_identity", "semantic_input_mode": "inherit_workflow", "summary": "Platform MCP release stamps (instruction_revision, catalog etag, core version) — W8 drift probe without full consistency.scan.", "title": "Diagnostics Release Identity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "W8/GAP-H drift probe after deploy — instruction_revision + catalog etag + core version without full consistency.scan. Compare to last prod evidence row.", "write_mode": null}, {"action": "diagnostics.helix_release_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not call projects.patch_data on pid=1 for image channel — use helix_release_get.", "anti_patterns": ["Do not call projects.patch_data on pid=1 for image channel — use helix_release_get."], "capability_descriptor": {"complexity": "simple", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1", "repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_release_get", "mutation_risk": "low", "related_tools": ["diagnostics.helix_placement_get", "diagnostics.helix_pair_doctor"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Release Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires mcp_read capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator helix image channel on pid=1 — not tenant generation.promote. Uses 2s process cache; after helix_release_set prefer placement_get or doctor."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1", "repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_release_get", "mutation_risk": "low", "related_tools": ["diagnostics.helix_placement_get", "diagnostics.helix_pair_doctor"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Release Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires mcp_read capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator helix image channel on pid=1 — not tenant generation.promote. Uses 2s process cache; after helix_release_set prefer placement_get or doctor."}, "doc_audience": "operator", "domain": "diagnostics", "domain_title": "Helix mesh organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"service_cap_denied": "Requires mcp_read capability."}, "examples": [{"name": "Pre-deploy channel check", "request": {"params": {}, "tool": "diagnostics.helix_release_get"}, "response": {"data": {"channel": "prod", "desired_image": "…"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "instruction_hint": "Operator helix image channel on pid=1 — not tenant generation.promote. Uses 2s process cache; after…", "kind": "ecs_system", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "helix_mesh", "owner_gene": "repo.ops.node_mesh_release.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.helix_placement_get", "diagnostics.helix_pair_doctor"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_helix_release_get", "semantic_input_mode": "inherit_workflow", "summary": "Read ecosystem.node_mesh.release on pid=1 (image channel, not generation.promote).", "title": "Diagnostics Helix Release Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires mcp_read capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator helix image channel on pid=1 — not tenant generation.promote. Uses 2s process cache; after helix_release_set prefer placement_get or doctor.", "write_mode": null}, {"action": "diagnostics.helix_placement_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not load full projects.get_data blob — placement is ecosystem.node_mesh.placement leaf.", "anti_patterns": ["Do not load full projects.get_data blob — placement is ecosystem.node_mesh.placement leaf."], "capability_descriptor": {"complexity": "simple", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1", "repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_placement_get", "mutation_risk": "low", "related_tools": ["diagnostics.helix_release_get", "diagnostics.helix_pair_doctor"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Placement Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires mcp_read capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pair placement leaf before resolve/renew drills."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1", "repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_placement_get", "mutation_risk": "low", "related_tools": ["diagnostics.helix_release_get", "diagnostics.helix_pair_doctor"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Placement Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires mcp_read capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pair placement leaf before resolve/renew drills."}, "doc_audience": "operator", "domain": "diagnostics", "domain_title": "Helix mesh organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"service_cap_denied": "Requires mcp_read capability."}, "examples": [{"name": "Placement before resolve drill", "request": {"params": {}, "tool": "diagnostics.helix_placement_get"}, "response": {"data": {"pairs": {}, "proving_pair_id": ""}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "instruction_hint": "Pair placement leaf before resolve/renew drills.", "kind": "ecs_system", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "helix_mesh", "owner_gene": "repo.ops.node_mesh_release.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.helix_release_get", "diagnostics.helix_pair_doctor"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_helix_placement_get", "semantic_input_mode": "inherit_workflow", "summary": "Read ecosystem.node_mesh.placement pairs leaf on pid=1.", "title": "Diagnostics Helix Placement Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires mcp_read capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pair placement leaf before resolve/renew drills.", "write_mode": null}, {"action": "diagnostics.helix_strand_phase_dry_run", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not use for production image pull — phases emit operator signals only.", "anti_patterns": ["Do not use for production image pull — phases emit operator signals only.", "Do not enqueue platform_work_items — use plan_strand_update for real rolls."], "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_strand_phase_dry_run", "mutation_risk": "low", "related_tools": ["diagnostics.helix_pair_doctor", "diagnostics.helix_placement_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Strand Phase Dry Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Required helix param missing (see tool params — token, channel, or pair_id).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "member_not_drained": "Unhealthy member before strand restart — fix peer health probe / drain phase.", "member_pull_lag": "Peer POST /api/helix/pull rev below strand target — wait for J-3 catch-up on lagging members.", "member_urls_required": "Multi-member strand job needs member_urls on placement pair meta before drain.", "pull_incomplete": "Placement head_revs below strand pull_targets — extend pull_wait_s or fix writers.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires mcp_read capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Debug drain or poll phases before planning a strand job."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_strand_phase_dry_run", "mutation_risk": "low", "related_tools": ["diagnostics.helix_pair_doctor", "diagnostics.helix_placement_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Strand Phase Dry Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Required helix param missing (see tool params — token, channel, or pair_id).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "member_not_drained": "Unhealthy member before strand restart — fix peer health probe / drain phase.", "member_pull_lag": "Peer POST /api/helix/pull rev below strand target — wait for J-3 catch-up on lagging members.", "member_urls_required": "Multi-member strand job needs member_urls on placement pair meta before drain.", "pull_incomplete": "Placement head_revs below strand pull_targets — extend pull_wait_s or fix writers.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires mcp_read capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Debug drain or poll phases before planning a strand job."}, "doc_audience": "operator", "domain": "diagnostics", "domain_title": "Helix mesh organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Required helix param missing (see tool params — token, channel, or pair_id).", "member_not_drained": "Unhealthy member before strand restart — fix peer health probe / drain phase.", "member_pull_lag": "Peer POST /api/helix/pull rev below strand target — wait for J-3 catch-up on lagging members.", "member_urls_required": "Multi-member strand job needs member_urls on placement pair meta before drain.", "pull_incomplete": "Placement head_revs below strand pull_targets — extend pull_wait_s or fix writers.", "service_cap_denied": "Requires mcp_read capability."}, "examples": [{"name": "Dry-run drain on proving pair", "request": {"params": {"pair_id": "prov-v1", "phase": "drain_quiet_member"}, "tool": "diagnostics.helix_strand_phase_dry_run"}, "response": {"data": {"phase": "drain_quiet_member", "result": {}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "instruction_hint": "Debug drain or poll phases before planning a strand job.", "kind": "ecs_system", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "helix_mesh", "owner_gene": "repo.ops.node_mesh_release.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.helix_pair_doctor", "diagnostics.helix_placement_get"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_helix_strand_phase_dry_run", "semantic_input_mode": "inherit_workflow", "summary": "Execute one helix strand phase in-process — no platform_work_items enqueue.", "title": "Diagnostics Helix Strand Phase Dry Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Required helix param missing (see tool params — token, channel, or pair_id).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "member_not_drained": "Unhealthy member before strand restart — fix peer health probe / drain phase.", "member_pull_lag": "Peer POST /api/helix/pull rev below strand target — wait for J-3 catch-up on lagging members.", "member_urls_required": "Multi-member strand job needs member_urls on placement pair meta before drain.", "pull_incomplete": "Placement head_revs below strand pull_targets — extend pull_wait_s or fix writers.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires mcp_read capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Debug drain or poll phases before planning a strand job.", "write_mode": null}, {"action": "diagnostics.helix_pair_doctor", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not scrape __protein_ops — helix heads and release/placement leaves only.", "anti_patterns": ["Do not scrape __protein_ops — helix heads and release/placement leaves only."], "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_pair_doctor", "mutation_risk": "low", "related_tools": ["diagnostics.helix_release_get", "diagnostics.helix_placement_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Pair Doctor", "when_blocked": {"complement_timeout": "Complement did not ack in time — host journal kept; retry seal, do not rewind.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "empty_ops": "Complement seal rejected an empty ops batch — host must resend the journal row.", "epoch_stale": "Call diagnostics.helix_pair_doctor then POST /api/helix/resolve for a fresh token.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "pair_heat_cold": "watcher_mode=heat and this process has no helix pair protein heat above the floor — seal or notify the pair, or set HELIX_WATCHER_HEAT_GATE=0.", "pair_not_found": "Call diagnostics.helix_placement_get — use an existing pair_id from pairs leaf.", "project_mismatch": "Seal token project_id does not match the body — remint complement seal for that key.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "seal_forbidden": "Seal requires purpose=complement_seal on the token minted by the host strand.", "service_cap_denied": "Requires mcp_read capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unknown_head": "Pull target has no materialized head — peer must resolve or wait for the first seal.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "watcher_map_only": "Pair watcher_mode=map_only defers epoch CAS — switch mode or wait."}, "when_to_use": "Contract fixture + release/placement snapshot before resolve or strand drills."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_pair_doctor", "mutation_risk": "low", "related_tools": ["diagnostics.helix_release_get", "diagnostics.helix_placement_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Pair Doctor", "when_blocked": {"complement_timeout": "Complement did not ack in time — host journal kept; retry seal, do not rewind.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "empty_ops": "Complement seal rejected an empty ops batch — host must resend the journal row.", "epoch_stale": "Call diagnostics.helix_pair_doctor then POST /api/helix/resolve for a fresh token.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "pair_heat_cold": "watcher_mode=heat and this process has no helix pair protein heat above the floor — seal or notify the pair, or set HELIX_WATCHER_HEAT_GATE=0.", "pair_not_found": "Call diagnostics.helix_placement_get — use an existing pair_id from pairs leaf.", "project_mismatch": "Seal token project_id does not match the body — remint complement seal for that key.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "seal_forbidden": "Seal requires purpose=complement_seal on the token minted by the host strand.", "service_cap_denied": "Requires mcp_read capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unknown_head": "Pull target has no materialized head — peer must resolve or wait for the first seal.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "watcher_map_only": "Pair watcher_mode=map_only defers epoch CAS — switch mode or wait."}, "when_to_use": "Contract fixture + release/placement snapshot before resolve or strand drills."}, "doc_audience": "operator", "domain": "diagnostics", "domain_title": "Helix mesh organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"pair_not_found": "Call diagnostics.helix_placement_get — use an existing pair_id from pairs leaf.", "service_cap_denied": "Requires mcp_read capability."}, "examples": [{"name": "Doctor default pair (proving/prod policy)", "request": {"params": {}, "tool": "diagnostics.helix_pair_doctor"}, "response": {"data": {"contract_version": 1, "pair_id": "…"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "instruction_hint": "Contract fixture + release/placement snapshot before resolve or strand drills.", "kind": "ecs_system", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "helix_mesh", "owner_gene": "repo.ops.node_mesh_release.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.helix_release_get", "diagnostics.helix_placement_get"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_helix_pair_doctor", "semantic_input_mode": "inherit_workflow", "summary": "In-process helix doctor: contract fixture + release/placement snapshot.", "title": "Diagnostics Helix Pair Doctor", "when_blocked": {"complement_timeout": "Complement did not ack in time — host journal kept; retry seal, do not rewind.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "empty_ops": "Complement seal rejected an empty ops batch — host must resend the journal row.", "epoch_stale": "Call diagnostics.helix_pair_doctor then POST /api/helix/resolve for a fresh token.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "pair_heat_cold": "watcher_mode=heat and this process has no helix pair protein heat above the floor — seal or notify the pair, or set HELIX_WATCHER_HEAT_GATE=0.", "pair_not_found": "Call diagnostics.helix_placement_get — use an existing pair_id from pairs leaf.", "project_mismatch": "Seal token project_id does not match the body — remint complement seal for that key.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "seal_forbidden": "Seal requires purpose=complement_seal on the token minted by the host strand.", "service_cap_denied": "Requires mcp_read capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unknown_head": "Pull target has no materialized head — peer must resolve or wait for the first seal.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "watcher_map_only": "Pair watcher_mode=map_only defers epoch CAS — switch mode or wait."}, "when_to_use": "Contract fixture + release/placement snapshot before resolve or strand drills.", "write_mode": null}, {"action": "diagnostics.helix_renew_token", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not bump pair epoch on member failover — renew slides exp; epoch CAS is watcher-only.", "anti_patterns": ["Do not bump pair epoch on member failover — renew slides exp; epoch CAS is watcher-only."], "capability_descriptor": {"complexity": "simple", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_renew_token", "mutation_risk": "low", "related_tools": ["diagnostics.helix_placement_get", "diagnostics.helix_pair_doctor"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Renew Token", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "epoch_stale": "Call diagnostics.helix_pair_doctor then POST /api/helix/resolve for a fresh token.", "invalid_member": "member_id not in placement pair members.", "invalid_parameters": "token required", "invalid_token": "Helix token signature or exp failed — resolve again.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "pair_not_found": "Call diagnostics.helix_placement_get — use an existing pair_id from pairs leaf.", "pair_retired": "Retired pair — steer release channel or placement before resolve.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Renew sticky helix token on member; epoch unchanged on failover."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_renew_token", "mutation_risk": "low", "related_tools": ["diagnostics.helix_placement_get", "diagnostics.helix_pair_doctor"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Renew Token", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "epoch_stale": "Call diagnostics.helix_pair_doctor then POST /api/helix/resolve for a fresh token.", "invalid_member": "member_id not in placement pair members.", "invalid_parameters": "token required", "invalid_token": "Helix token signature or exp failed — resolve again.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "pair_not_found": "Call diagnostics.helix_placement_get — use an existing pair_id from pairs leaf.", "pair_retired": "Retired pair — steer release channel or placement before resolve.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Renew sticky helix token on member; epoch unchanged on failover."}, "doc_audience": "operator", "domain": "diagnostics", "domain_title": "Helix mesh organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"epoch_stale": "Call diagnostics.helix_pair_doctor then POST /api/helix/resolve for a fresh token.", "invalid_member": "member_id not in placement pair members.", "invalid_parameters": "token required", "invalid_token": "Helix token signature or exp failed — resolve again.", "pair_not_found": "Call diagnostics.helix_placement_get — use an existing pair_id from pairs leaf.", "pair_retired": "Retired pair — steer release channel or placement before resolve."}, "examples": [{"name": "Slide TTL after resolve", "request": {"params": {"token": "<signed>"}, "tool": "diagnostics.helix_renew_token"}, "response": {"data": {"claims": {}, "token": "…"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "instruction_hint": "Renew sticky helix token on member; epoch unchanged on failover.", "kind": "ecs_system", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "helix_mesh", "owner_gene": "repo.ops.node_mesh_release.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.helix_placement_get", "diagnostics.helix_pair_doctor"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_helix_renew_token", "semantic_input_mode": "inherit_workflow", "summary": "Slide helix token TTL after placement precheck (helix_renew_precheck) — not release set.", "title": "Diagnostics Helix Renew Token", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "epoch_stale": "Call diagnostics.helix_pair_doctor then POST /api/helix/resolve for a fresh token.", "invalid_member": "member_id not in placement pair members.", "invalid_parameters": "token required", "invalid_token": "Helix token signature or exp failed — resolve again.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "pair_not_found": "Call diagnostics.helix_placement_get — use an existing pair_id from pairs leaf.", "pair_retired": "Retired pair — steer release channel or placement before resolve.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Renew sticky helix token on member; epoch unchanged on failover.", "write_mode": null}, {"action": "diagnostics.helix_release_set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not use generation.promote or sandbox_service for backend image channel.", "anti_patterns": ["Do not use generation.promote or sandbox_service for backend image channel."], "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_release_set", "mutation_risk": "low", "related_tools": ["diagnostics.helix_release_get", "diagnostics.helix_placement_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Release Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "channel required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "helix_release_set needs operator capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "Atomic leaf write on ecosystem.node_mesh.release failed."}, "when_to_use": "Operator write of image channel on pid=1. Not generation.promote."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_release_set", "mutation_risk": "low", "related_tools": ["diagnostics.helix_release_get", "diagnostics.helix_placement_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Release Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "channel required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "helix_release_set needs operator capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "Atomic leaf write on ecosystem.node_mesh.release failed."}, "when_to_use": "Operator write of image channel on pid=1. Not generation.promote."}, "doc_audience": "operator", "domain": "diagnostics", "domain_title": "Helix mesh organelle", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"invalid_parameters": "channel required", "service_cap_denied": "helix_release_set needs operator capability.", "write_failed": "Atomic leaf write on ecosystem.node_mesh.release failed."}, "examples": [{"name": "Steer resolve to prod channel", "request": {"params": {"channel": "prod", "desired_image": "ghcr.io/…"}, "tool": "diagnostics.helix_release_set"}, "response": {"data": {"channel": "prod"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "instruction_hint": "Operator write of image channel on pid=1. Not generation.promote.", "kind": "ecs_system", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "helix_mesh", "owner_gene": "repo.ops.node_mesh_release.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.helix_release_get", "diagnostics.helix_placement_get"], "required_cap": "operator", "requires_preflight": false, "risk_class": "low_write", "safe_action": "diagnostics_helix_release_set", "semantic_input_mode": "inherit_workflow", "summary": "Operator: set helix release channel / desired_image on pid=1.", "title": "Diagnostics Helix Release Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "channel required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "helix_release_set needs operator capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "Atomic leaf write on ecosystem.node_mesh.release failed."}, "when_to_use": "Operator write of image channel on pid=1. Not generation.promote.", "write_mode": null}, {"action": "diagnostics.helix_watcher_epoch_arm", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not bump pair epoch via projects.patch_data — use placement CAS via watcher tick.", "anti_patterns": ["Do not bump pair epoch via projects.patch_data — use placement CAS via watcher tick.", "A rejected CAS clears pending_epoch; re-arm with the live expected epoch.", "watcher_mode=map_only defers the tick (watcher_map_only) and keeps pending_epoch."], "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1", "repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_watcher_epoch_arm", "mutation_risk": "low", "related_tools": ["diagnostics.helix_placement_get", "diagnostics.helix_pair_doctor"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Watcher Epoch Arm", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "pair_id, expected_epoch, and new_epoch required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "helix_watcher_epoch_arm needs operator capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "Atomic leaf write on ecosystem.node_mesh.watcher.pending_epoch failed."}, "when_to_use": "Arm watcher pending epoch bump on pid=1; helix-watcher tick runs CAS."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1", "repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_watcher_epoch_arm", "mutation_risk": "low", "related_tools": ["diagnostics.helix_placement_get", "diagnostics.helix_pair_doctor"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Watcher Epoch Arm", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "pair_id, expected_epoch, and new_epoch required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "helix_watcher_epoch_arm needs operator capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "Atomic leaf write on ecosystem.node_mesh.watcher.pending_epoch failed."}, "when_to_use": "Arm watcher pending epoch bump on pid=1; helix-watcher tick runs CAS."}, "doc_audience": "operator", "domain": "diagnostics", "domain_title": "Helix mesh organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "pair_id, expected_epoch, and new_epoch required.", "service_cap_denied": "helix_watcher_epoch_arm needs operator capability.", "write_failed": "Atomic leaf write on ecosystem.node_mesh.watcher.pending_epoch failed."}, "examples": [{"name": "Arm epoch after split drill", "request": {"params": {"expected_epoch": 2, "new_epoch": 3, "pair_id": "p1"}, "tool": "diagnostics.helix_watcher_epoch_arm"}, "response": {"data": {"new_epoch": 3, "pair_id": "p1"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "instruction_hint": "Arm watcher pending epoch bump on pid=1; helix-watcher tick runs CAS.", "kind": "ecs_system", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "helix_mesh", "owner_gene": "repo.ops.node_mesh_release.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.helix_placement_get", "diagnostics.helix_pair_doctor"], "required_cap": "operator", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_helix_watcher_epoch_arm", "semantic_input_mode": "inherit_workflow", "summary": "Arm pending epoch bump for watcher CAS on pid=1 placement pair.", "title": "Diagnostics Helix Watcher Epoch Arm", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "pair_id, expected_epoch, and new_epoch required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "helix_watcher_epoch_arm needs operator capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "Atomic leaf write on ecosystem.node_mesh.watcher.pending_epoch failed."}, "when_to_use": "Arm watcher pending epoch bump on pid=1; helix-watcher tick runs CAS.", "write_mode": null}, {"action": "diagnostics.report", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not use social.support.send for platform substrate bugs — use diagnostics.report.", "anti_patterns": ["Do not use social.support.send for platform substrate bugs — use diagnostics.report.", "Do not use trust.feedback for operator MCP failures — distinct plane."], "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.report", "related_tools": ["diagnostics.report_list", "diagnostics.report_get", "diagnostics.report_attach", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Report", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "report_rate_limited": "Too many reports this hour; retry later.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Durable platform problem report with trace/MCP context — operator/agent. Required: summary (short title line), severity s0|s1|s2|s3, category string — not title alone. Optional: detail, project_id, co"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.report", "related_tools": ["diagnostics.report_list", "diagnostics.report_get", "diagnostics.report_attach", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Report", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "report_rate_limited": "Too many reports this hour; retry later.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Durable platform problem report with trace/MCP context — operator/agent. Required: summary (short title line), severity s0|s1|s2|s3, category string — not title alone. Optional: detail, project_id, co"}, "doc_audience": "operator", "domain": "diagnostics", "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "report_rate_limited": "Too many reports this hour; retry later.", "service_cap_denied": "Requires diagnostics_report capability.", "unauthorized": "Sign in or Connect MCP before reporting."}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Durable platform problem report with trace/MCP context — operator/agent. Required: summary (short t…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.report_list", "diagnostics.report_get", "diagnostics.report_attach", "agents.work_next"], "required_cap": "diagnostics_report", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_report", "semantic_input_mode": "inherit_workflow", "summary": "Create a platform problem report (operator/agent). Distinct from trust.feedback and social.support.", "title": "Diagnostics Report", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "report_rate_limited": "Too many reports this hour; retry later.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Durable platform problem report with trace/MCP context — operator/agent. Required: summary (short title line), severity s0|s1|s2|s3, category string — not title alone. Optional: detail, project_id, co", "write_mode": null}, {"action": "diagnostics.report_list", "aliases": ["diagnostics.reports.list", "report.list", "reports.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.report_list", "related_tools": ["diagnostics.report", "diagnostics.report_get"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Report List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator triage list after diagnostics.report — compact index rows by default."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.report_list", "related_tools": ["diagnostics.report", "diagnostics.report_get"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Report List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator triage list after diagnostics.report — compact index rows by default."}, "domain": "diagnostics", "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"service_cap_denied": "Requires diagnostics_report capability.", "unauthorized": "Sign in or Connect MCP before reporting."}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Operator triage list after diagnostics.report — compact index rows by default.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.report", "diagnostics.report_get"], "required_cap": "diagnostics_report", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_report_list", "semantic_input_mode": "inherit_workflow", "summary": "List platform problem reports (index rows).", "title": "Diagnostics Report List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator triage list after diagnostics.report — compact index rows by default.", "write_mode": null}, {"action": "diagnostics.report_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.report_get", "related_tools": ["diagnostics.report_list", "diagnostics.report_attach"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Report Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown report_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Deep triage: ECS body, attachments, optional OpTrace tail."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.report_get", "related_tools": ["diagnostics.report_list", "diagnostics.report_attach"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Report Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown report_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Deep triage: ECS body, attachments, optional OpTrace tail."}, "domain": "diagnostics", "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"not_found": "Unknown report_id.", "service_cap_denied": "Requires diagnostics_report capability.", "unauthorized": "Sign in or Connect MCP before reporting."}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Deep triage: ECS body, attachments, optional OpTrace tail.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.report_list", "diagnostics.report_attach"], "required_cap": "diagnostics_report", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_report_get", "semantic_input_mode": "inherit_workflow", "summary": "Fetch one platform report by id (ECS body + attachments).", "title": "Diagnostics Report Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown report_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Deep triage: ECS body, attachments, optional OpTrace tail.", "write_mode": null}, {"action": "diagnostics.report_attach", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.report_attach", "related_tools": ["diagnostics.report", "diagnostics.report_get"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Report Attach", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown report_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append reproduction steps to an existing report_id."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.report_attach", "related_tools": ["diagnostics.report", "diagnostics.report_get"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Report Attach", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown report_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append reproduction steps to an existing report_id."}, "domain": "diagnostics", "domain_title": "Admin Data MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "not_found": "Unknown report_id.", "service_cap_denied": "Requires diagnostics_report capability.", "unauthorized": "Sign in or Connect MCP before reporting."}, "execution_class": "cheap", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Append reproduction steps to an existing report_id.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.report", "diagnostics.report_get"], "required_cap": "diagnostics_report", "requires_preflight": false, "risk_class": "low_write", "safe_action": "diagnostics_report_attach", "semantic_input_mode": "inherit_workflow", "summary": "Append a follow-up note to an existing platform report.", "title": "Diagnostics Report Attach", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown report_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append reproduction steps to an existing report_id.", "write_mode": null}, {"action": "diagnostics.report_update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.report_update", "related_tools": ["diagnostics.report_get", "diagnostics.report_list"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Report Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown report_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move report through triage lifecycle (open → triage → resolved). Index leaf only."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.report_update", "related_tools": ["diagnostics.report_get", "diagnostics.report_list"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Report Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown report_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move report through triage lifecycle (open → triage → resolved). Index leaf only."}, "domain": "diagnostics", "domain_title": "Admin Data MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "not_found": "Unknown report_id.", "service_cap_denied": "Requires diagnostics_report capability.", "unauthorized": "Sign in or Connect MCP before reporting."}, "execution_class": "cheap", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Move report through triage lifecycle (open → triage → resolved). Index leaf only.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.report_get", "diagnostics.report_list"], "required_cap": "diagnostics_report", "requires_preflight": false, "risk_class": "low_write", "safe_action": "diagnostics_report_update", "semantic_input_mode": "inherit_workflow", "summary": "Update platform report status (open, triage, resolved).", "title": "Diagnostics Report Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown report_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move report through triage lifecycle (open → triage → resolved). Index leaf only.", "write_mode": null}, {"action": "diagnostics.neural_graph", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.neural_graph", "related_tools": ["admin.data.health", "organelle.execute", "diagnostics.promote_hot_gene"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Neural Graph", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Robot/operator inspect live neural topology + hot paths without opening the SPA."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.neural_graph", "related_tools": ["admin.data.health", "organelle.execute", "diagnostics.promote_hot_gene"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Neural Graph", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Robot/operator inspect live neural topology + hot paths without opening the SPA."}, "domain": "diagnostics", "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Robot/operator inspect live neural topology + hot paths without opening the SPA.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["admin.data.health", "organelle.execute", "diagnostics.promote_hot_gene"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_neural_graph", "semantic_input_mode": "inherit_workflow", "summary": "Neural Visualizer Gen2 snapshot: topology, heat planes (protein/api/dna_query/gene), composition edges, hot_region_hints. Always includes heat_meta (worker layout honesty). Process-local heat; Tier F ", "title": "Diagnostics Neural Graph", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Robot/operator inspect live neural topology + hot paths without opening the SPA.", "write_mode": null}, {"action": "diagnostics.promote_hot_gene", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.promote_hot_gene", "related_tools": ["diagnostics.neural_graph"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Promote Hot Gene", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator pins hot gene paths after reviewing Neural Visualizer gene plane."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.promote_hot_gene", "related_tools": ["diagnostics.neural_graph"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Promote Hot Gene", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator pins hot gene paths after reviewing Neural Visualizer gene plane."}, "domain": "diagnostics", "domain_title": "Admin Data MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Operator pins hot gene paths after reviewing Neural Visualizer gene plane.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.neural_graph"], "required_cap": "admin.write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "diagnostics_promote_hot_gene", "semantic_input_mode": "inherit_workflow", "summary": "Promote a genetic tag's path prefixes into HotProteinRegion for an entity. Modes: warm, pin, prefetch_only. Tier F materialize blocked.", "title": "Diagnostics Promote Hot Gene", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator pins hot gene paths after reviewing Neural Visualizer gene plane.", "write_mode": null}, {"action": "diagnostics.gene_token_query", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.gene_token_query", "related_tools": ["diagnostics.neural_graph", "diagnostics.promote_hot_gene"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Gene Token Query", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Admin debug: find hot protein bindings by genetic token AND query."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.gene_token_query", "related_tools": ["diagnostics.neural_graph", "diagnostics.promote_hot_gene"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Gene Token Query", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Admin debug: find hot protein bindings by genetic token AND query."}, "domain": "diagnostics", "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Admin debug: find hot protein bindings by genetic token AND query.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.neural_graph", "diagnostics.promote_hot_gene"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_gene_token_query", "semantic_input_mode": "inherit_workflow", "summary": "GTPI bool query against process-local gene token lexicon.", "title": "Diagnostics Gene Token Query", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Admin debug: find hot protein bindings by genetic token AND query.", "write_mode": null}, {"action": "agents.graph_health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not mutate task_list via projects.patch_data — use plan_heal_leaf / plan_patch archive ladder."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.graph_health", "related_tools": ["diagnostics.consistency.scan", "agents.plan_get", "agents.work_next", "agents.plan_compaction_preview", "agents.plan_heal_leaf"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Graph Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only graph health before plan_execute on risky leaves or after verification_failed — follow recommended_follow_up; does not mutate DNA. First step when graph_limits.spill_incomplete, advisories p"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.graph_health", "related_tools": ["diagnostics.consistency.scan", "agents.plan_get", "agents.work_next", "agents.plan_compaction_preview", "agents.plan_heal_leaf"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Graph Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only graph health before plan_execute on risky leaves or after verification_failed — follow recommended_follow_up; does not mutate DNA. First step when graph_limits.spill_incomplete, advisories p"}, "do_not_use_when": "Do not mutate task_list via projects.patch_data — use plan_heal_leaf / plan_patch archive ladder.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Project graph health before plan_execute", "request": {"params": {"home": "project", "project_id": 1}, "tool": "agents.graph_health"}, "response": {"data": {"finding_count": 0, "health_ok": true}, "success": true}}, {"description": "When needs_leaf_heal or spill_incomplete: plan_compaction_preview → plan_heal_leaf dry_run then apply; manual prose via graph_file_put", "name": "Community hub spill advisory", "request": {"params": {"home": "project_self", "project_id": 1}, "tool": "agents.graph_health"}, "response": {"data": {"finding_count": 1, "graph_limits": {"body_read_chunk_seal": "agents.plan_get detail=body node_id", "body_read_storage_ref": "agents.graph_file_get", "bytes_estimate": 520000, "chunk_spill_target_bytes": 400000, "needs_leaf_heal": true, "spill_incomplete": true}, "health_ok": true}, "success": true}}], "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Read-only graph health before plan_execute on risky leaves or after verification_failed — follow re…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_compaction_preview", "agents.plan_heal_leaf"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.consistency.scan", "agents.plan_get", "agents.work_next", "agents.plan_compaction_preview", "agents.plan_heal_leaf"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_graph_health", "semantic_input_mode": "inherit_workflow", "summary": "Work Graph health snapshot (loop compliance, blocked ratio, structural cycle). Thin read wrapper over diagnostics.consistency.scan graph_health block.", "title": "Agents Graph Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not mutate task_list via projects.patch_data — use plan_heal_leaf / plan_patch archive ladder.", "when_to_use": "Read-only graph health before plan_execute on risky leaves or after verification_failed — follow recommended_follow_up; does not mutate DNA. First step when graph_limits.spill_incomplete, advisories p", "write_mode": null}, {"action": "agents.list", "aliases": ["agents.catalog", "agents.fleet", "agents.list_agents"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.list", "related_tools": ["agents.get", "agents.create", "agents.run", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover fleet rows before get/run. Read projection on the response — summary is not full spec. home=project (default) | self | project_self — env_uuid only when home=project. owner=user lists persona"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.list", "related_tools": ["agents.get", "agents.create", "agents.run", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover fleet rows before get/run. Read projection on the response — summary is not full spec. home=project (default) | self | project_self — env_uuid only when home=project. owner=user lists persona"}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Fleet index cards", "request": {"params": {"project_id": 1, "projection": "summary"}, "tool": "agents.list"}, "response": {"data": {"agents": [], "projection": "summary"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Discover fleet rows before get/run. Read projection on the response — summary is not full spec. hom…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.get", "agents.create", "agents.run", "discovery.describe"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_list", "semantic_input_mode": "inherit_workflow", "summary": "List Agents Fleet rows. Default projection=summary reads the fleet index card (uuid, title, status), not agent_spec. projection=full loads the agent row.", "title": "Agents List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover fleet rows before get/run. Read projection on the response — summary is not full spec. home=project (default) | self | project_self — env_uuid only when home=project. owner=user lists persona", "write_mode": null}, {"action": "agents.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.get", "related_tools": ["agents.list", "agents.update", "agents.run", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load full agent_spec for edit or run. home=project | self | project_self — env_uuid only when home=project (sandbox overlay). owner=user for personal rows. Omit env for production read."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.get", "related_tools": ["agents.list", "agents.update", "agents.run", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load full agent_spec for edit or run. home=project | self | project_self — env_uuid only when home=project (sandbox overlay). owner=user for personal rows. Omit env for production read."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Full AgentSpec", "request": {"params": {"agent_id": "<uuid>", "project_id": 1, "projection": "full"}, "tool": "agents.get"}, "response": {"data": {"agent": {}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Load full agent_spec for edit or run. home=project | self | project_self — env_uuid only when home=…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.list", "agents.update", "agents.run", "discovery.describe"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_get", "semantic_input_mode": "inherit_workflow", "summary": "Get a single agent by UUID (default owner=project; personal rows need owner=user).", "title": "Agents Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load full agent_spec for edit or run. home=project | self | project_self — env_uuid only when home=project (sandbox overlay). owner=user for personal rows. Omit env for production read.", "write_mode": null}, {"action": "agents.workflow_compile_preview", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.workflow_compile_preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Workflow Compile Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Validate workflow graph compile without persisting AgentSpec (read-only)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.workflow_compile_preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Workflow Compile Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Validate workflow graph compile without persisting AgentSpec (read-only)."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Validate workflow graph compile without persisting AgentSpec (read-only).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_workflow_compile_preview", "semantic_input_mode": "inherit_workflow", "summary": "Validate workflow graph compile without persisting AgentSpec (read-only).", "title": "Agents Workflow Compile Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Validate workflow graph compile without persisting AgentSpec (read-only).", "write_mode": null}, {"action": "agents.create", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.create", "mutation_risk": "low", "related_tools": ["agents.get", "agents.update"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be created under an open sandbox head without diff-child bootstrap (AA-10b). Fork generation env or clear head; then use scoped create overlay.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Provision a fleet agent."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.create", "mutation_risk": "low", "related_tools": ["agents.get", "agents.update"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be created under an open sandbox head without diff-child bootstrap (AA-10b). Fork generation env or clear head; then use scoped create overlay.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Provision a fleet agent."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Provision a fleet agent.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent_id": {"description": "Agent uuid string", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "agent_spec": {"description": "Persisted AgentSpec payload", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "agent_uuid": {"description": "Agent uuid string", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "uuid": {"description": "New agent row uuid (same as agent_id / agent_uuid)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.get", "agents.update"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["agents.delete"], "safe_action": "agents_create", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a new agent row (draft AgentSpec).", "title": "Agents Create", "verification": ["agents.get", "agents.list"], "verify": [{"action": "agents.get", "predicate": "named resource is visible"}, {"action": "agents.list", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be created under an open sandbox head without diff-child bootstrap (AA-10b). Fork generation env or clear head; then use scoped create overlay.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Provision a fleet agent.", "write_mode": null}, {"action": "agents.update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Sending a partial agent_spec without section or path_updates — that replaces the whole spec.", "anti_patterns": ["Sending a partial agent_spec without section or path_updates — that replaces the whole spec.", "Passing write_mode=merge with a partial agent_spec (use section or path_updates).", "Setting state to active — the lifecycle has no such value; use ready or live.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.update", "mutation_risk": "low", "related_tools": ["agents.get", "agents.run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Update", "when_blocked": {"content_shrink_blocked": "Refusing a truncated string leaf.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "unified_diff did not apply to that string leaf.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "replacement_not_found": "find is not in that agent_spec string leaf.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "use_path_updates": "write_mode=merge requires section or path_updates"}, "when_to_use": "Persist one section or leaf. Merge keeps sibling fields. Workflow, reactions, and schedule compile because the write uses update_agent_spec. Bind generation_env_uuid (or rely on MCP sandbox head). Pos"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.update", "mutation_risk": "low", "related_tools": ["agents.get", "agents.run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Update", "when_blocked": {"content_shrink_blocked": "Refusing a truncated string leaf.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "unified_diff did not apply to that string leaf.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "replacement_not_found": "find is not in that agent_spec string leaf.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "use_path_updates": "write_mode=merge requires section or path_updates"}, "when_to_use": "Persist one section or leaf. Merge keeps sibling fields. Workflow, reactions, and schedule compile because the write uses update_agent_spec. Bind generation_env_uuid (or rely on MCP sandbox head). Pos"}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Persist one section or leaf. Merge keeps sibling fields. Workflow, reactions, and schedule compile …", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.get", "agents.run"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_update", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Update an agent. `section`+`section_value` or `path_updates` load the current AgentSpec, merge objects (lists replace), validate, then `update_agent_spec` (Logic sync for workflow, reactions, schedule", "title": "Agents Update", "when_blocked": {"content_shrink_blocked": "Refusing a truncated string leaf.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "unified_diff did not apply to that string leaf.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "replacement_not_found": "find is not in that agent_spec string leaf.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "use_path_updates": "write_mode=merge requires section or path_updates"}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Persist one section or leaf. Merge keeps sibling fields. Workflow, reactions, and schedule compile because the write uses update_agent_spec. Bind generation_env_uuid (or rely on MCP sandbox head). Pos", "write_mode": ["patch", "merge", "replace", "write"], "write_mode_note": "section and path_updates default to merge (objects merge, lists replace). write_mode=replace sets the section or leaf wholesale. A full agent_spec without section/path_updates is a replace. write_mode=merge with only a partial agent_spec is rejected."}, {"action": "agents.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.delete", "mutation_risk": "low", "related_tools": ["agents.list", "agents.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be deleted/archived under an open sandbox head. Use diff-child tombstone (AA-11b) or clear generation env.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove an agent from the fleet."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.delete", "mutation_risk": "low", "related_tools": ["agents.list", "agents.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be deleted/archived under an open sandbox head. Use diff-child tombstone (AA-11b) or clear generation env.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove an agent from the fleet."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Remove an agent from the fleet.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deleted": {"description": "True when the agent row and fleet index entry were removed", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.list", "agents.get"], "required_cap": "agents_admin", "requires_preflight": true, "risk_class": "destructive", "rollback": [], "safe_action": "agents_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete an agent row.", "title": "Agents Delete", "verification": ["agents.list"], "verify": [{"action": "agents.list", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be deleted/archived under an open sandbox head. Use diff-child tombstone (AA-11b) or clear generation env.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Remove an agent from the fleet.", "write_mode": null}, {"action": "agents.provider_preflight", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not treat provider_preflight as a billed LLM completion — no energy debit.", "anti_patterns": ["Do not treat provider_preflight as a billed LLM completion — no energy debit.", "Do not skip force_probe when quota is unknown and a live check is required.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1", "core.economy.llm_energy.gen1"], "id": "agents.provider_preflight", "related_tools": ["ai.providers.probe", "ai.providers.connect", "ai.providers.list", "agents.run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Provider Preflight", "when_blocked": {"agent_not_found": "Unknown agent_id; omit agent_id to probe orchestrator", "auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_missing": "No BYOK for provider — ai.providers.connect with api_key (ecosystem or project). Next: ai.providers.connect.", "not_found": "Agent spec missing — reconcile orchestrator binding", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "probe_failed": "Credential/quota probe failed — reconnect key or pick another provider. Next: ai.providers.connect.", "provider_quota_exceeded": "Upstream quota/rate limit — wait, switch provider, or check energy.get_balance. Next: energy.get_balance.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "when_to_use": "Before agents.run or agents.orchestrate when AgentSpec.llm.preflight_required is set. Live probe when required or force_probe=true; else metadata_only (no energy debit)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1", "core.economy.llm_energy.gen1"], "id": "agents.provider_preflight", "related_tools": ["ai.providers.probe", "ai.providers.connect", "ai.providers.list", "agents.run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Provider Preflight", "when_blocked": {"agent_not_found": "Unknown agent_id; omit agent_id to probe orchestrator", "auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_missing": "No BYOK for provider — ai.providers.connect with api_key (ecosystem or project). Next: ai.providers.connect.", "not_found": "Agent spec missing — reconcile orchestrator binding", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "probe_failed": "Credential/quota probe failed — reconnect key or pick another provider. Next: ai.providers.connect.", "provider_quota_exceeded": "Upstream quota/rate limit — wait, switch provider, or check energy.get_balance. Next: energy.get_balance.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "when_to_use": "Before agents.run or agents.orchestrate when AgentSpec.llm.preflight_required is set. Live probe when required or force_probe=true; else metadata_only (no energy debit)."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "errors": {"agent_not_found": "Unknown agent_id; omit agent_id to probe orchestrator", "auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "project_id required", "key_missing": "No BYOK for provider — ai.providers.connect with api_key (ecosystem or project). Next: ai.providers.connect.", "not_found": "Agent spec missing — reconcile orchestrator binding", "probe_failed": "Credential/quota probe failed — reconnect key or pick another provider. Next: ai.providers.connect.", "provider_quota_exceeded": "Upstream quota/rate limit — wait, switch provider, or check energy.get_balance. Next: energy.get_balance.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "examples": [{"agent_id": "<uuid>", "force_probe": false, "project_id": 1}, {"force_probe": true, "project_id": 1}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1", "core.llm.partner_providers.gen1", "core.economy.llm_energy.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Before agents.run or agents.orchestrate when AgentSpec.llm.preflight_required is set. Live probe wh…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["ai.providers.probe", "ai.providers.connect", "energy.get_balance", "agents.run"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["ai.providers.probe", "ai.providers.connect", "ai.providers.list", "agents.run"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_provider_preflight", "semantic_input_mode": "inherit_workflow", "summary": "Read-only LLM provider snapshot for an agent before enqueue (quota hints, fallbacks).", "title": "Agents Provider Preflight", "when_blocked": {"agent_not_found": "Unknown agent_id; omit agent_id to probe orchestrator", "auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_missing": "No BYOK for provider — ai.providers.connect with api_key (ecosystem or project). Next: ai.providers.connect.", "not_found": "Agent spec missing — reconcile orchestrator binding", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "probe_failed": "Credential/quota probe failed — reconnect key or pick another provider. Next: ai.providers.connect.", "provider_quota_exceeded": "Upstream quota/rate limit — wait, switch provider, or check energy.get_balance. Next: energy.get_balance.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "when_to_use": "Before agents.run or agents.orchestrate when AgentSpec.llm.preflight_required is set. Live probe when required or force_probe=true; else metadata_only (no energy debit).", "write_mode": null}, {"action": "agents.orchestrate", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not use for business.assistant.setup — execute mcp_tenant_business_assistant_v1 (see WORK_GRAPH_TOOL_WHEN[business.assistant.setup]).", "anti_patterns": ["Do not use for business.assistant.setup — execute mcp_tenant_business_assistant_v1 (see WORK_GRAPH_TOOL_WHEN[business.as", "Do not treat data.error_code chat_limit_reached or chat_ai_limit as orchestrate_failed — tune ai.chat.settings (limits, ", "Do not bypass daily cap with on_limit=fallback — fallback provider does not skip messages_per_user_day."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "heavy_llm", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"wait": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.orchestrate", "mutates_when": {"wait": true}, "mutation_risk": "low", "related_tools": ["projects.orchestrator.get", "projects.orchestrator.patch", "agents.work_next", "agents.run_get", "agents.traces", "agents.reconcile_binding"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Orchestrate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Project operator via resolve_and_run — channel workspace|messenger|bot|mcp|api (default mcp). home=project|self|project_self; env_uuid only with home=project (sandbox slice never auto-provisions). wai"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "heavy_llm", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"wait": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.orchestrate", "mutates_when": {"wait": true}, "mutation_risk": "low", "related_tools": ["projects.orchestrator.get", "projects.orchestrator.patch", "agents.work_next", "agents.run_get", "agents.traces", "agents.reconcile_binding"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Orchestrate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Project operator via resolve_and_run — channel workspace|messenger|bot|mcp|api (default mcp). home=project|self|project_self; env_uuid only with home=project (sandbox slice never auto-provisions). wai"}, "do_not_use_when": "Do not use for business.assistant.setup — execute mcp_tenant_business_assistant_v1 (see WORK_GRAPH_TOOL_WHEN[business.assistant.setup]).", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "wait=true (default on some clients) counts as one heavy_llm sync step — use wait=false + agents.run_get or options.async=true + discovery.job_status", "effect_depends_on_params": true, "execution_class": "heavy", "generation": false, "kind": "mutate", "mutates_when": {"wait": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Project operator via resolve_and_run — channel workspace|messenger|bot|mcp|api (default mcp). home=…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.work_next", "agents.run_get", "agents.reconcile_binding", "projects.orchestrator.get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["projects.orchestrator.get", "projects.orchestrator.patch", "agents.work_next", "agents.run_get", "agents.traces", "agents.reconcile_binding"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_orchestrate", "semantic_input_mode": "inherit_workflow", "summary": "Run the project AI orchestrator for a channel (workspace|messenger|bot|mcp|api).", "title": "Agents Orchestrate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not use for business.assistant.setup — execute mcp_tenant_business_assistant_v1 (see WORK_GRAPH_TOOL_WHEN[business.assistant.setup]).", "when_to_use": "Project operator via resolve_and_run — channel workspace|messenger|bot|mcp|api (default mcp). home=project|self|project_self; env_uuid only with home=project (sandbox slice never auto-provisions). wai", "write_mode": null}, {"action": "agents.run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "async_execute": {"enable": "options.async=true", "poll_action": "discovery.job_status", "poll_rest": "GET /mcp/jobs/{job_id}", "single_heavy_lane_ms": 180000, "sync_lane_ms": 120000}, "budget_note": "wait=false (default) enqueues without holding the sync batch; poll agents.run_get or GET /api/projects/{project_id}/agents/{agent_id}/runs/{run_id}. wait=true counts as heavy_llm (ai_stream, max wait_timeout_s 30) — one per sync execute; long work: options.async=true then discovery.job_status.", "cancel_action": "agents.stop", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "heavy_llm", "budget_note": "wait=false (default) enqueues without holding the sync batch; poll agents.run_get or GET /api/projects/{project_id}/agents/{agent_id}/runs/{run_id}. wait=true counts as heavy_llm (ai_stream, max wait_timeout_s 30) — one per sync execute; long work: options.async=true then discovery.job_status.", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"wait": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.mcp.agents.gen1", "core.economy.llm_energy.gen1"], "id": "agents.run", "mutates_when": {"wait": true}, "mutation_risk": "low", "related_tools": ["agents.run_get", "agents.provider_preflight", "energy.get_balance", "ai.providers.probe", "agents.approve_run", "agents.traces", "storage.upload"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Run", "when_blocked": {"agent_daily_cap": "Agent per_day_cap reached — raise cap in AgentSpec energy budget or wait UTC day", "agent_not_found": "Unknown agent_id in this project", "attachment_validation_failed": "Fix output.attachments[] (kind + storage_file_id or https url) before commit", "channel_media_unsupported": "Channel or attachment shape cannot send that media — check bots.health caps", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "energy_denied": "Insufficient builder_energy — energy.get_balance then payments.create intent=energy_pack (subscription pool via buffs); BYOK: ai.providers.list + project AI keys; not AGNT demo rail", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "idempotency_key_too_short": "idempotency_key must be at least 8 characters", "insufficient_energy": "Pool reserve peek failed — energy.get_balance; top up or lower per_run_estimate", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "provider_preflight_blocked": "LLM preflight blocked enqueue — agents.provider_preflight, ai.providers.probe, ai.providers.connect, energy.get_balance", "provider_quota_exceeded": "Provider quota — use agents.provider_preflight or avoid wait=true in cert batches", "run_failed": "agents.work_next detail=compact — inspect run traces; repair_plan or reclaim before retry", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_file_not_found": "Outbound attachment storage_file_id missing — REST storage.upload to bots__outbound first", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "waiting_for_approval": "Poll agents.run_get then agents.approve_run"}, "when_to_use": "Execute agent with policy caps; poll via agents.run_get (not discovery.job_status). Energy: peek energy.get_balance before run (no hold); each LLM step debits builder_energy (platform_supply). When Ag"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "heavy_llm", "budget_note": "wait=false (default) enqueues without holding the sync batch; poll agents.run_get or GET /api/projects/{project_id}/agents/{agent_id}/runs/{run_id}. wait=true counts as heavy_llm (ai_stream, max wait_timeout_s 30) — one per sync execute; long work: options.async=true then discovery.job_status.", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"wait": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.mcp.agents.gen1", "core.economy.llm_energy.gen1"], "id": "agents.run", "mutates_when": {"wait": true}, "mutation_risk": "low", "related_tools": ["agents.run_get", "agents.provider_preflight", "energy.get_balance", "ai.providers.probe", "agents.approve_run", "agents.traces", "storage.upload"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Run", "when_blocked": {"agent_daily_cap": "Agent per_day_cap reached — raise cap in AgentSpec energy budget or wait UTC day", "agent_not_found": "Unknown agent_id in this project", "attachment_validation_failed": "Fix output.attachments[] (kind + storage_file_id or https url) before commit", "channel_media_unsupported": "Channel or attachment shape cannot send that media — check bots.health caps", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "energy_denied": "Insufficient builder_energy — energy.get_balance then payments.create intent=energy_pack (subscription pool via buffs); BYOK: ai.providers.list + project AI keys; not AGNT demo rail", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "idempotency_key_too_short": "idempotency_key must be at least 8 characters", "insufficient_energy": "Pool reserve peek failed — energy.get_balance; top up or lower per_run_estimate", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "provider_preflight_blocked": "LLM preflight blocked enqueue — agents.provider_preflight, ai.providers.probe, ai.providers.connect, energy.get_balance", "provider_quota_exceeded": "Provider quota — use agents.provider_preflight or avoid wait=true in cert batches", "run_failed": "agents.work_next detail=compact — inspect run traces; repair_plan or reclaim before retry", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_file_not_found": "Outbound attachment storage_file_id missing — REST storage.upload to bots__outbound first", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "waiting_for_approval": "Poll agents.run_get then agents.approve_run"}, "when_to_use": "Execute agent with policy caps; poll via agents.run_get (not discovery.job_status). Energy: peek energy.get_balance before run (no hold); each LLM step debits builder_energy (platform_supply). When Ag"}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "budget_note": "wait=false (default) enqueues without holding the sync batch; poll agents.run_get or GET /api/projects/{project_id}/agents/{agent_id}/runs/{run_id}. wait=true counts as heavy_llm (ai_stream, max wait_timeout_s 30) — one per sync execute; long work: options.async=true then discovery.job_status.", "conditional_mutate": "wait=true holds ai_stream up to wait_timeout_s (max 30) — one heavy_llm per sync batch. wait=false enqueues; poll agents.run_get or GET /api/projects/{project_id}/agents/{agent_id}/runs/{run_id}. Long suites: options.async=true + discovery.job_status.", "effect_depends_on_params": true, "execution_class": "heavy", "generation": false, "kind": "mutate", "mutates_when": {"wait": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Enqueue then poll", "request": {"params": {"agent_id": "<uuid>", "message": "Summarize fleet health", "project_id": 1, "wait": false}, "tool": "agents.run"}, "response": {"data": {"run_succeeded": null, "run_uuid": "<uuid>"}, "success": true}}, {"name": "Plan-focus on personal leaf", "request": {"params": {"agent_id": "<uuid>", "home": "project_self", "input": {"focus_node_id": "task-a", "message": "Execute leaf"}, "project_id": 1, "wait": false}, "tool": "agents.run"}, "response": {"data": {"run_succeeded": null, "run_uuid": "<uuid>"}, "success": true}}], "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Execute agent with policy caps; poll via agents.run_get (not discovery.job_status). Energy: peek en…", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": [{"action": "agents.run_get", "note": "Poll terminal status; do not re-run agents.run to check progress.", "params": {"run_id": "<run_uuid from agents.run>"}}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"run": {"description": "Run detail object when wait=true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "run.agent_run_spec.error": {"description": "User-visible failure when status is failed/cancelled", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "run.agent_run_spec.output.message": {"description": "Primary assistant text when wait=true and status is terminal completed or waiting_for_approval (also output.text / output.summary)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "run_status": {"description": "Present when wait=true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "run_succeeded": {"description": "When wait=true — whether terminal status succeeded", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "run_uuid": {"description": "Fleet run uuid for polling agents.run_get", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "state": {"description": "Receipt state (default pending) — not run status", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "work_item_id": {"description": "Durable queue work item id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.run_get", "agents.provider_preflight", "energy.get_balance", "ai.providers.probe", "agents.approve_run", "agents.traces", "storage.upload", "bots.conversations"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "agents_run", "semantic_input_mode": "inherit_workflow", "summary": "Enqueue an agent run (durable work queue). instruction_slice and recovery_hint use context.locale / instruction_locale.", "title": "Agents Run", "verification": ["agents.run_get", "agents.list"], "verify": [{"action": "agents.run_get", "predicate": "named resource is visible"}, {"action": "agents.list", "predicate": "named resource is visible"}], "when_blocked": {"agent_daily_cap": "Agent per_day_cap reached — raise cap in AgentSpec energy budget or wait UTC day", "agent_not_found": "Unknown agent_id in this project", "attachment_validation_failed": "Fix output.attachments[] (kind + storage_file_id or https url) before commit", "channel_media_unsupported": "Channel or attachment shape cannot send that media — check bots.health caps", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "energy_denied": "Insufficient builder_energy — energy.get_balance then payments.create intent=energy_pack (subscription pool via buffs); BYOK: ai.providers.list + project AI keys; not AGNT demo rail", "env_uuid_project_only": "env_uuid is only valid for home=project on plan-focus runs", "graph_home_unknown": "home must be project, self, or project_self", "idempotency_key_too_short": "idempotency_key must be at least 8 characters", "insufficient_energy": "Pool reserve peek failed — energy.get_balance; top up or lower per_run_estimate", "invalid_parameters": "project_id and agent_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "agents_run capability required", "provider_preflight_blocked": "LLM preflight blocked enqueue — agents.provider_preflight, ai.providers.probe, ai.providers.connect, energy.get_balance", "provider_quota_exceeded": "Provider quota — use agents.provider_preflight or avoid wait=true in cert batches", "run_failed": "agents.work_next detail=compact — inspect run traces; repair_plan or reclaim before retry", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_file_not_found": "Outbound attachment storage_file_id missing — REST storage.upload to bots__outbound first", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "waiting_for_approval": "Poll agents.run_get then agents.approve_run"}, "when_to_use": "Execute agent with policy caps; poll via agents.run_get (not discovery.job_status). Energy: peek energy.get_balance before run (no hold); each LLM step debits builder_energy (platform_supply). When Ag", "write_mode": null}, {"action": "agents.run_with_agnt_credits", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.run_with_agnt_credits", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Run With Agnt Credits", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Autonomous demo: fund runtime energy from AGNT ledger credits, then start a Fleet run. For JSON wallet balances or fiat-first deploys use wallets.* / payments — not this demo path."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.run_with_agnt_credits", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Run With Agnt Credits", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Autonomous demo: fund runtime energy from AGNT ledger credits, then start a Fleet run. For JSON wallet balances or fiat-first deploys use wallets.* / payments — not this demo path."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Quote-bound demo run", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "credits_atomic": 1000, "idempotency_key": "demo-run-001", "input": {"message": "Hello"}, "project_id": 1, "quote_hash": "hash-demo", "quote_id": "quote-demo"}, "tool": "agents.run_with_agnt_credits"}, "response": {"data": {"purchase": {}, "run": {}, "success": true}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Autonomous demo: fund runtime energy from AGNT ledger credits, then start a Fleet run. For JSON wal…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_run_with_agnt_credits", "semantic_input_mode": "inherit_workflow", "summary": "Demo orchestration: purchase compute credits (AGNT ledger) then enqueue an agent run.", "title": "Agents Run With Agnt Credits", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Autonomous demo: fund runtime energy from AGNT ledger credits, then start a Fleet run. For JSON wallet balances or fiat-first deploys use wallets.* / payments — not this demo path.", "write_mode": null}, {"action": "agents.fork", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Forking without env_uuid on an open generation head when editing fleet in sandbox.", "anti_patterns": ["Forking without env_uuid on an open generation head when editing fleet in sandbox.", "Passing env_uuid when home is project_self or self.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.fork", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Fork", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create a draft child generation for experimentation. Under home=project + env_uuid, fork materializes a sandbox diff-child row (not prod INSERT); then generation.diff_vs_prod → promote."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.fork", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Fork", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create a draft child generation for experimentation. Under home=project + env_uuid, fork materializes a sandbox diff-child row (not prod INSERT); then generation.diff_vs_prod → promote."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Draft generation", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "project_id": 1}, "tool": "agents.fork"}, "response": {"data": {"agent_spec": {}, "uuid": "00000000-0000-4000-8000-000000000002"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Create a draft child generation for experimentation. Under home=project + env_uuid, fork materializ…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_fork", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Fork an agent to a new generation (DNA row).", "title": "Agents Fork", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Create a draft child generation for experimentation. Under home=project + env_uuid, fork materializes a sandbox diff-child row (not prod INSERT); then generation.diff_vs_prod → promote.", "write_mode": null}, {"action": "agents.stop", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.stop", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Stop", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Stop an in-flight run from automation or ops."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.stop", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Stop", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Stop an in-flight run from automation or ops."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Cancel run", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "project_id": 1, "run_id": "00000000-0000-4000-8000-000000000002"}, "tool": "agents.stop"}, "response": {"data": {"stopped": true}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Stop an in-flight run from automation or ops.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_stop", "semantic_input_mode": "inherit_workflow", "summary": "Cancel a running / queued agent run.", "title": "Agents Stop", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Stop an in-flight run from automation or ops.", "write_mode": null}, {"action": "agents.kill", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.kill", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Kill", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Emergency stop for a misbehaving agent."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.kill", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Kill", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Emergency stop for a misbehaving agent."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "examples": [{"name": "Kill agent", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "project_id": 1}, "tool": "agents.kill"}, "response": {"data": {"agent_spec": {}, "uuid": "00000000-0000-4000-8000-000000000001"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Emergency stop for a misbehaving agent.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "agents_kill", "semantic_input_mode": "inherit_workflow", "summary": "Set agent lifecycle state to killed (hard stop for new runs).", "title": "Agents Kill", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Emergency stop for a misbehaving agent.", "write_mode": null}, {"action": "agents.promote", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.promote", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Promote", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After soak / canary, attempt promotion."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.promote", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Promote", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After soak / canary, attempt promotion."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Auto-promotion gates", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "project_id": 1}, "tool": "agents.promote"}, "response": {"data": {"gates": [], "success": true}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "After soak / canary, attempt promotion.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_promote", "semantic_input_mode": "inherit_workflow", "summary": "Run auto-promotion gates; may set state to live when metrics pass.", "title": "Agents Promote", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "After soak / canary, attempt promotion.", "write_mode": null}, {"action": "agents.rollout_advance", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.rollout_advance", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Rollout Advance", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Progressive traffic shift for agent versions."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.rollout_advance", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Rollout Advance", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Progressive traffic shift for agent versions."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Advance canary step", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "project_id": 1}, "tool": "agents.rollout_advance"}, "response": {"data": {"agent_spec": {}, "uuid": "00000000-0000-4000-8000-000000000001"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Progressive traffic shift for agent versions.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_rollout_advance", "semantic_input_mode": "inherit_workflow", "summary": "Advance canary rollout step (5→20→50→100).", "title": "Agents Rollout Advance", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Progressive traffic shift for agent versions.", "write_mode": null}, {"action": "agents.metrics", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.metrics", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Metrics", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Diagnostics and dashboards (rollup is prod-plane; home/env scope agent access). Agent row existence respects X-AgentStack-Env / env_uuid (sandbox overlay). Metrics rollup and promotion gate evaluation"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.metrics", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Metrics", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Diagnostics and dashboards (rollup is prod-plane; home/env scope agent access). Agent row existence respects X-AgentStack-Env / env_uuid (sandbox overlay). Metrics rollup and promotion gate evaluation"}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Rollup snapshot", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "project_id": 1}, "tool": "agents.metrics"}, "response": {"data": {"metrics": {}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Diagnostics and dashboards (rollup is prod-plane; home/env scope agent access). Agent row existence…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_metrics", "semantic_input_mode": "inherit_workflow", "summary": "Read rollup metrics for an agent (ecosystem.agents_metrics).", "title": "Agents Metrics", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Diagnostics and dashboards (rollup is prod-plane; home/env scope agent access). Agent row existence respects X-AgentStack-Env / env_uuid (sandbox overlay). Metrics rollup and promotion gate evaluation", "write_mode": null}, {"action": "agents.gates", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.gates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Gates", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pre-promotion verification (metrics gates use prod rollup; agent row respects env_uuid). Agent row existence respects X-AgentStack-Env / env_uuid (sandbox overlay). Metrics rollup and promotion gate e"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.gates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Gates", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pre-promotion verification (metrics gates use prod rollup; agent row respects env_uuid). Agent row existence respects X-AgentStack-Env / env_uuid (sandbox overlay). Metrics rollup and promotion gate e"}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "examples": [{"name": "Pre-promotion gates", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "project_id": 1}, "tool": "agents.gates"}, "response": {"data": {"all_passed": false, "gates": []}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Pre-promotion verification (metrics gates use prod rollup; agent row respects env_uuid). Agent row …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_gates", "semantic_input_mode": "inherit_workflow", "summary": "Evaluate promotion gates for an agent.", "title": "Agents Gates", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pre-promotion verification (metrics gates use prod rollup; agent row respects env_uuid). Agent row existence respects X-AgentStack-Env / env_uuid (sandbox overlay). Metrics rollup and promotion gate e", "write_mode": null}, {"action": "agents.traces", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.traces", "related_tools": ["agents.run_get", "agents.approve_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Traces", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Debug slice of spec.events. Prefer agents.run_get for cockpit timeline (same SoT)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.traces", "related_tools": ["agents.run_get", "agents.approve_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Traces", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Debug slice of spec.events. Prefer agents.run_get for cockpit timeline (same SoT)."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Debug slice of spec.events. Prefer agents.run_get for cockpit timeline (same SoT).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.run_get", "agents.approve_run"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_traces", "semantic_input_mode": "inherit_workflow", "summary": "Return stored run events (trace buffer) for a run.", "title": "Agents Traces", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Debug slice of spec.events. Prefer agents.run_get for cockpit timeline (same SoT).", "write_mode": null}, {"action": "agents.timeline", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.timeline", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Timeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect execution history before approve or debug."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.timeline", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Timeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect execution history before approve or debug."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Recent runs", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "limit": 20, "project_id": 1}, "tool": "agents.timeline"}, "response": {"data": {"runs": []}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Inspect execution history before approve or debug.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_timeline", "semantic_input_mode": "inherit_workflow", "summary": "List recent runs for an agent (uuid + status + timestamps).", "title": "Agents Timeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect execution history before approve or debug.", "write_mode": null}, {"action": "agents.version_timeline", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.version_timeline", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Version Timeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect fork/promote lineage before rollout or rollback."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.version_timeline", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Version Timeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect fork/promote lineage before rollout or rollback."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Generation lineage", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "project_id": 1}, "tool": "agents.version_timeline"}, "response": {"data": {"versions": []}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Inspect fork/promote lineage before rollout or rollback.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_version_timeline", "semantic_input_mode": "inherit_workflow", "summary": "List agent version lineage (generation tree — REST GET /timeline parity).", "title": "Agents Version Timeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect fork/promote lineage before rollout or rollback.", "write_mode": null}, {"action": "agents.list_pending_approvals", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.list_pending_approvals", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents List Pending Approvals", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator queue before calling agents.approve_run with artifact hash."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.list_pending_approvals", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents List Pending Approvals", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator queue before calling agents.approve_run with artifact hash."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Operator queue before calling agents.approve_run with artifact hash.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_list_pending_approvals", "semantic_input_mode": "inherit_workflow", "summary": "List runs waiting for approval across project or personal agent scope.", "title": "Agents List Pending Approvals", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator queue before calling agents.approve_run with artifact hash.", "write_mode": null}, {"action": "agents.runs_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not omit agent_id when debugging one agent — pass agent_id from work_next / ensure_agent.", "anti_patterns": ["Do not omit agent_id when debugging one agent — pass agent_id from work_next / ensure_agent.", "Do not use runs_list as the work loop — agents.work_next + packet.next_action.", "Do not expect full event traces — uuid/status only; agents.run_get for bodies.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.runs_list", "related_tools": ["agents.run_get", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Runs List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Per-agent history when agent_id is set. Omit agent_id for project-wide skim (scope=project; each row includes agent_id; default ≤25 runs per agent via SQL window). Event bodies: agents.run_get. Queue/"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.runs_list", "related_tools": ["agents.run_get", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Runs List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Per-agent history when agent_id is set. Omit agent_id for project-wide skim (scope=project; each row includes agent_id; default ≤25 runs per agent via SQL window). Event bodies: agents.run_get. Queue/"}, "do_not_use_when": "Do not omit agent_id when debugging one agent — pass agent_id from work_next / ensure_agent.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Per-agent history when agent_id is set. Omit agent_id for project-wide skim (scope=project; each ro…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.run_get", "agents.work_next"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.run_get", "agents.work_next"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_runs_list", "semantic_input_mode": "inherit_workflow", "summary": "Rows are uuid, status, event_count, and timestamps. Event bodies stay on agents.run_get. Status and the event count are read in SQL.", "title": "Agents Runs List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not omit agent_id when debugging one agent — pass agent_id from work_next / ensure_agent.", "when_to_use": "Per-agent history when agent_id is set. Omit agent_id for project-wide skim (scope=project; each row includes agent_id; default ≤25 runs per agent via SQL window). Event bodies: agents.run_get. Queue/", "write_mode": null}, {"action": "agents.plan_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not scan full task_list when agents.work_next suffices for next-leaf selection.", "anti_patterns": ["Do not scan full task_list when agents.work_next suffices for next-leaf selection.", "Prefer detail=cards + node_id/max_depth; detail=full is bodies inside the slice only.", "Without node_id, cards/body/full default limit=50; wide body/full downgrades to cards."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_get", "related_tools": ["agents.work_next", "agents.plan_patch", "agents.plan_claim", "agents.graph_file_put", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Plan Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_detail": "detail/projection/limit validation — see problem.field in error payload", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "join_not_allowed": "Project is not open-join — request invite or projects.add_user from an owner.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "membership_required": "Open community hub: call projects.join on context.project_id, then agents.work_next with home=project_self (recipe mcp_community_hub_v1).", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "personal_home_agent_scope_conflict": "Use home=project with scope=agent for an agent private plan leaf, or use home=self|project_self without scope=agent for the session graph.", "plan_focus_invalid": "agents.work_next detail=compact — refresh focus_node_id from packet next_action", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "plan_slice_failed": "Narrow node_id, use projection=summary, or lower max_depth — slice could not be built", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wire_budget_exceeded": "Slice too large — narrow node_id, max_depth, or use detail=cards (detail=body|full past wire budget)"}, "when_to_use": "Follow packet.next_action. Default detail=compact (flat rows + revision; no task tree). Prod matrix and deploy smoke use compact + limit≤32 for eligibility/metrics probes — not detail=full. Use detail"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_get", "related_tools": ["agents.work_next", "agents.plan_patch", "agents.plan_claim", "agents.graph_file_put", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Plan Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_detail": "detail/projection/limit validation — see problem.field in error payload", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "join_not_allowed": "Project is not open-join — request invite or projects.add_user from an owner.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "membership_required": "Open community hub: call projects.join on context.project_id, then agents.work_next with home=project_self (recipe mcp_community_hub_v1).", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "personal_home_agent_scope_conflict": "Use home=project with scope=agent for an agent private plan leaf, or use home=self|project_self without scope=agent for the session graph.", "plan_focus_invalid": "agents.work_next detail=compact — refresh focus_node_id from packet next_action", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "plan_slice_failed": "Narrow node_id, use projection=summary, or lower max_depth — slice could not be built", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wire_budget_exceeded": "Slice too large — narrow node_id, max_depth, or use detail=cards (detail=body|full past wire budget)"}, "when_to_use": "Follow packet.next_action. Default detail=compact (flat rows + revision; no task tree). Prod matrix and deploy smoke use compact + limit≤32 for eligibility/metrics probes — not detail=full. Use detail"}, "do_not_use_when": "Do not scan full task_list when agents.work_next suffices for next-leaf selection.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Default loop: metrics + revision only — no full graph or fleet scan.", "name": "Compact revision poll (hot path)", "request": {"params": {"detail": "compact", "limit": 32, "project_id": 1}, "tool": "agents.plan_get"}, "response": {"data": {"metrics": {"dependency_ready_leaves": 2, "revision": 12}, "scope": "project"}, "success": true}}, {"description": "Hydrate nodes from task_list.cold_pages or archive without opening the full graph.", "name": "Cold page slice", "request": {"params": {"detail": "cards", "limit": 32, "page_id": "0123456789abcdef", "project_id": 1}, "tool": "agents.plan_get"}, "response": {"data": {"scope": "project", "shape": {"page_slice": true}}, "success": true}}, {"description": "env_uuid reads the same generation slice as plan_patch/propose. Use detail=compact and node_id + max_depth when scoping eligibility.", "name": "Sandbox read with execution eligibility", "request": {"params": {"detail": "compact", "env_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "include_execution_eligibility": true, "max_depth": 1, "node_id": "task-a", "project_id": 1}, "tool": "agents.plan_get"}, "response": {"data": {"execution_eligibility": {"dependency_ready_count": 2, "execution_ready_count": 1, "leaves": [{"dependency_ready": true, "execution_ready": true, "id": "task-a", "resolution": "existing_agent"}, {"blocked_reason": "no_compatible_agent", "dependency_ready": true, "execution_ready": false, "id": "task-b"}]}, "metrics": {"dependency_ready_leaves": 2, "execution_ready_leaves": 1, "revision": 12}, "scope": "project"}, "success": true}}], "execution_class": "plain_read", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Follow packet.next_action. Default detail=compact (flat rows + revision; no task tree). Prod matrix…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.work_next", "agents.plan_claim"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent_id": {"description": "Present when scope=agent", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "analytics": {"description": "critical_path + unblock_top when include_analytics", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "archived": {"description": "Archived nodes when include_archived=true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "catalog_page": {"description": "Paged catalog slice when expand_catalog", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "content_hash": {"description": "plan_content_hash (persisted on write; canonical walk if unset) for if_match_revision", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "counters": {"description": "Rollup counters when include=counters", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "execution_eligibility": {"description": "dependency_ready vs execution_ready leaves", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "focus_affinities": {"description": "When include_affinities and focus node exists", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "generation_pending": {"description": "When include_generation_pending — open fork + agent_context diff vs prod (no env_uuid)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "graph_limits": {"description": "node_count, node_limit, bytes_estimate, jsonb_inline_byte_limit, advisories, chunk_spill_*", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "hint": {"description": "Operator hint when graph is empty or filtered", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "home": {"description": "home=project|self|project_self projection anchor", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "linked_node": {"description": "Attachment metadata when focus_ref is set. scope_agent when scope=agent.", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "metrics": {"description": "Scoped page metrics (node_count = slice; graph_node_count = full graph)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "plan_claim": {"description": "Claimable leaves when include_claimable", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "plan_metrics": {"description": "Full-graph fleet rollup", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "rest_surfaces": {"description": "GET /api/projects/{project_id}/orchestrator (+ GET …/plan/agent/{agent_id} for scope=agent)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "revision": {"description": "Top-level CAS revision (same as task_list.revision)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "sandbox_ops": {"description": "On agents.work_next compact — static next_action ladder for sandbox diff/gates/promote", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "scope": {"description": "project | agent", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "semantic_edges": {"description": "Rollup harness edges when include_diagnostics=true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "shape": {"description": "Slice metadata (page, filters, errors)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "task_list": {"description": "AgentTaskList dump; CAS stamp is task_list.revision", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "tasks_projected": {"description": "Nested children when projection=tree", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.work_next", "agents.plan_patch", "agents.plan_claim", "agents.graph_file_put", "preflight.check"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_plan_get", "semantic_input_mode": "inherit_workflow", "summary": "Read the Work Graph (8DNA ecosystem.orchestrator.task_list). Default compact slice (revision + flat rows); fleet rollup metrics are opt-in via include_metrics or expand=metrics. Same MCP execute batch", "title": "Get Plan Graph", "wave_xix_atoms": {"WG_CLAIM_PREVIEW_SINGLE": "plan_get include_claimable=true — each claim preview row.execution from one canonical execution-resolver pass (execution_resolver SoT).", "WG_CLOSED_LOOP_EXECUTABLE": "state=actionable (alias executable) and execution_ready — next_action agents.plan_claim with if_match_revision from plan_get.", "WG_CLOSED_LOOP_STALE_CLAIM": "blocked_reason=expired_claim — next_action agents.plan_reclaim_stale; beats downstream dependency_blocked when no executable leaf.", "WG_DEPENDENCY_VS_EXECUTION_READY": "dependency_ready is structural (deps/status/decomposition); execution_ready is fleet (live agent or provision path) — never collapse the two gates.", "WG_DISCOVERY_ROUTE": "Discovery naming: intent_id (taxonomy) ≠ primary_action (router verb) ≠ agents.work_next (fleet pick) — do not treat a route phrase as an MCP action name. discovery.describe requires param action=<catalog action id> (not optional).", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_EXECUTION_SUMMARY_ONLY": "Read execution_summary.missing_requirements — missing_roles is legacy; do not infer fleet gaps from validation.missing_roles when execution_summary is present."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_detail": "detail/projection/limit validation — see problem.field in error payload", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "join_not_allowed": "Project is not open-join — request invite or projects.add_user from an owner.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "membership_required": "Open community hub: call projects.join on context.project_id, then agents.work_next with home=project_self (recipe mcp_community_hub_v1).", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "personal_home_agent_scope_conflict": "Use home=project with scope=agent for an agent private plan leaf, or use home=self|project_self without scope=agent for the session graph.", "plan_focus_invalid": "agents.work_next detail=compact — refresh focus_node_id from packet next_action", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "plan_slice_failed": "Narrow node_id, use projection=summary, or lower max_depth — slice could not be built", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wire_budget_exceeded": "Slice too large — narrow node_id, max_depth, or use detail=cards (detail=body|full past wire budget)"}, "when_blocked_locales": {"invalid_parameters": {"en-US": "project_id and run_id required — agent_id optional when run_id is set", "pt-BR": "project_id e run_id obrigatórios — agent_id opcional com run_id", "ru-RU": "Нужны project_id и run_id — agent_id опционален при run_id"}, "permission_denied": {"en-US": "RBAC denied — rbac.check_permission, membership, or dev-operator persona", "pt-BR": "RBAC negado — rbac.check_permission, membership ou persona dev-operator", "ru-RU": "RBAC отказ — rbac.check_permission, членство или dev-operator persona"}, "plan_revision_conflict": {"en-US": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal", "pt-BR": "Conflito CAS — agents.plan_get recarregue if_match_revision; nunca apply proposal obsoleto", "ru-RU": "CAS конфликт — agents.plan_get перечитать if_match_revision; не apply устаревший proposal"}}, "when_not_to_use": "Do not scan full task_list when agents.work_next suffices for next-leaf selection.", "when_to_use": "Follow packet.next_action. Default detail=compact (flat rows + revision; no task tree). Prod matrix and deploy smoke use compact + limit≤32 for eligibility/metrics probes — not detail=full. Use detail", "write_mode": null}, {"action": "agents.plan_preview_affinities", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_preview_affinities", "related_tools": ["agents.plan_apply_affinities", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Preview Affinities", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only gene/skill affinity hints on plan nodes — no DNA pin. home=project|self|project_self; scope=agent forbidden on personal home."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_preview_affinities", "related_tools": ["agents.plan_apply_affinities", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Preview Affinities", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only gene/skill affinity hints on plan nodes — no DNA pin. home=project|self|project_self; scope=agent forbidden on personal home."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Read-only gene/skill affinity hints on plan nodes — no DNA pin. home=project|self|project_self; sco…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_apply_affinities", "agents.work_next"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_plan_preview_affinities", "semantic_input_mode": "inherit_workflow", "summary": "Preview suggested gene/skill hints on plan nodes (read-only, no DNA pin).", "title": "Agents Plan Preview Affinities", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only gene/skill affinity hints on plan nodes — no DNA pin. home=project|self|project_self; scope=agent forbidden on personal home.", "write_mode": null}, {"action": "agents.plan_apply_affinities", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_apply_affinities", "mutation_risk": "low", "related_tools": ["agents.plan_preview_affinities", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Apply Affinities", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pin skill_ids/gene_tags after preview. home=project|self|project_self; requires pin_skills and/or pin_genes; scope=agent needs home=project."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_apply_affinities", "mutation_risk": "low", "related_tools": ["agents.plan_preview_affinities", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Apply Affinities", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pin skill_ids/gene_tags after preview. home=project|self|project_self; requires pin_skills and/or pin_genes; scope=agent needs home=project."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Pin skill_ids/gene_tags after preview. home=project|self|project_self; requires pin_skills and/or p…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_preview_affinities", "agents.work_next"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_apply_affinities", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Pin affinity hints onto plan DNA. Pass pin_skills and/or pin_genes; at least one must be true. When scope is agent, pass agent_id.", "title": "Agents Plan Apply Affinities", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pin skill_ids/gene_tags after preview. home=project|self|project_self; requires pin_skills and/or pin_genes; scope=agent needs home=project.", "write_mode": null}, {"action": "agents.plan_refresh_affinities", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_refresh_affinities", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Refresh Affinities", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Legacy alias — prefer plan_preview_affinities / plan_apply_affinities."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_refresh_affinities", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Refresh Affinities", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Legacy alias — prefer plan_preview_affinities / plan_apply_affinities."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Legacy alias — prefer plan_preview_affinities / plan_apply_affinities.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_refresh_affinities", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Deprecated alias: use plan_preview_affinities or plan_apply_affinities.", "title": "Agents Plan Refresh Affinities", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Legacy alias — prefer plan_preview_affinities / plan_apply_affinities.", "write_mode": null}, {"action": "agents.plan_patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not set return_task_list=true — response is revision + changed[]; refresh via work_next compact.", "anti_patterns": ["Do not set return_task_list=true — response is revision + changed[]; refresh via work_next compact.", "Node blockers use op link + dependencies, not description/prompt text.", "Do not full-set long prompt/detail bodies — use patch_text search_replace."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_patch", "mutation_risk": "low", "related_tools": ["agents.plan_get", "agents.work_next", "agents.plan_propose", "agents.graph_file_put", "agents.graph_file_get"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Plan Patch", "when_blocked": {"ambiguous_anchor": "patch_text search_replace — longer find, set count, or graph_file_get text window", "archive_purge_required": "Read history with agents.plan_get include_archived=true, then send purge_archived=true on agents.plan_patch. Anything else leaves the archive.", "catalog_path_unsupported": "Point meta.external_list.path at a list, or at an object with items, rows, leads, or results, then retry expand_catalog on that same node id.", "content_shrink_blocked": "replace would shrink a plan text field — use search_replace or allow_shrink", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "execution_error": "Unexpected patch failure — inspect message and trace_id", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_address_required": "Personal home needs a resolved session address. Pass home on the tool and ensure the operator session has user_id before patch.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "import_pack_personal_home_unsupported": "Orchestrator import pack requires home=project; personal session graphs use export/read paths only.", "invalid_heal_mode": "mode must be auto|body_only|migrate_archive_pages|cold_pages|archive_pages|none — match graph_limits.heal_recommended_mode or discovery.describe agents.plan_heal_leaf.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "invalid_state_transition": "agents.plan_get node status — legal FSM only; completed↔cancelled retries are no-ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "unified_diff on patch_text did not apply — re-read plan_get", "patch_too_large": "unified_diff exceeds size cap on patch_text", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "personal_home_agent_scope_conflict": "Use home=project with scope=agent for an agent private plan leaf, or use home=self|project_self without scope=agent for the session graph.", "plan_claim_owner_conflict": "agents.work_next handoff=true — another operator holds the lease", "plan_completion_gates": "Completion predicates are not satisfied — finish child work, waive with meta.completion_waived only when policy allows, or agents.plan_propose repair.", "plan_dependency_cycle": "Dependency cycle detected — remove circular depends_on before patch.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_children_exceeded": "Direct children per parent are capped (32). Flat parent_id storage counts siblings under each parent_id — not total graph nodes. Split into sub-groups or use agents.plan_propose decompose_node.", "plan_graph_dep_cycle": "Dependency cycle detected — remove circular depends_on before patch.", "plan_graph_depth_exceeded": "Plan tree depth exceeded — decompose strategic nodes with agents.plan_propose before adding deeper leaves.", "plan_graph_duplicate_id": "Duplicate node id in patch — use unique ids or nodes_to_update instead of recreate.", "plan_graph_empty_overwrite_refused": "Replacing a non-empty plan with an empty graph is refused — call plan_get, then pass allow_empty_graph and empty_graph_confirmed only when you intend to wipe all nodes.", "plan_graph_load_failed": "DNA/graph slice failed to load — plan_get (compact) then retry. If patch used a long title (>256), use patch_text or shorten title; see validation_error + field=title instead of this code when preflight maps PGVE.", "plan_graph_node_count": "Open plan has more than 1000 nodes. Archive completed nodes with ops {op:archive,id}. Do not copy them into a parent meta.done_or_dropped. Read them back with agents.plan_get include_archived=true. Large lists belong on a catalog node, not as copies in the graph.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_graph_write_failed": "The graph leaf was not updated. Read agents.plan_get and retry the same ops with if_match_revision set to the current revision.", "plan_hierarchy_cycle": "parent_id hierarchy cycle — fix parent_id chain before patch.", "plan_invalid_transition": "Status transition is not allowed for this node kind — read agents.plan_get and use a valid status path (e.g. pending→ready→in_progress→completed).", "plan_ops_duplicate_id": "add_child node.id already exists — pick a new id or update with set/patch_text.", "plan_ops_meta_key": "set_meta needs key + value (one field per op). Wrong: {op:set_meta,id,meta:{k:v}}. Right: {op:set_meta,id,key:k,value:v} or op set with meta:{k:v}. Bulk meta on set_meta is accepted when meta is a flat object.", "plan_ops_move": "move needs id and parent_id (parent must exist). Same as set {id, parent_id}.", "plan_ops_noop": "set op had no fields besides id — send status, title, parent_id, or use op move.", "plan_ops_parent_missing": "add_child parent_id is not in the graph — create the parent first or fix parent_id. On an empty project graph (revision 0, no tasks), omit parent_id and send {op:add_child, node:{id, title, kind}} with if_match_revision:0 from plan_get; do not use op set for new ids.", "plan_ops_storage_ref": "append_storage_ref ref invalid", "plan_ops_text_domain": "patch_text id outside domain guard", "plan_ops_text_field": "patch_text field must be prompt|detail|objective|title or meta.*", "plan_ops_text_mode": "Unsupported patch_text mode or empty replacements", "plan_ops_unknown": "Unknown plan_patch op — discovery.describe agents.plan_patch; canonical ops: add_child, set, patch_text, reorder_children, archive. Aliases: add|add_node|insert|create → add_child; update → set.", "plan_patch_inline_body_spill": "Inline prose exceeds chunk seal — agents.graph_file_put; follow spill recovery in error data", "plan_patch_nodes_missing_from_changed": "Revision moved but new node ids are absent on plan_get — align generation_env_uuid on context and tool params; deploy compaction protect_ids (undated completed purge); run prelude bucket parents before child ingest batches.", "plan_patch_ops_limit": "Too many ops[] in one plan_patch — split batches; plan_get between writes (max 50)", "plan_patch_unknown_fields": "strict_schema rejected unknown task fields — use allowed_task_fields list", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "plan_slice_failed": "Narrow node_id, use projection=summary, or lower max_depth — slice could not be built", "replace_refused": "replace:true rewrites the whole graph. Pass replace_confirmed=true only for a full rebuild, otherwise send ops (set, set_meta, add_child, link, archive).", "replacement_not_found": "search_replace find string absent — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "text_anchor_miss": "fuzzy_replace could not locate anchor", "text_revision_conflict": "patch_text — re-read the field from plan_get; refresh expected_text_sha256", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal"}, "when_to_use": "Sparse ops with if_match_revision CAS; response is revision + changed[] cards (not full task_list). Preflight: agents.plan_get with node_id + detail=compact (see ops_compact.preflight_read / slice_com"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_patch", "mutation_risk": "low", "related_tools": ["agents.plan_get", "agents.work_next", "agents.plan_propose", "agents.graph_file_put", "agents.graph_file_get"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Plan Patch", "when_blocked": {"ambiguous_anchor": "patch_text search_replace — longer find, set count, or graph_file_get text window", "archive_purge_required": "Read history with agents.plan_get include_archived=true, then send purge_archived=true on agents.plan_patch. Anything else leaves the archive.", "catalog_path_unsupported": "Point meta.external_list.path at a list, or at an object with items, rows, leads, or results, then retry expand_catalog on that same node id.", "content_shrink_blocked": "replace would shrink a plan text field — use search_replace or allow_shrink", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "execution_error": "Unexpected patch failure — inspect message and trace_id", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_address_required": "Personal home needs a resolved session address. Pass home on the tool and ensure the operator session has user_id before patch.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "import_pack_personal_home_unsupported": "Orchestrator import pack requires home=project; personal session graphs use export/read paths only.", "invalid_heal_mode": "mode must be auto|body_only|migrate_archive_pages|cold_pages|archive_pages|none — match graph_limits.heal_recommended_mode or discovery.describe agents.plan_heal_leaf.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "invalid_state_transition": "agents.plan_get node status — legal FSM only; completed↔cancelled retries are no-ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "unified_diff on patch_text did not apply — re-read plan_get", "patch_too_large": "unified_diff exceeds size cap on patch_text", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "personal_home_agent_scope_conflict": "Use home=project with scope=agent for an agent private plan leaf, or use home=self|project_self without scope=agent for the session graph.", "plan_claim_owner_conflict": "agents.work_next handoff=true — another operator holds the lease", "plan_completion_gates": "Completion predicates are not satisfied — finish child work, waive with meta.completion_waived only when policy allows, or agents.plan_propose repair.", "plan_dependency_cycle": "Dependency cycle detected — remove circular depends_on before patch.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_children_exceeded": "Direct children per parent are capped (32). Flat parent_id storage counts siblings under each parent_id — not total graph nodes. Split into sub-groups or use agents.plan_propose decompose_node.", "plan_graph_dep_cycle": "Dependency cycle detected — remove circular depends_on before patch.", "plan_graph_depth_exceeded": "Plan tree depth exceeded — decompose strategic nodes with agents.plan_propose before adding deeper leaves.", "plan_graph_duplicate_id": "Duplicate node id in patch — use unique ids or nodes_to_update instead of recreate.", "plan_graph_empty_overwrite_refused": "Replacing a non-empty plan with an empty graph is refused — call plan_get, then pass allow_empty_graph and empty_graph_confirmed only when you intend to wipe all nodes.", "plan_graph_load_failed": "DNA/graph slice failed to load — plan_get (compact) then retry. If patch used a long title (>256), use patch_text or shorten title; see validation_error + field=title instead of this code when preflight maps PGVE.", "plan_graph_node_count": "Open plan has more than 1000 nodes. Archive completed nodes with ops {op:archive,id}. Do not copy them into a parent meta.done_or_dropped. Read them back with agents.plan_get include_archived=true. Large lists belong on a catalog node, not as copies in the graph.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_graph_write_failed": "The graph leaf was not updated. Read agents.plan_get and retry the same ops with if_match_revision set to the current revision.", "plan_hierarchy_cycle": "parent_id hierarchy cycle — fix parent_id chain before patch.", "plan_invalid_transition": "Status transition is not allowed for this node kind — read agents.plan_get and use a valid status path (e.g. pending→ready→in_progress→completed).", "plan_ops_duplicate_id": "add_child node.id already exists — pick a new id or update with set/patch_text.", "plan_ops_meta_key": "set_meta needs key + value (one field per op). Wrong: {op:set_meta,id,meta:{k:v}}. Right: {op:set_meta,id,key:k,value:v} or op set with meta:{k:v}. Bulk meta on set_meta is accepted when meta is a flat object.", "plan_ops_move": "move needs id and parent_id (parent must exist). Same as set {id, parent_id}.", "plan_ops_noop": "set op had no fields besides id — send status, title, parent_id, or use op move.", "plan_ops_parent_missing": "add_child parent_id is not in the graph — create the parent first or fix parent_id. On an empty project graph (revision 0, no tasks), omit parent_id and send {op:add_child, node:{id, title, kind}} with if_match_revision:0 from plan_get; do not use op set for new ids.", "plan_ops_storage_ref": "append_storage_ref ref invalid", "plan_ops_text_domain": "patch_text id outside domain guard", "plan_ops_text_field": "patch_text field must be prompt|detail|objective|title or meta.*", "plan_ops_text_mode": "Unsupported patch_text mode or empty replacements", "plan_ops_unknown": "Unknown plan_patch op — discovery.describe agents.plan_patch; canonical ops: add_child, set, patch_text, reorder_children, archive. Aliases: add|add_node|insert|create → add_child; update → set.", "plan_patch_inline_body_spill": "Inline prose exceeds chunk seal — agents.graph_file_put; follow spill recovery in error data", "plan_patch_nodes_missing_from_changed": "Revision moved but new node ids are absent on plan_get — align generation_env_uuid on context and tool params; deploy compaction protect_ids (undated completed purge); run prelude bucket parents before child ingest batches.", "plan_patch_ops_limit": "Too many ops[] in one plan_patch — split batches; plan_get between writes (max 50)", "plan_patch_unknown_fields": "strict_schema rejected unknown task fields — use allowed_task_fields list", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "plan_slice_failed": "Narrow node_id, use projection=summary, or lower max_depth — slice could not be built", "replace_refused": "replace:true rewrites the whole graph. Pass replace_confirmed=true only for a full rebuild, otherwise send ops (set, set_meta, add_child, link, archive).", "replacement_not_found": "search_replace find string absent — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "text_anchor_miss": "fuzzy_replace could not locate anchor", "text_revision_conflict": "patch_text — re-read the field from plan_get; refresh expected_text_sha256", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal"}, "when_to_use": "Sparse ops with if_match_revision CAS; response is revision + changed[] cards (not full task_list). Preflight: agents.plan_get with node_id + detail=compact (see ops_compact.preflight_read / slice_com"}, "do_not_use_when": "Do not set return_task_list=true — response is revision + changed[]; refresh via work_next compact.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Canonical create; use if_match_revision from plan_get.", "name": "add_child under parent", "request": {"params": {"if_match_revision": 12, "ops": [{"node": {"id": "task-new", "kind": "task", "status": "pending", "title": "New task"}, "op": "add_child", "parent_id": "goal-root"}], "project_id": 1}, "tool": "agents.plan_patch"}, "response": {"data": {"changed": [{"id": "task-new"}], "revision": 13}, "success": true}}, {"description": "Prefer patch_text over full set; if_match_revision from plan_get.", "name": "patch_text on prompt", "request": {"params": {"home": "project", "if_match_revision": 12, "ops": [{"field": "prompt", "id": "task-a", "mode": "search_replace", "op": "patch_text", "replacements": [{"find": "BETA", "replace": "GA"}]}], "project_id": 1}, "tool": "agents.plan_patch"}, "response": {"data": {"changed": [{"id": "task-a"}], "revision": 13}, "success": true}}, {"description": "Reparent a node; equivalent to set {id, parent_id}.", "name": "move subtree", "request": {"params": {"if_match_revision": 12, "ops": [{"id": "task-b", "op": "move", "parent_id": "goal-root"}], "project_id": 1}, "tool": "agents.plan_patch"}, "response": {"data": {"changed": [{"id": "task-b"}, {"id": "goal-root"}], "revision": 13}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Sparse ops with if_match_revision CAS; response is revision + changed[] cards (not full task_list).…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_get", "agents.work_next", "agents.graph_file_put"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"accepted": {"description": "True when ops passed validation (may still be semantic_noop)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "changed": {"description": "Sparse PlanCard rows for touched node ids", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "committed": {"description": "True when DNA leaf was persisted", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "content_hash": {"description": "plan_content_hash after patch (stamped on leaf write)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "generation_pending": {"description": "Sandbox vs prod diff summary when include_generation_pending=true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "graph_limits": {"description": "On plan_graph_too_large errors — bytes_estimate vs jsonb_inline_byte_limit", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "graph_metrics": {"description": "Lightweight metrics when include_graph_metrics=true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "graph_revision": {"description": "Same as new_revision on success envelopes", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "new_revision": {"description": "CAS revision after merge", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "ok": {"description": "True when patch applied", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "previous_revision": {"description": "CAS revision before merge", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "rest_surfaces": {"description": "POST /api/projects/{project_id}/orchestrator/plan/ops", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "retryable": {"description": "False on CAS conflict; true on transient failures when set", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "revision": {"description": "Graph revision after patch (default response)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "revision_after": {"description": "Graph revision after patch on success (alias of new_revision)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "sandbox_ops": {"description": "Generation ladder quick links (always on home=project success envelopes)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "semantic_noop": {"description": "True when merge did not change graph bytes", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "state": {"description": "applied | noop | blocked — high-level patch outcome", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "Alias for ok on structured envelopes", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "warnings": {"description": "aliased_fields, ignored_fields, return_task_list_ignored", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "plan_graph_validation_errors": {"archive_purge_required": "Read history with agents.plan_get include_archived=true, then send purge_archived=true on agents.plan_patch. Anything else leaves the archive.", "catalog_path_unsupported": "Point meta.external_list.path at a list, or at an object with items, rows, leads, or results, then retry expand_catalog on that same node id.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_address_required": "Personal home needs a resolved session address. Pass home on the tool and ensure the operator session has user_id before patch.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "import_pack_personal_home_unsupported": "Orchestrator import pack requires home=project; personal session graphs use export/read paths only.", "invalid_heal_mode": "mode must be auto|body_only|migrate_archive_pages|cold_pages|archive_pages|none — match graph_limits.heal_recommended_mode or discovery.describe agents.plan_heal_leaf.", "personal_home_agent_scope_conflict": "Use home=project with scope=agent for an agent private plan leaf, or use home=self|project_self without scope=agent for the session graph.", "plan_claim_owner_conflict": "Node is claimed by another agent — agents.work_next handoff=true or agents.plan_reclaim_stale when the lease expired.", "plan_completion_gates": "Completion predicates are not satisfied — finish child work, waive with meta.completion_waived only when policy allows, or agents.plan_propose repair.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_children_exceeded": "Direct children per parent are capped (32). Flat parent_id storage counts siblings under each parent_id — not total graph nodes. Split into sub-groups or use agents.plan_propose decompose_node.", "plan_graph_dep_cycle": "Dependency cycle detected — remove circular depends_on before patch.", "plan_graph_depth_exceeded": "Plan tree depth exceeded — decompose strategic nodes with agents.plan_propose before adding deeper leaves.", "plan_graph_duplicate_id": "Duplicate node id in patch — use unique ids or nodes_to_update instead of recreate.", "plan_graph_empty_overwrite_refused": "Replacing a non-empty plan with an empty graph is refused — call plan_get, then pass allow_empty_graph and empty_graph_confirmed only when you intend to wipe all nodes.", "plan_graph_node_count": "Open plan has more than 1000 nodes. Archive completed nodes with ops {op:archive,id}. Do not copy them into a parent meta.done_or_dropped. Read them back with agents.plan_get include_archived=true. Large lists belong on a catalog node, not as copies in the graph.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_graph_write_failed": "The graph leaf was not updated. Read agents.plan_get and retry the same ops with if_match_revision set to the current revision.", "plan_hierarchy_cycle": "parent_id hierarchy cycle — fix parent_id chain before patch.", "plan_invalid_transition": "Status transition is not allowed for this node kind — read agents.plan_get and use a valid status path (e.g. pending→ready→in_progress→completed).", "plan_ops_duplicate_id": "add_child node.id already exists — pick a new id or update with set/patch_text.", "plan_ops_meta_key": "set_meta needs key + value (one field per op). Wrong: {op:set_meta,id,meta:{k:v}}. Right: {op:set_meta,id,key:k,value:v} or op set with meta:{k:v}. Bulk meta on set_meta is accepted when meta is a flat object.", "plan_ops_move": "move needs id and parent_id (parent must exist). Same as set {id, parent_id}.", "plan_ops_noop": "set op had no fields besides id — send status, title, parent_id, or use op move.", "plan_ops_parent_missing": "add_child parent_id is not in the graph — create the parent first or fix parent_id. On an empty project graph (revision 0, no tasks), omit parent_id and send {op:add_child, node:{id, title, kind}} with if_match_revision:0 from plan_get; do not use op set for new ids.", "plan_ops_unknown": "Unknown plan_patch op — discovery.describe agents.plan_patch; canonical ops: add_child, set, patch_text, reorder_children, archive. Aliases: add|add_node|insert|create → add_child; update → set.", "plan_patch_nodes_missing_from_changed": "Revision moved but new node ids are absent on plan_get — align generation_env_uuid on context and tool params; deploy compaction protect_ids (undated completed purge); run prelude bucket parents before child ingest batches.", "plan_revision_conflict": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal after concurrent plan_patch or graph_file_*.", "plan_slice_failed": "Narrow node_id, use projection=summary, or lower max_depth — slice could not be built", "replace_refused": "replace:true rewrites the whole graph. Pass replace_confirmed=true only for a full rebuild, otherwise send ops (set, set_meta, add_child, link, archive).", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap."}, "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "agents.work_next", "agents.plan_propose", "agents.graph_file_put", "agents.graph_file_get"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["generation.realign_to_prod"], "safe_action": "agents_plan_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Merge plan graph nodes (deep by id). Pass if_match_revision from plan_get for CAS (fleet/autonomous writers must send it). F1: when auto_generation_mode is on, pass env_uuid from sandbox fork; diff pa", "title": "Patch Plan Graph", "verification": ["agents.plan_get", "agents.graph_health"], "verify": [{"action": "agents.plan_get", "predicate": "named resource is visible"}, {"action": "agents.graph_health", "predicate": "named resource is visible"}], "wave_xix_atoms": {"MCP_DOMAIN_ERROR": "Domain denial: tools/call isError=false with structuredContent (ok=false, error_code, failure_kind=domain, recovery). Transport/internal uses isError=true (failure_kind=transport). plan_revision_conflict → agents.plan_get then retry with fresh if_match_revision.", "WG_CAS_RETRY": "plan_revision_conflict → plan_get reload if_match_revision — never apply stale proposal after concurrent plan_patch or backlog apply.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_PLAN_GRAPH_CHILDREN_CAP": "Max 32 direct children per parent_id (not total graph size). Large flat graphs are valid; split siblings across intermediate feature nodes when one parent exceeds the cap."}, "when_blocked": {"ambiguous_anchor": "patch_text search_replace — longer find, set count, or graph_file_get text window", "archive_purge_required": "Read history with agents.plan_get include_archived=true, then send purge_archived=true on agents.plan_patch. Anything else leaves the archive.", "catalog_path_unsupported": "Point meta.external_list.path at a list, or at an object with items, rows, leads, or results, then retry expand_catalog on that same node id.", "content_shrink_blocked": "replace would shrink a plan text field — use search_replace or allow_shrink", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "execution_error": "Unexpected patch failure — inspect message and trace_id", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_address_required": "Personal home needs a resolved session address. Pass home on the tool and ensure the operator session has user_id before patch.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "import_pack_personal_home_unsupported": "Orchestrator import pack requires home=project; personal session graphs use export/read paths only.", "invalid_heal_mode": "mode must be auto|body_only|migrate_archive_pages|cold_pages|archive_pages|none — match graph_limits.heal_recommended_mode or discovery.describe agents.plan_heal_leaf.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "invalid_state_transition": "agents.plan_get node status — legal FSM only; completed↔cancelled retries are no-ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "unified_diff on patch_text did not apply — re-read plan_get", "patch_too_large": "unified_diff exceeds size cap on patch_text", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "personal_home_agent_scope_conflict": "Use home=project with scope=agent for an agent private plan leaf, or use home=self|project_self without scope=agent for the session graph.", "plan_claim_owner_conflict": "agents.work_next handoff=true — another operator holds the lease", "plan_completion_gates": "Completion predicates are not satisfied — finish child work, waive with meta.completion_waived only when policy allows, or agents.plan_propose repair.", "plan_dependency_cycle": "Dependency cycle detected — remove circular depends_on before patch.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_children_exceeded": "Direct children per parent are capped (32). Flat parent_id storage counts siblings under each parent_id — not total graph nodes. Split into sub-groups or use agents.plan_propose decompose_node.", "plan_graph_dep_cycle": "Dependency cycle detected — remove circular depends_on before patch.", "plan_graph_depth_exceeded": "Plan tree depth exceeded — decompose strategic nodes with agents.plan_propose before adding deeper leaves.", "plan_graph_duplicate_id": "Duplicate node id in patch — use unique ids or nodes_to_update instead of recreate.", "plan_graph_empty_overwrite_refused": "Replacing a non-empty plan with an empty graph is refused — call plan_get, then pass allow_empty_graph and empty_graph_confirmed only when you intend to wipe all nodes.", "plan_graph_load_failed": "DNA/graph slice failed to load — plan_get (compact) then retry. If patch used a long title (>256), use patch_text or shorten title; see validation_error + field=title instead of this code when preflight maps PGVE.", "plan_graph_node_count": "Open plan has more than 1000 nodes. Archive completed nodes with ops {op:archive,id}. Do not copy them into a parent meta.done_or_dropped. Read them back with agents.plan_get include_archived=true. Large lists belong on a catalog node, not as copies in the graph.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_graph_write_failed": "The graph leaf was not updated. Read agents.plan_get and retry the same ops with if_match_revision set to the current revision.", "plan_hierarchy_cycle": "parent_id hierarchy cycle — fix parent_id chain before patch.", "plan_invalid_transition": "Status transition is not allowed for this node kind — read agents.plan_get and use a valid status path (e.g. pending→ready→in_progress→completed).", "plan_ops_duplicate_id": "add_child node.id already exists — pick a new id or update with set/patch_text.", "plan_ops_meta_key": "set_meta needs key + value (one field per op). Wrong: {op:set_meta,id,meta:{k:v}}. Right: {op:set_meta,id,key:k,value:v} or op set with meta:{k:v}. Bulk meta on set_meta is accepted when meta is a flat object.", "plan_ops_move": "move needs id and parent_id (parent must exist). Same as set {id, parent_id}.", "plan_ops_noop": "set op had no fields besides id — send status, title, parent_id, or use op move.", "plan_ops_parent_missing": "add_child parent_id is not in the graph — create the parent first or fix parent_id. On an empty project graph (revision 0, no tasks), omit parent_id and send {op:add_child, node:{id, title, kind}} with if_match_revision:0 from plan_get; do not use op set for new ids.", "plan_ops_storage_ref": "append_storage_ref ref invalid", "plan_ops_text_domain": "patch_text id outside domain guard", "plan_ops_text_field": "patch_text field must be prompt|detail|objective|title or meta.*", "plan_ops_text_mode": "Unsupported patch_text mode or empty replacements", "plan_ops_unknown": "Unknown plan_patch op — discovery.describe agents.plan_patch; canonical ops: add_child, set, patch_text, reorder_children, archive. Aliases: add|add_node|insert|create → add_child; update → set.", "plan_patch_inline_body_spill": "Inline prose exceeds chunk seal — agents.graph_file_put; follow spill recovery in error data", "plan_patch_nodes_missing_from_changed": "Revision moved but new node ids are absent on plan_get — align generation_env_uuid on context and tool params; deploy compaction protect_ids (undated completed purge); run prelude bucket parents before child ingest batches.", "plan_patch_ops_limit": "Too many ops[] in one plan_patch — split batches; plan_get between writes (max 50)", "plan_patch_unknown_fields": "strict_schema rejected unknown task fields — use allowed_task_fields list", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "plan_slice_failed": "Narrow node_id, use projection=summary, or lower max_depth — slice could not be built", "replace_refused": "replace:true rewrites the whole graph. Pass replace_confirmed=true only for a full rebuild, otherwise send ops (set, set_meta, add_child, link, archive).", "replacement_not_found": "search_replace find string absent — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "text_anchor_miss": "fuzzy_replace could not locate anchor", "text_revision_conflict": "patch_text — re-read the field from plan_get; refresh expected_text_sha256", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal"}, "when_blocked_locales": {"graph_home_unknown": {"en-US": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "pt-BR": "home deve ser project, self ou project_self. Repita agents.plan_get ou agents.plan_patch com um desses valores.", "ru-RU": "home должен быть project, self или project_self. Повторите agents.plan_get или agents.plan_patch с одним из значений."}, "invalid_parameters": {"en-US": "project_id and run_id required — agent_id optional when run_id is set", "pt-BR": "project_id e run_id obrigatórios — agent_id opcional com run_id", "ru-RU": "Нужны project_id и run_id — agent_id опционален при run_id"}, "permission_denied": {"en-US": "RBAC denied — rbac.check_permission, membership, or dev-operator persona", "pt-BR": "RBAC negado — rbac.check_permission, membership ou persona dev-operator", "ru-RU": "RBAC отказ — rbac.check_permission, членство или dev-operator persona"}, "plan_claim_owner_conflict": {"en-US": "Node is claimed by another agent — agents.work_next handoff=true or agents.plan_reclaim_stale when the lease expired.", "pt-BR": "Outro agente tem o lease. agents.work_next handoff=true ou agents.plan_reclaim_stale após expirar.", "ru-RU": "Узел занят другим агентом. agents.work_next handoff=true или agents.plan_reclaim_stale после истечения lease."}, "plan_graph_children_exceeded": {"en-US": "Direct children per parent are capped (32). Flat parent_id storage counts siblings under each parent_id — not total graph nodes. Split into sub-groups or use agents.plan_propose decompose_node.", "pt-BR": "Limite de filhos diretos por pai (32). Conta siblings sob parent_id, não o grafo inteiro. Divida em subgrupos ou agents.plan_propose decompose_node.", "ru-RU": "Лимит прямых детей на родителя (32). Считаются siblings под parent_id, не все узлы графа. Разбейте на подгруппы или agents.plan_propose decompose_node."}, "plan_graph_depth_exceeded": {"en-US": "Plan tree depth exceeded — decompose strategic nodes with agents.plan_propose before adding deeper leaves.", "pt-BR": "Profundidade do plano excedida — decomponha nós estratégicos com agents.plan_propose.", "ru-RU": "Превышена глубина плана — декомпозируйте стратегические узлы через agents.plan_propose."}, "plan_graph_load_failed": {"en-US": "Graph load failed — agents.plan_get (compact) then retry. Long titles: max 256 chars (field=title); use patch_text for prose.", "pt-BR": "Falha ao carregar grafo — agents.plan_get (compact) e retry. title ≤256; texto longo — patch_text.", "ru-RU": "Не загрузился граф — agents.plan_get (compact), затем patch. title ≤256; длинный текст — patch_text."}, "plan_revision_conflict": {"en-US": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal", "pt-BR": "Conflito CAS — agents.plan_get recarregue if_match_revision; nunca apply proposal obsoleto", "ru-RU": "CAS конфликт — agents.plan_get перечитать if_match_revision; не apply устаревший proposal"}, "replace_refused": {"en-US": "replace:true rewrites the whole graph. Pass replace_confirmed=true only for a full rebuild, otherwise send ops (set, set_meta, add_child, link, archive).", "pt-BR": "replace:true reescreve o grafo inteiro. replace_confirmed:true só para rebuild completo; senão use ops em agents.plan_patch.", "ru-RU": "replace:true перезаписывает весь граф. replace_confirmed:true только для полной пересборки, иначе ops в agents.plan_patch."}}, "when_not_to_use": "Do not set return_task_list=true — response is revision + changed[]; refresh via work_next compact.", "when_to_use": "Sparse ops with if_match_revision CAS; response is revision + changed[] cards (not full task_list). Preflight: agents.plan_get with node_id + detail=compact (see ops_compact.preflight_read / slice_com", "write_mode": null}, {"action": "agents.plan_pin", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not use plan_pin as a claim or heartbeat. It does not set in_progress.", "anti_patterns": ["Do not use plan_pin as a claim or heartbeat. It does not set in_progress."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_pin", "mutation_risk": "low", "related_tools": ["agents.plan_claim", "agents.plan_get", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Pin", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Write goal pin_inventory (pin, unpin, collapse, expand) without a claim lease and without WIP. Use when plan_claim heartbeat is refused because the node is not in_progress or the project is at the WIP"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_pin", "mutation_risk": "low", "related_tools": ["agents.plan_claim", "agents.plan_get", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Pin", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Write goal pin_inventory (pin, unpin, collapse, expand) without a claim lease and without WIP. Use when plan_claim heartbeat is refused because the node is not in_progress or the project is at the WIP"}, "do_not_use_when": "Do not use plan_pin as a claim or heartbeat. It does not set in_progress.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Write goal pin_inventory (pin, unpin, collapse, expand) without a claim lease and without WIP. Use …", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_claim", "agents.plan_get", "agents.work_next"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_claim", "agents.plan_get", "agents.work_next"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_pin", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Write goal pin_inventory without claiming a node or consuming WIP. Same pin/unpin/collapse/expand params as plan_claim heartbeat, minus the lease.", "title": "Agents Plan Pin", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not use plan_pin as a claim or heartbeat. It does not set in_progress.", "when_to_use": "Write goal pin_inventory (pin, unpin, collapse, expand) without a claim lease and without WIP. Use when plan_claim heartbeat is refused because the node is not in_progress or the project is at the WIP", "write_mode": null}, {"action": "agents.plan_claim", "aliases": ["work.claim"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not claim planning_artifact nodes (evidence_only) — attach evidence on parent.", "anti_patterns": ["Do not claim planning_artifact nodes (evidence_only) — attach evidence on parent.", "specialization_mismatch requires handoff, not repeated claim with same agent.", "Do not treat bound agent_id alone as already_claimed — check in_progress lease meta (H11)."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_claim", "mutation_risk": "low", "related_tools": ["agents.plan_get", "agents.plan_execute", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Plan Claim", "when_blocked": {"capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "claim_empty": "agents.work_next handoff=true — no nodes claimed; refresh claimable set", "claim_heartbeat_failed": "No active in_progress lease for node_id — plan_claim the node before heartbeat_only pin ops", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "node_not_eligible": "agents.plan_get on the same home — node failed evaluate_work_eligibility; agents.work_next handoff=true and follow recovery.next_actions", "node_not_found": "agents.plan_get include_claimable=true — node_id absent from graph slice", "not_executable": "kind note and catalog are memory, not work. Do not plan_claim them. Claim a task, step, or issue on the same home.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "pin_inventory_full": "Goal pin inventory at active_max — unpin a slot (plan affinity) then retry agents.plan_claim", "pin_slot_not_found": "No matching goal pin slot for skill_id and agent_id — agents.plan_get pin_slots then retry", "plan_claim_owner_conflict": "agents.work_next handoff=true — another operator holds the lease", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "role_mismatch": "work_next handoff=true node_id=… — do not retry same agent", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "skill_mismatch": "agents.work_next handoff=true — skill_ids mismatch; follow recovery.next_actions", "specialization_mismatch": "work_next handoff=true — follow recovery.next_actions", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wip_full": "Agent WIP cap reached — agents.plan_get then complete/release in_progress claims; retry plan_claim"}, "when_to_use": "Requires mcp_write (hidden from read-only catalog). Read-only keys: follow packet.next_action from agents.work_next — do not call claim unless next_action is agents.plan_claim and the key has mcp_writ"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_claim", "mutation_risk": "low", "related_tools": ["agents.plan_get", "agents.plan_execute", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Plan Claim", "when_blocked": {"capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "claim_empty": "agents.work_next handoff=true — no nodes claimed; refresh claimable set", "claim_heartbeat_failed": "No active in_progress lease for node_id — plan_claim the node before heartbeat_only pin ops", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "node_not_eligible": "agents.plan_get on the same home — node failed evaluate_work_eligibility; agents.work_next handoff=true and follow recovery.next_actions", "node_not_found": "agents.plan_get include_claimable=true — node_id absent from graph slice", "not_executable": "kind note and catalog are memory, not work. Do not plan_claim them. Claim a task, step, or issue on the same home.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "pin_inventory_full": "Goal pin inventory at active_max — unpin a slot (plan affinity) then retry agents.plan_claim", "pin_slot_not_found": "No matching goal pin slot for skill_id and agent_id — agents.plan_get pin_slots then retry", "plan_claim_owner_conflict": "agents.work_next handoff=true — another operator holds the lease", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "role_mismatch": "work_next handoff=true node_id=… — do not retry same agent", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "skill_mismatch": "agents.work_next handoff=true — skill_ids mismatch; follow recovery.next_actions", "specialization_mismatch": "work_next handoff=true — follow recovery.next_actions", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wip_full": "Agent WIP cap reached — agents.plan_get then complete/release in_progress claims; retry plan_claim"}, "when_to_use": "Requires mcp_write (hidden from read-only catalog). Read-only keys: follow packet.next_action from agents.work_next — do not call claim unless next_action is agents.plan_claim and the key has mcp_writ"}, "do_not_use_when": "Do not claim planning_artifact nodes (evidence_only) — attach evidence on parent.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "CAS claim one node", "request": {"params": {"agent_id": "619b1939-0000-4000-8000-000000000001", "if_match_revision": 12, "node_ids": ["task-a"], "project_id": 1}, "tool": "agents.plan_claim"}, "response": {"data": {"claimed": ["task-a"], "previous_revision": 12, "revision": 13}, "success": true}}, {"description": "role_mismatch and specialization_mismatch attach recovery_block with agents.work_next handoff=true. This is fleet eligibility, not an API-key cap.", "name": "Role mismatch with recovery_block", "request": {"params": {"agent_id": "619b1939-0000-4000-8000-000000000002", "if_match_revision": 12, "node_ids": ["task-architect"], "project_id": 1}, "tool": "agents.plan_claim"}, "response": {"data": {"recovery_block": {"next_actions": [{"action": "agents.work_next", "params": {"focus_node_id": "task-architect", "handoff": true, "project_id": 1}}], "reason": "role_mismatch"}}, "error_code": "role_mismatch", "success": false}}], "execution_class": "cheap", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Requires mcp_write (hidden from read-only catalog). Read-only keys: follow packet.next_action from …", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_execute", "agents.work_next"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"claimed": {"description": "Node ids claimed for this agent", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "idempotent_replay": {"description": "True when in-batch idempotency key replays prior claim payload (rv-12)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "next_action": {"description": "Suggested follow-up MCP action when present", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "recovery": {"description": "Recovery block when claim blocked (verify_failed, stale lease)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "recovery_hint": {"description": "Human-readable unblock hint", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "rest_surfaces": {"description": "POST /api/projects/{project_id}/orchestrator/plan/claim", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "task_list": {"description": "Task list after claim (includes lease meta)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "agents.plan_execute", "agents.work_next"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_claim", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Claim pending plan leaves as in_progress for one agent (parallel work, WIP capped). Server-managed on claim: status, agent_id, meta.claimed_at|lease_until|heartbeat_at. Preserves title/objective/predi", "title": "Claim Plan Node", "wave_xix_atoms": {"MCP_DOMAIN_ERROR": "Domain denial: tools/call isError=false with structuredContent (ok=false, error_code, failure_kind=domain, recovery). Transport/internal uses isError=true (failure_kind=transport). plan_revision_conflict → agents.plan_get then retry with fresh if_match_revision.", "WG_BIND_VS_CLAIM": "node.agent_id binding ≠ active claim lease — already_claimed requires status=in_progress with non-expired lease meta; bound agent on ready/pending is not already_claimed; retry ensure_agent idempotent_replay or plan_claim with if_match_revision.", "WG_BLOCKED_REASON": "blocked_work[].blocked_reason is canonical (block_reason.REASON_PRIORITY); use recovery.next_actions — not validation.missing_roles.", "WG_CAPABILITY_HARD_GATE": "required_capabilities are mandatory — capability_mismatch blocks claim; route agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan; not handoff (capability_hard_gate_v1).", "WG_CAS_RETRY": "plan_revision_conflict → plan_get reload if_match_revision — never apply stale proposal after concurrent plan_patch or backlog apply.", "WG_CLAIM_BEFORE_EXECUTE": "agents.plan_execute requires an active claim lease from agents.plan_claim unless operator policy allows execute-without-claim; pass if_match_revision from plan_get.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_HANDOFF_RECOVERY": "role_mismatch / specialization_mismatch after claim → work_next handoff=true node_id=… — follow recovery.next_actions, do not retry same agent. capability_mismatch is missing required_capabilities: repair_plan or ensure_agent, not handoff.", "WG_PLANNING_ARTIFACT": "meta.planning_artifact nodes are evidence-only (resolution=non_executable_artifact) — attach evidence on parent; plan_process_backlog and claim skip them for execution."}, "when_blocked": {"capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "claim_empty": "agents.work_next handoff=true — no nodes claimed; refresh claimable set", "claim_heartbeat_failed": "No active in_progress lease for node_id — plan_claim the node before heartbeat_only pin ops", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "node_not_eligible": "agents.plan_get on the same home — node failed evaluate_work_eligibility; agents.work_next handoff=true and follow recovery.next_actions", "node_not_found": "agents.plan_get include_claimable=true — node_id absent from graph slice", "not_executable": "kind note and catalog are memory, not work. Do not plan_claim them. Claim a task, step, or issue on the same home.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "pin_inventory_full": "Goal pin inventory at active_max — unpin a slot (plan affinity) then retry agents.plan_claim", "pin_slot_not_found": "No matching goal pin slot for skill_id and agent_id — agents.plan_get pin_slots then retry", "plan_claim_owner_conflict": "agents.work_next handoff=true — another operator holds the lease", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "role_mismatch": "work_next handoff=true node_id=… — do not retry same agent", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "skill_mismatch": "agents.work_next handoff=true — skill_ids mismatch; follow recovery.next_actions", "specialization_mismatch": "work_next handoff=true — follow recovery.next_actions", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wip_full": "Agent WIP cap reached — agents.plan_get then complete/release in_progress claims; retry plan_claim"}, "when_blocked_locales": {"capability_mismatch": {"en-US": "Missing required_capabilities — agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan. Not handoff.", "pt-BR": "required_capabilities ausentes — agents.ensure_agent create=false (H5) depois create=true, ou plan_propose mode=repair_plan. Não é handoff.", "ru-RU": "Нет required_capabilities — agents.ensure_agent create=false (H5) затем create=true, или plan_propose mode=repair_plan. Не handoff."}, "claim_heartbeat_failed": {"en-US": "Claim lease missing — plan_claim the node before heartbeat_only pin writes", "pt-BR": "Sem lease — faça plan_claim do nó antes de pin com heartbeat_only", "ru-RU": "Нет lease — сначала plan_claim узла, затем heartbeat_only для pin"}, "expired_claim": {"en-US": "Stale lease — agents.plan_reclaim_stale, then plan_claim with a fresh if_match_revision", "pt-BR": "Lease expirado — agents.plan_reclaim_stale, depois plan_claim com if_match_revision novo", "ru-RU": "Истёк lease — agents.plan_reclaim_stale, затем plan_claim с новым if_match_revision"}, "invalid_parameters": {"en-US": "project_id and run_id required — agent_id optional when run_id is set", "pt-BR": "project_id e run_id obrigatórios — agent_id opcional com run_id", "ru-RU": "Нужны project_id и run_id — agent_id опционален при run_id"}, "permission_denied": {"en-US": "RBAC denied — rbac.check_permission, membership, or dev-operator persona", "pt-BR": "RBAC negado — rbac.check_permission, membership ou persona dev-operator", "ru-RU": "RBAC отказ — rbac.check_permission, членство или dev-operator persona"}, "pin_inventory_full": {"en-US": "Pin inventory full — unpin a goal slot, then retry agents.plan_claim", "pt-BR": "Inventário de pin cheio — desafixe um slot, depois agents.plan_claim", "ru-RU": "Инвентарь pin заполнен — освободите слот, затем agents.plan_claim"}, "pin_slot_not_found": {"en-US": "Pin slot not found — check skill_id and agent_id on the goal inventory", "pt-BR": "Slot pin não encontrado — confira skill_id e agent_id no inventário da meta", "ru-RU": "Слот pin не найден — проверьте skill_id и agent_id в инвентаре цели"}, "plan_revision_conflict": {"en-US": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal", "pt-BR": "Conflito CAS — agents.plan_get recarregue if_match_revision; nunca apply proposal obsoleto", "ru-RU": "CAS конфликт — agents.plan_get перечитать if_match_revision; не apply устаревший proposal"}, "role_mismatch": {"en-US": "Handoff — agents.work_next handoff=true node_id=…; follow recovery.next_actions; do not retry same agent", "pt-BR": "Handoff — agents.work_next handoff=true node_id=…; siga recovery.next_actions; não repita o mesmo agente", "ru-RU": "Handoff — agents.work_next handoff=true node_id=…; следуйте recovery.next_actions; не повторяйте того же агента"}, "skill_mismatch": {"en-US": "Skill mismatch — agents.work_next handoff=true; follow recovery.next_actions", "pt-BR": "Skill mismatch — agents.work_next handoff=true; siga recovery.next_actions", "ru-RU": "Skill mismatch — agents.work_next handoff=true; следуйте recovery.next_actions"}, "specialization_mismatch": {"en-US": "Specialization mismatch — agents.work_next handoff=true; follow recovery.next_actions", "pt-BR": "Especialização incompatível — agents.work_next handoff=true; siga recovery.next_actions", "ru-RU": "Несовпадение специализации — agents.work_next handoff=true; следуйте recovery.next_actions"}, "wip_full": {"en-US": "WIP cap — complete/release in_progress claims; agents.plan_get then retry plan_claim", "pt-BR": "Cap WIP — conclua/libere claims in_progress; agents.plan_get depois plan_claim", "ru-RU": "Лимит WIP — завершите/освободите in_progress; agents.plan_get затем plan_claim"}}, "when_not_to_use": "Do not claim planning_artifact nodes (evidence_only) — attach evidence on parent.", "when_to_use": "Requires mcp_write (hidden from read-only catalog). Read-only keys: follow packet.next_action from agents.work_next — do not call claim unless next_action is agents.plan_claim and the key has mcp_writ", "write_mode": null}, {"action": "agents.plan_release", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.plan_release", "related_tools": ["agents.plan_claim", "agents.plan_get", "agents.plan_reclaim_stale", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Release", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Voluntary release of your own in_progress claim (DNA mutating). Use when wip_full blocks new plan_claim but the lease is still yours — not for expired leases (agents.plan_reclaim_stale). home=project|"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.plan_release", "related_tools": ["agents.plan_claim", "agents.plan_get", "agents.plan_reclaim_stale", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Release", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Voluntary release of your own in_progress claim (DNA mutating). Use when wip_full blocks new plan_claim but the lease is still yours — not for expired leases (agents.plan_reclaim_stale). home=project|"}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Voluntary release of your own in_progress claim (DNA mutating). Use when wip_full blocks new plan_c…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_claim", "agents.plan_get", "agents.work_next"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_claim", "agents.plan_get", "agents.plan_reclaim_stale", "agents.work_next"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_release", "semantic_input_mode": "inherit_workflow", "summary": "Release your own in_progress plan claim (voluntary). Use when wip_full blocks new work and the lease is still yours.", "title": "Agents Plan Release", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Voluntary release of your own in_progress claim (DNA mutating). Use when wip_full blocks new plan_claim but the lease is still yours — not for expired leases (agents.plan_reclaim_stale). home=project|", "write_mode": null}, {"action": "agents.plan_heal_leaf", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.plan_heal_leaf", "related_tools": ["agents.plan_compaction_preview", "agents.graph_health", "agents.plan_get", "agents.plan_patch", "agents.work_next", "agents.graph_file_put"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Heal Leaf", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "execution_error": "Unexpected heal failure — inspect message and trace_id", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_heal_mode": "mode must be auto|body_only|migrate_archive_pages|cold_pages|archive_pages|none — match graph_limits.heal_recommended_mode or discovery.describe agents.plan_heal_leaf.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_load_failed": "DNA/graph slice failed to load — plan_get (compact) then retry. If patch used a long title (>256), use patch_text or shorten title; see validation_error + field=title instead of this code when preflight maps PGVE.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_graph_write_failed": "The graph leaf was not updated. Read agents.plan_get and retry the same ops with if_match_revision set to the current revision.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "plan_slice_failed": "Narrow node_id, use projection=summary, or lower max_depth — slice could not be built", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compact aged terminals and spill fat bodies to storage/.../work_graph/chunks (DNA mutating, no semantic ops). Triggers when graph_limits.needs_leaf_heal (~400KiB+) or spill_incomplete (still over 512K"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.plan_heal_leaf", "related_tools": ["agents.plan_compaction_preview", "agents.graph_health", "agents.plan_get", "agents.plan_patch", "agents.work_next", "agents.graph_file_put"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Heal Leaf", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "execution_error": "Unexpected heal failure — inspect message and trace_id", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_heal_mode": "mode must be auto|body_only|migrate_archive_pages|cold_pages|archive_pages|none — match graph_limits.heal_recommended_mode or discovery.describe agents.plan_heal_leaf.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_load_failed": "DNA/graph slice failed to load — plan_get (compact) then retry. If patch used a long title (>256), use patch_text or shorten title; see validation_error + field=title instead of this code when preflight maps PGVE.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_graph_write_failed": "The graph leaf was not updated. Read agents.plan_get and retry the same ops with if_match_revision set to the current revision.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "plan_slice_failed": "Narrow node_id, use projection=summary, or lower max_depth — slice could not be built", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compact aged terminals and spill fat bodies to storage/.../work_graph/chunks (DNA mutating, no semantic ops). Triggers when graph_limits.needs_leaf_heal (~400KiB+) or spill_incomplete (still over 512K"}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Preview spill/compact before apply when graph_health reports spill_incomplete", "request": {"dry_run": true, "home": "project", "project_id": 1}, "response": {"data": {"bytes_after": 95000, "bytes_before": 120000, "dry_run": true, "healed": false, "home": "project", "reason": "leaf_within_budget"}, "success": true}}, {"description": "Archive-only heal when graph_limits.heal_recommended_mode is migrate_archive_pages (alias archive_pages).", "request": {"dry_run": true, "home": "project", "mode": "migrate_archive_pages", "project_id": 1}, "response": {"data": {"archive_migrated": 12, "dry_run": true, "healed": true, "home": "project", "mode": "migrate_archive_pages"}, "success": true}}, {"description": "Apply body spill without cold_page seal when mode=body_only (mcp_community_hub_v1 step 5b)", "request": {"dry_run": false, "home": "project_self", "mode": "body_only", "project_id": 1}, "response": {"data": {"bytes_after": 92000, "bytes_before": 180000, "dry_run": false, "healed": true, "home": "project_self", "mode": "body_only"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Compact aged terminals and spill fat bodies to storage/.../work_graph/chunks (DNA mutating, no sema…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.work_next", "agents.plan_patch", "agents.graph_file_put"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_compaction_preview", "agents.graph_health", "agents.plan_get", "agents.plan_patch", "agents.work_next", "agents.graph_file_put"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_heal_leaf", "semantic_input_mode": "inherit_workflow", "summary": "Compact aged terminals and spill heavy node bodies into work_graph/chunks storage without changing plan semantics. Use when graph_limits.spill_incomplete, plan_graph_bytes_high advisories, or plan_gra", "title": "Agents Plan Heal Leaf", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "execution_error": "Unexpected heal failure — inspect message and trace_id", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_heal_mode": "mode must be auto|body_only|migrate_archive_pages|cold_pages|archive_pages|none — match graph_limits.heal_recommended_mode or discovery.describe agents.plan_heal_leaf.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_load_failed": "DNA/graph slice failed to load — plan_get (compact) then retry. If patch used a long title (>256), use patch_text or shorten title; see validation_error + field=title instead of this code when preflight maps PGVE.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_graph_write_failed": "The graph leaf was not updated. Read agents.plan_get and retry the same ops with if_match_revision set to the current revision.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "plan_slice_failed": "Narrow node_id, use projection=summary, or lower max_depth — slice could not be built", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compact aged terminals and spill fat bodies to storage/.../work_graph/chunks (DNA mutating, no semantic ops). Triggers when graph_limits.needs_leaf_heal (~400KiB+) or spill_incomplete (still over 512K", "write_mode": null}, {"action": "agents.plan_compaction_preview", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.plan_compaction_preview", "related_tools": ["agents.graph_health", "agents.plan_get", "agents.plan_heal_leaf", "agents.plan_patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Compaction Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only aged-terminal + byte-pressure preview — run before agents.plan_heal_leaf (same math as agents.graph_health compaction_preview)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.plan_compaction_preview", "related_tools": ["agents.graph_health", "agents.plan_get", "agents.plan_heal_leaf", "agents.plan_patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Compaction Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only aged-terminal + byte-pressure preview — run before agents.plan_heal_leaf (same math as agents.graph_health compaction_preview)."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Read-only aged-terminal drop estimate before agents.plan_heal_leaf apply", "request": {"home": "project", "project_id": 1}, "response": {"data": {"compaction_preview": {"aged_terminal_ids": [], "bytes_saved_estimate": 0}, "home": "project", "project_id": 1}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Read-only aged-terminal + byte-pressure preview — run before agents.plan_heal_leaf (same math as ag…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_heal_leaf", "agents.graph_health"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.graph_health", "agents.plan_get", "agents.plan_heal_leaf", "agents.plan_patch"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_plan_compaction_preview", "semantic_input_mode": "inherit_workflow", "summary": "Read-only preview of aged-terminal compaction (same math as agents.graph_health compaction_preview). No DNA write.", "title": "Agents Plan Compaction Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only aged-terminal + byte-pressure preview — run before agents.plan_heal_leaf (same math as agents.graph_health compaction_preview).", "write_mode": null}, {"action": "agents.plan_archive_branch", "ai_tips": "Archive a subtree by root_id — dry_run=true for archive_ids and bytes_saved_estimate; apply uses plan_patch op archive (id, not node_id). When live_child_count>0 pass reparent_live_to or archive leaves first.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_override": {"conditional_mutate": "dry_run=true returns archive_ids only; dry_run=false applies plan_patch archive.", "effect_depends_on_params": true, "mutates_when": {"dry_run": false}}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.plan_archive_branch", "mutates_when": {"dry_run": false}, "mutation_risk": "low", "related_tools": ["agents.plan_patch", "agents.plan_get", "agents.graph_health", "agents.plan_compaction_preview"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Archive Branch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Archive a subtree by root_id — dry_run=true for archive_ids and bytes_saved_estimate; apply uses plan_patch op archive (id, not node_id). When live_child_count>0 pass reparent_live_to or archive leave"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_override": {"conditional_mutate": "dry_run=true returns archive_ids only; dry_run=false applies plan_patch archive.", "effect_depends_on_params": true, "mutates_when": {"dry_run": false}}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.plan_archive_branch", "mutates_when": {"dry_run": false}, "mutation_risk": "low", "related_tools": ["agents.plan_patch", "agents.plan_get", "agents.graph_health", "agents.plan_compaction_preview"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Archive Branch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Archive a subtree by root_id — dry_run=true for archive_ids and bytes_saved_estimate; apply uses plan_patch op archive (id, not node_id). When live_child_count>0 pass reparent_live_to or archive leave"}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true returns archive_ids only; dry_run=false applies plan_patch archive.", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "dry_run=true returns archive_ids only; dry_run=false applies plan_patch archive.", "effect_depends_on_params": true, "mutates_when": {"dry_run": false}}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Archive a subtree by root_id — dry_run=true for archive_ids and bytes_saved_estimate; apply uses pl…", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_patch", "agents.plan_get", "agents.graph_health", "agents.plan_compaction_preview"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_archive_branch", "semantic_input_mode": "inherit_workflow", "summary": "Preview or apply archive for a plan subtree (root_id). dry_run=true returns archive_ids and bytes_saved_estimate; apply sends plan_patch archive ops.", "title": "Agents Plan Archive Branch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Archive a subtree by root_id — dry_run=true for archive_ids and bytes_saved_estimate; apply uses plan_patch op archive (id, not node_id). When live_child_count>0 pass reparent_live_to or archive leave", "write_mode": null}, {"action": "agents.plan_reclaim_stale", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not substitute for plan_recovery_scan (read-only candidates).", "anti_patterns": ["Do not substitute for plan_recovery_scan (read-only candidates).", "Do not use when work_next already routes plan_claim — follow packet next_action."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_reclaim_stale", "mutation_risk": "low", "related_tools": ["agents.plan_get", "agents.plan_claim", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Reclaim Stale", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Clear expired in_progress plan_claim leases (DNA mutating). Use after expired_claim / stale lease from work_next — then plan_get + plan_claim with fresh if_match_revision. Omit env_uuid: reads generat"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_reclaim_stale", "mutation_risk": "low", "related_tools": ["agents.plan_get", "agents.plan_claim", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Reclaim Stale", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Clear expired in_progress plan_claim leases (DNA mutating). Use after expired_claim / stale lease from work_next — then plan_get + plan_claim with fresh if_match_revision. Omit env_uuid: reads generat"}, "do_not_use_when": "Do not substitute for plan_recovery_scan (read-only candidates).", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Preview stale claims after work_next expired_claim recovery branch", "request": {"dry_run": true, "home": "project_self", "project_id": 1}, "response": {"data": {"dry_run": true, "home": "project_self", "node_ids": ["n-stale-1"], "reclaimed_count": 1}, "success": true}}], "execution_class": "cheap", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Clear expired in_progress plan_claim leases (DNA mutating). Use after expired_claim / stale lease f…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_get", "agents.plan_claim", "agents.work_next"], "onboarding_tier": "domain_playbook", "operator_recovery_template": {"expired_claim": {"claim": {"action": "agents.plan_claim", "params": {"env_uuid": "<env_uuid_if_sandbox>", "home": "project", "if_match_revision": "<revision>", "node_ids": ["<node_id>"]}}, "reclaim": {"action": "agents.plan_reclaim_stale", "params": {"env_uuid": "<env_uuid_if_sandbox>", "home": "project"}}, "refresh": {"action": "agents.plan_get", "params": {"detail": "compact", "env_uuid": "<env_uuid_if_sandbox>", "home": "project", "if_match_revision": "<revision>"}}}}, "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "agents.plan_claim", "agents.work_next"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_reclaim_stale", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Return in_progress plan nodes with expired claim lease to ready (or pending if not eligible). Clears agent_id + lease meta; stamps meta.last_claim. Mutating DNA write — not read-only.", "title": "Reclaim Stale Claims", "wave_xix_atoms": {"MCP_DOMAIN_ERROR": "Domain denial: tools/call isError=false with structuredContent (ok=false, error_code, failure_kind=domain, recovery). Transport/internal uses isError=true (failure_kind=transport). plan_revision_conflict → agents.plan_get then retry with fresh if_match_revision.", "WG_BIND_VS_CLAIM": "node.agent_id binding ≠ active claim lease — already_claimed requires status=in_progress with non-expired lease meta; bound agent on ready/pending is not already_claimed; retry ensure_agent idempotent_replay or plan_claim with if_match_revision.", "WG_CAS_RETRY": "plan_revision_conflict → plan_get reload if_match_revision — never apply stale proposal after concurrent plan_patch or backlog apply.", "WG_CLOSED_LOOP_STALE_CLAIM": "blocked_reason=expired_claim — next_action agents.plan_reclaim_stale; beats downstream dependency_blocked when no executable leaf.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"expired_claim": {"en-US": "Stale lease — agents.plan_reclaim_stale, then plan_claim with a fresh if_match_revision", "pt-BR": "Lease expirado — agents.plan_reclaim_stale, depois plan_claim com if_match_revision novo", "ru-RU": "Истёк lease — agents.plan_reclaim_stale, затем plan_claim с новым if_match_revision"}, "plan_revision_conflict": {"en-US": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal", "pt-BR": "Conflito CAS — agents.plan_get recarregue if_match_revision; nunca apply proposal obsoleto", "ru-RU": "CAS конфликт — agents.plan_get перечитать if_match_revision; не apply устаревший proposal"}}, "when_not_to_use": "Do not substitute for plan_recovery_scan (read-only candidates).", "when_to_use": "Clear expired in_progress plan_claim leases (DNA mutating). Use after expired_claim / stale lease from work_next — then plan_get + plan_claim with fresh if_match_revision. Omit env_uuid: reads generat", "write_mode": null}, {"action": "agents.plan_ingest", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_ingest", "mutation_risk": "low", "related_tools": ["agents.plan_get", "agents.plan_execute", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Ingest", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append diagnostic or work-intake findings as stable graph nodes (no full-blob replace). home=project|self|project_self selects the leaf; env_uuid only with home=project. Follow with agents.plan_execut"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_ingest", "mutation_risk": "low", "related_tools": ["agents.plan_get", "agents.plan_execute", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Ingest", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append diagnostic or work-intake findings as stable graph nodes (no full-blob replace). home=project|self|project_self selects the leaf; env_uuid only with home=project. Follow with agents.plan_execut"}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Append diagnostic or work-intake findings as stable graph nodes (no full-blob replace). home=projec…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_get", "agents.plan_execute", "agents.work_next"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "agents.plan_execute", "agents.work_next"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_ingest", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Append diagnostic or work-intake findings as plan/Work Graph tasks. intake_mode=diagnostic (default) or work. Existing claimed nodes are left alone; matching issues bump occurrence_count.", "title": "Ingest Plan Work", "wave_xix_atoms": {"MCP_DOMAIN_ERROR": "Domain denial: tools/call isError=false with structuredContent (ok=false, error_code, failure_kind=domain, recovery). Transport/internal uses isError=true (failure_kind=transport). plan_revision_conflict → agents.plan_get then retry with fresh if_match_revision.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_PLANNING_ARTIFACT": "meta.planning_artifact nodes are evidence-only (resolution=non_executable_artifact) — attach evidence on parent; plan_process_backlog and claim skip them for execution."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append diagnostic or work-intake findings as stable graph nodes (no full-blob replace). home=project|self|project_self selects the leaf; env_uuid only with home=project. Follow with agents.plan_execut", "write_mode": null}, {"action": "agents.run_resume_packet", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.run_resume_packet", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Run Resume Packet", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "User says continue; new MCP client resumes an orchestration run."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.run_resume_packet", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Run Resume Packet", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "User says continue; new MCP client resumes an orchestration run."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "User says continue; new MCP client resumes an orchestration run.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_run_resume_packet", "semantic_input_mode": "inherit_workflow", "summary": "Cross-provider continuation: goal, step, packet, skills — no chat transcript.", "title": "Agents Run Resume Packet", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "User says continue; new MCP client resumes an orchestration run.", "write_mode": null}, {"action": "agents.run_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not use discovery.job_status for Agents Fleet runs — use agents.run_get with run_id.", "anti_patterns": ["Do not use discovery.job_status for Agents Fleet runs — use agents.run_get with run_id.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.run_get", "related_tools": ["agents.approve_run", "agents.traces"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Run Get", "when_blocked": {"agent_not_found": "agent_id not in project fleet — use agents.team or plan_get before run_get.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "run_mismatch": "run_id does not belong to the supplied agent_id — omit agent_id or fix the pair.", "run_not_found": "No run row for run_id in this project — verify run_id from agents.run or traces.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "waiting_for_approval": "Run status waiting_for_approval — agents.approve_run with approval_artifact_hash from run_detail."}, "when_to_use": "Inspect one fleet run by run_id (agent_id optional when run_id is set). Poll status here — not discovery.job_status. waiting_for_approval → agents.approve_run. Read run_detail.output.attachments (and "}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.run_get", "related_tools": ["agents.approve_run", "agents.traces"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Run Get", "when_blocked": {"agent_not_found": "agent_id not in project fleet — use agents.team or plan_get before run_get.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "run_mismatch": "run_id does not belong to the supplied agent_id — omit agent_id or fix the pair.", "run_not_found": "No run row for run_id in this project — verify run_id from agents.run or traces.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "waiting_for_approval": "Run status waiting_for_approval — agents.approve_run with approval_artifact_hash from run_detail."}, "when_to_use": "Inspect one fleet run by run_id (agent_id optional when run_id is set). Poll status here — not discovery.job_status. waiting_for_approval → agents.approve_run. Read run_detail.output.attachments (and "}, "do_not_use_when": "Do not use discovery.job_status for Agents Fleet runs — use agents.run_get with run_id.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Inspect one fleet run by run_id (agent_id optional when run_id is set). Poll status here — not disc…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.approve_run", "agents.traces"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.approve_run", "agents.traces"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_run_get", "semantic_input_mode": "inherit_workflow", "summary": "Get a run row plus normalized RunDetailDTO for cockpit/audit views.", "title": "Agents Run Get", "when_blocked": {"agent_not_found": "agent_id not in project fleet — use agents.team or plan_get before run_get.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "run_mismatch": "run_id does not belong to the supplied agent_id — omit agent_id or fix the pair.", "run_not_found": "No run row for run_id in this project — verify run_id from agents.run or traces.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "waiting_for_approval": "Run status waiting_for_approval — agents.approve_run with approval_artifact_hash from run_detail."}, "when_blocked_locales": {"agent_not_found": {"en-US": "agent_id not in fleet — agents.team or plan_get first", "pt-BR": "agent_id fora da frota — agents.team ou plan_get antes", "ru-RU": "agent_id нет во флоте — сначала agents.team или plan_get"}, "invalid_parameters": {"en-US": "project_id and run_id required — agent_id optional when run_id is set", "pt-BR": "project_id e run_id obrigatórios — agent_id opcional com run_id", "ru-RU": "Нужны project_id и run_id — agent_id опционален при run_id"}, "run_mismatch": {"en-US": "run_id does not match agent_id — omit agent_id or fix the pair", "pt-BR": "run_id não combina com agent_id — omita agent_id ou corrija o par", "ru-RU": "run_id не совпадает с agent_id — уберите agent_id или исправьте пару"}, "run_not_found": {"en-US": "No run for run_id — verify from agents.run or traces", "pt-BR": "Sem run para run_id — verifique agents.run ou traces", "ru-RU": "Нет run для run_id — проверьте agents.run или traces"}, "waiting_for_approval": {"en-US": "Run waiting_for_approval — agents.approve_run with approval_artifact_hash", "pt-BR": "Run waiting_for_approval — agents.approve_run com approval_artifact_hash", "ru-RU": "Run waiting_for_approval — agents.approve_run с approval_artifact_hash"}}, "when_not_to_use": "Do not use discovery.job_status for Agents Fleet runs — use agents.run_get with run_id.", "when_to_use": "Inspect one fleet run by run_id (agent_id optional when run_id is set). Poll status here — not discovery.job_status. waiting_for_approval → agents.approve_run. Read run_detail.output.attachments (and", "write_mode": null}, {"action": "agents.approve_run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.approve_run", "mutation_risk": "low", "related_tools": ["agents.run_get", "agents.traces"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Approve Run", "when_blocked": {"approval_hash_mismatch": "agents.run_get — approval_artifact_hash must match pending tool call on the run", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "run_not_found": "No run row for run_id in this project — verify run_id from agents.run or traces.", "run_not_waiting_for_approval": "agents.run_get — run is not waiting_for_approval; poll status before approve_run", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Human checkpoint after agents.run_get shows waiting_for_approval. Pass the hash from that response."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.approve_run", "mutation_risk": "low", "related_tools": ["agents.run_get", "agents.traces"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Approve Run", "when_blocked": {"approval_hash_mismatch": "agents.run_get — approval_artifact_hash must match pending tool call on the run", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "run_not_found": "No run row for run_id in this project — verify run_id from agents.run or traces.", "run_not_waiting_for_approval": "agents.run_get — run is not waiting_for_approval; poll status before approve_run", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Human checkpoint after agents.run_get shows waiting_for_approval. Pass the hash from that response."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Human checkpoint after agents.run_get shows waiting_for_approval. Pass the hash from that response.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.run_get", "agents.traces"], "required_cap": "agents_run|agents_approve", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_approve_run", "semantic_input_mode": "inherit_workflow", "summary": "Approve a run stuck in waiting_for_approval and resume execution.", "title": "Agents Approve Run", "when_blocked": {"approval_hash_mismatch": "agents.run_get — approval_artifact_hash must match pending tool call on the run", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "run_not_found": "No run row for run_id in this project — verify run_id from agents.run or traces.", "run_not_waiting_for_approval": "agents.run_get — run is not waiting_for_approval; poll status before approve_run", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Human checkpoint after agents.run_get shows waiting_for_approval. Pass the hash from that response.", "write_mode": null}, {"action": "agents.policy_preview", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.policy_preview", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Policy Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "UI live preview while editing AgentPolicy; debug effective allowlist."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.policy_preview", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Policy Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "UI live preview while editing AgentPolicy; debug effective allowlist."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "examples": [{"name": "Allowlist preview", "request": {"params": {"capabilities": ["agents.run", "knowledge.health"], "forbidden_tools": ["agents.delete"], "project_id": 1}, "tool": "agents.policy_preview"}, "response": {"data": {"denied": [], "effective_actions": []}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "UI live preview while editing AgentPolicy; debug effective allowlist.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"approval_required": {"description": "Actions needing human approval", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "denied": {"description": "Explicitly forbidden or unmatched actions", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "effective_actions": {"description": "MCP actions matching capability globs", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_policy_preview", "semantic_input_mode": "inherit_workflow", "summary": "Expand AgentPolicy patterns to live MCP actions (preview, no persistence).", "title": "Agents Policy Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "UI live preview while editing AgentPolicy; debug effective allowlist.", "write_mode": null}, {"action": "agents.templates_list", "aliases": ["agents.templates"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.templates_list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Templates List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover template_id before agents.create_from_template."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.templates_list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Templates List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover template_id before agents.create_from_template."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Built-in catalog", "request": {"params": {"project_id": 1}, "tool": "agents.templates_list"}, "response": {"data": {"templates": []}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Discover template_id before agents.create_from_template.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_templates_list", "semantic_input_mode": "inherit_workflow", "summary": "List built-in Agent Fleet templates (canonical Python catalog).", "title": "List Agent Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover template_id before agents.create_from_template.", "write_mode": null}, {"action": "agents.template_preview", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.template_preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Template Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Show users what a template will apply before create."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.template_preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Template Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Show users what a template will apply before create."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Non-persisting merge", "request": {"params": {"project_id": 1, "template_id": "frontend_developer@v1"}, "tool": "agents.template_preview"}, "response": {"data": {"agent_spec": {}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Show users what a template will apply before create.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_template_preview", "semantic_input_mode": "inherit_workflow", "summary": "Return merged AgentSpec-shaped preview for a template (no persistence).", "title": "Preview Agent Template", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Show users what a template will apply before create.", "write_mode": null}, {"action": "agents.create_from_template", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Use only when ensure_agent is ambiguous. Plan drafts stay on agents.plan_propose. Canonical provision is ensure_agent create=false then create=true.", "anti_patterns": ["Use only when ensure_agent is ambiguous. Plan drafts stay on agents.plan_propose. Canonical provision is ensure_agent cr", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.create_from_template", "mutation_risk": "low", "related_tools": ["agents.get", "agents.ensure_agent", "agents.plan_claim", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Create From Template", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "env_uuid_requires_node_id": "env_uuid only when binding node_id on a plan slice", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "invalid_template_id": "Unknown template_id in catalog", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be created under an open sandbox head without diff-child bootstrap (AA-10b). Fork generation env or clear head; then use scoped create overlay.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Spawn fleet row from template_id; optional node_id bind (ensure_agent uses plan_claim instead)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.create_from_template", "mutation_risk": "low", "related_tools": ["agents.get", "agents.ensure_agent", "agents.plan_claim", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Create From Template", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "env_uuid_requires_node_id": "env_uuid only when binding node_id on a plan slice", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "invalid_template_id": "Unknown template_id in catalog", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be created under an open sandbox head without diff-child bootstrap (AA-10b). Fork generation env or clear head; then use scoped create overlay.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Spawn fleet row from template_id; optional node_id bind (ensure_agent uses plan_claim instead)."}, "do_not_use_when": "Use only when ensure_agent is ambiguous. Plan drafts stay on agents.plan_propose. Canonical provision is ensure_agent create=false then create=true.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Spawn fleet row from template_id; optional node_id bind (ensure_agent uses plan_claim instead).", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["agents.ensure_agent", "agents.plan_claim", "agents.work_next"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.get", "agents.ensure_agent", "agents.plan_claim", "agents.work_next"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_create_from_template", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create an agent row from a built-in template (atomic merge on server). Fleet catalog rows are production-scoped; env_uuid applies when node_id binds the new agent onto a sandbox plan slice.", "title": "Create Agent from Template", "wave_xix_atoms": {"WG_ENSURE_H5": "agents.ensure_agent preview template_id must match agents.work_next top compatible_templates[0] for the same node (harness H5 / resolver_parity_v1).", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_PROVISION_PARITY": "When execution.fully_provisionable and one top template, recovery routes agents.ensure_agent create=false (H5 preview) — SDK followWorkGraphAction runs ensureAgentSaga for create=true; ambiguous ties → create_from_template choose_template."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "env_uuid_requires_node_id": "env_uuid only when binding node_id on a plan slice", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "invalid_template_id": "Unknown template_id in catalog", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be created under an open sandbox head without diff-child bootstrap (AA-10b). Fork generation env or clear head; then use scoped create overlay.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_not_to_use": "Use only when ensure_agent is ambiguous. Plan drafts stay on agents.plan_propose. Canonical provision is ensure_agent create=false then create=true.", "when_to_use": "Spawn fleet row from template_id; optional node_id bind (ensure_agent uses plan_claim instead).", "write_mode": null}, {"action": "agents.ensure_agent", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "When resolution=existing_agent prefer recovery.next_action / idempotent_replay or plan_claim — do not re-provision blindly.", "anti_patterns": ["When resolution=existing_agent prefer recovery.next_action / idempotent_replay or plan_claim — do not re-provision blind", "Do not call create=true without previewing template_id (H5 parity with work_next)."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"create": true}, "semantic_input_mode": "inherit_workflow"}, "effect_override": {"conditional_mutate": "create=false previews templates; create=true provisions fleet agent then plan_claim.", "effect_depends_on_params": true, "mutates_when": {"create": true}}, "execution_class": "cheap", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.ensure_agent", "mutates_when": {"create": true}, "mutation_risk": "low", "related_tools": ["agents.work_next", "agents.plan_get", "agents.plan_claim"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Ensure Agent", "when_blocked": {"capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "created_agent_not_eligible": "Provision rolled back — plan_propose mode=repair_plan or pick template with matching caps (H5)", "ensure_agent_stamp_mismatch": "Replay create=false preview; create=true must match preview_template_id + graph_revision", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_compatible_agent": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_focus_invalid": "agents.work_next detail=compact — refresh focus_node_id from packet next_action", "provision_required": "ensure_agent create=false (H5) then create=true then plan_claim", "provisioning_failed": "create_from_template or bind failed — retry agents.ensure_agent create=false (H5) then create=true", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "template_not_found": "agents.templates_list — template_id missing from catalog; agents.template_preview before create=true", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Commit-last provision: preview create=false (H5) → create=true (bind_node=False, explicit consent) → eligibility gate → next_action plan_claim with if_match_revision; idempotent_replay on retry."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"create": true}, "semantic_input_mode": "inherit_workflow"}, "effect_override": {"conditional_mutate": "create=false previews templates; create=true provisions fleet agent then plan_claim.", "effect_depends_on_params": true, "mutates_when": {"create": true}}, "execution_class": "cheap", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.ensure_agent", "mutates_when": {"create": true}, "mutation_risk": "low", "related_tools": ["agents.work_next", "agents.plan_get", "agents.plan_claim"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Ensure Agent", "when_blocked": {"capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "created_agent_not_eligible": "Provision rolled back — plan_propose mode=repair_plan or pick template with matching caps (H5)", "ensure_agent_stamp_mismatch": "Replay create=false preview; create=true must match preview_template_id + graph_revision", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_compatible_agent": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_focus_invalid": "agents.work_next detail=compact — refresh focus_node_id from packet next_action", "provision_required": "ensure_agent create=false (H5) then create=true then plan_claim", "provisioning_failed": "create_from_template or bind failed — retry agents.ensure_agent create=false (H5) then create=true", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "template_not_found": "agents.templates_list — template_id missing from catalog; agents.template_preview before create=true", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Commit-last provision: preview create=false (H5) → create=true (bind_node=False, explicit consent) → eligibility gate → next_action plan_claim with if_match_revision; idempotent_replay on retry."}, "do_not_use_when": "When resolution=existing_agent prefer recovery.next_action / idempotent_replay or plan_claim — do not re-provision blindly.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "create=false previews templates; create=true provisions fleet agent then plan_claim.", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "mutates_when": {"create": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "create=false previews templates; create=true provisions fleet agent then plan_claim.", "effect_depends_on_params": true, "mutates_when": {"create": true}}, "examples": [{"name": "Preview blocked executor", "request": {"params": {"create": false, "node_id": "task-b", "project_id": 1}, "tool": "agents.ensure_agent"}, "response": {"data": {"agent_id": null, "blocked_reason": "provision_required", "created": false, "node_id": "task-b", "template_id": "frontend_developer@v1"}, "success": true}}, {"description": "After work_next recovery routes here, create=true binds a fleet agent to the node.", "name": "Provision with create=true", "request": {"params": {"create": true, "node_id": "task-b", "project_id": 1}, "tool": "agents.ensure_agent"}, "response": {"data": {"agent_id": "619b1939-0000-4000-8000-000000000003", "created": true, "node_id": "task-b"}, "success": true}}], "execution_class": "cheap", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Commit-last provision: preview create=false (H5) → create=true (bind_node=False, explicit consent) …", "kind": "mcp_domain", "ladder": ["agents.plan_claim — CAS revision; role_mismatch → handoff not retry loop", "agents.plan_execute — only after claim; attach evidence for completion_predicates"], "mutation_kind": "none", "next_actions": ["agents.plan_claim"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "recovery_ladder": ["agents.plan_compaction_preview → agents.plan_heal_leaf (dry_run then apply) — spill_incomplete or plan_graph_too_large", "agents.plan_recovery_scan — verification_failed candidates + stale claims; optional env_uuid"], "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.work_next", "agents.plan_get", "agents.plan_claim"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_ensure_agent", "semantic_input_mode": "inherit_workflow", "summary": "Resolve or provision a plan-node executor. Read-only by default (effect.kind=read); create=true provisions from top compatible template with bind_node=False, validates eligibility, then returns next_a", "title": "Ensure Plan Executor", "wave_xix_atoms": {"MCP_DOMAIN_ERROR": "Domain denial: tools/call isError=false with structuredContent (ok=false, error_code, failure_kind=domain, recovery). Transport/internal uses isError=true (failure_kind=transport). plan_revision_conflict → agents.plan_get then retry with fresh if_match_revision.", "WG_BIND_VS_CLAIM": "node.agent_id binding ≠ active claim lease — already_claimed requires status=in_progress with non-expired lease meta; bound agent on ready/pending is not already_claimed; retry ensure_agent idempotent_replay or plan_claim with if_match_revision.", "WG_BLOCKED_REASON": "blocked_work[].blocked_reason is canonical (block_reason.REASON_PRIORITY); use recovery.next_actions — not validation.missing_roles.", "WG_CAPABILITY_HARD_GATE": "required_capabilities are mandatory — capability_mismatch blocks claim; route agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan; not handoff (capability_hard_gate_v1).", "WG_CAS_RETRY": "plan_revision_conflict → plan_get reload if_match_revision — never apply stale proposal after concurrent plan_patch or backlog apply.", "WG_ENSURE_CREATE_SAGA": "Commit-last provision: work_next blocked → ensure_agent create=false (H5 template_id) → create=true provisions with bind_node=False → eligibility gate → rollback on created_agent_not_eligible → next_action agents.plan_claim (bind+lease, if_match_revision); idempotent_replay when bound eligible agent exists.", "WG_ENSURE_H5": "agents.ensure_agent preview template_id must match agents.work_next top compatible_templates[0] for the same node (harness H5 / resolver_parity_v1).", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_PROVISION_PARITY": "When execution.fully_provisionable and one top template, recovery routes agents.ensure_agent create=false (H5 preview) — SDK followWorkGraphAction runs ensureAgentSaga for create=true; ambiguous ties → create_from_template choose_template.", "WG_ROLE_TAXONOMY": "no_compatible_agent for role=data|data_engineer is a taxonomy alias — prefer agents.ensure_agent create=false (H5) then create=true before repair_plan; create_from_template only when ensure_agent is ambiguous; role_matches_template in role_taxonomy.py is SoT."}, "when_blocked": {"capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "created_agent_not_eligible": "Provision rolled back — plan_propose mode=repair_plan or pick template with matching caps (H5)", "ensure_agent_stamp_mismatch": "Replay create=false preview; create=true must match preview_template_id + graph_revision", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_compatible_agent": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_focus_invalid": "agents.work_next detail=compact — refresh focus_node_id from packet next_action", "provision_required": "ensure_agent create=false (H5) then create=true then plan_claim", "provisioning_failed": "create_from_template or bind failed — retry agents.ensure_agent create=false (H5) then create=true", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "template_not_found": "agents.templates_list — template_id missing from catalog; agents.template_preview before create=true", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"capability_mismatch": {"en-US": "Missing required_capabilities — agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan. Not handoff.", "pt-BR": "required_capabilities ausentes — agents.ensure_agent create=false (H5) depois create=true, ou plan_propose mode=repair_plan. Não é handoff.", "ru-RU": "Нет required_capabilities — agents.ensure_agent create=false (H5) затем create=true, или plan_propose mode=repair_plan. Не handoff."}, "created_agent_not_eligible": {"en-US": "Rollback — plan_propose mode=repair_plan or template with matching caps (H5)", "pt-BR": "Rollback — plan_propose mode=repair_plan ou template com caps (H5)", "ru-RU": "Rollback — plan_propose mode=repair_plan или шаблон с caps (H5)"}, "ensure_agent_stamp_mismatch": {"en-US": "Stamp mismatch — replay create=false; create=true must match preview + revision", "pt-BR": "Stamp mismatch — repita create=false; create=true = preview + revision", "ru-RU": "Stamp mismatch — повторите create=false; create=true = preview + revision"}, "no_compatible_agent": {"en-US": "No fleet match — agents.ensure_agent create=false (H5) then create=true, or repair_plan", "pt-BR": "Sem agente na frota — agents.ensure_agent create=false (H5) depois create=true ou repair_plan", "ru-RU": "Нет агента во флоте — agents.ensure_agent create=false (H5) затем create=true или repair_plan"}, "provision_required": {"en-US": "Provision — agents.ensure_agent create=false (H5) then create=true, then plan_claim", "pt-BR": "Provisione — agents.ensure_agent create=false (H5) depois create=true, então plan_claim", "ru-RU": "Провижн — agents.ensure_agent create=false (H5) затем create=true, затем plan_claim"}}, "when_not_to_use": "When resolution=existing_agent prefer recovery.next_action / idempotent_replay or plan_claim — do not re-provision blindly.", "when_to_use": "Commit-last provision: preview create=false (H5) → create=true (bind_node=False, explicit consent) → eligibility gate → next_action plan_claim with if_match_revision; idempotent_replay on retry.", "write_mode": null}, {"action": "agents.automation_map", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.automation_map", "related_tools": ["agents.list", "logic.list", "social.support.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Automation Map", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Orchestration hub map before wiring agents to Logic or support."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.automation_map", "related_tools": ["agents.list", "logic.list", "social.support.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Automation Map", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Orchestration hub map before wiring agents to Logic or support."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Project automation hub", "request": {"params": {"project_id": 1}, "tool": "agents.automation_map"}, "response": {"data": {"agents": [], "support_bindings": [], "workflows": []}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Orchestration hub map before wiring agents to Logic or support.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.list", "logic.list", "social.support.inbox"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_automation_map", "semantic_input_mode": "inherit_workflow", "summary": "Fleet automation aggregate: triggers, Logic rule ids, support ownership.", "title": "Agents Automation Map", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Orchestration hub map before wiring agents to Logic or support.", "write_mode": null}, {"action": "agents.import_from_asset", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Importing fleet preset without generation.diff when auto_generation_mode is on.", "anti_patterns": ["Importing fleet preset without generation.diff when auto_generation_mode is on.", "Passing env_uuid when home is project_self or self.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.import_from_asset", "mutation_risk": "low", "related_tools": ["agents.get", "agents.run", "assets.get", "projects.orchestrator.import_from_asset"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Import From Asset", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be created under an open sandbox head without diff-child bootstrap (AA-10b). Fork generation env or clear head; then use scoped create overlay.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fulfill purchased agent template asset into Fleet."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.import_from_asset", "mutation_risk": "low", "related_tools": ["agents.get", "agents.run", "assets.get", "projects.orchestrator.import_from_asset"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Import From Asset", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be created under an open sandbox head without diff-child bootstrap (AA-10b). Fork generation env or clear head; then use scoped create overlay.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fulfill purchased agent template asset into Fleet."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Fulfill purchased agent template asset into Fleet.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.get", "agents.run", "assets.get", "projects.orchestrator.import_from_asset"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_import_from_asset", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create agent from commerce asset extensions.agent_fleet preset.", "title": "Agents Import From Asset", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be created under an open sandbox head without diff-child bootstrap (AA-10b). Fork generation env or clear head; then use scoped create overlay.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Fulfill purchased agent template asset into Fleet.", "write_mode": null}, {"action": "agents.fleet_diagnostics", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.fleet_diagnostics", "related_tools": ["agents.reconcile_binding", "agents.work_next", "agents.plan_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Fleet Diagnostics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fleet + orchestrator binding triage. On stale_orchestrator_binding_count or index mismatch, success payload includes next_action agents.reconcile_binding (repair=true). home=project|self|project_self "}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.fleet_diagnostics", "related_tools": ["agents.reconcile_binding", "agents.work_next", "agents.plan_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Fleet Diagnostics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fleet + orchestrator binding triage. On stale_orchestrator_binding_count or index mismatch, success payload includes next_action agents.reconcile_binding (repair=true). home=project|self|project_self "}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Fleet + orchestrator binding triage. On stale_orchestrator_binding_count or index mismatch, success…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.reconcile_binding", "agents.work_next", "agents.plan_get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.reconcile_binding", "agents.work_next", "agents.plan_get"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_fleet_diagnostics", "semantic_input_mode": "inherit_workflow", "summary": "Project fleet diagnostics: runs, queue, orchestrator agent binding.", "title": "Agents Fleet Diagnostics", "wave_xix_atoms": {"WG_BIND_VS_CLAIM": "node.agent_id binding ≠ active claim lease — already_claimed requires status=in_progress with non-expired lease meta; bound agent on ready/pending is not already_claimed; retry ensure_agent idempotent_replay or plan_claim with if_match_revision.", "WG_DISCOVERY_ROUTE": "Discovery naming: intent_id (taxonomy) ≠ primary_action (router verb) ≠ agents.work_next (fleet pick) — do not treat a route phrase as an MCP action name. discovery.describe requires param action=<catalog action id> (not optional).", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fleet + orchestrator binding triage. On stale_orchestrator_binding_count or index mismatch, success payload includes next_action agents.reconcile_binding (repair=true). home=project|self|project_self", "write_mode": null}, {"action": "agents.skills_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.instruction_plane.gen1"], "id": "agents.skills_list", "related_tools": ["agents.skills_get", "agents.skills_preview", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Skills List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Instruction plane — discover skill ids before orchestrate."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.instruction_plane.gen1"], "id": "agents.skills_list", "related_tools": ["agents.skills_get", "agents.skills_preview", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Skills List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Instruction plane — discover skill ids before orchestrate."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "List skill cards", "request": {"params": {"project_id": 1}, "tool": "agents.skills_list"}, "response": {"data": {"skills": [{"id": "coding.kiss"}]}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Instruction plane — discover skill ids before orchestrate.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.skills_get", "agents.skills_preview", "discovery.describe"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_skills_list", "semantic_input_mode": "inherit_workflow", "summary": "List ecosystem skill cards (fixture + optional ecosystem overlay).", "title": "Agents Skills List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Instruction plane — discover skill ids before orchestrate.", "write_mode": null}, {"action": "agents.skills_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.instruction_plane.gen1"], "id": "agents.skills_get", "related_tools": ["agents.skills_list", "agents.skills_preview", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Skills Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "MCP interop — load procedure text for external agents."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.instruction_plane.gen1"], "id": "agents.skills_get", "related_tools": ["agents.skills_list", "agents.skills_preview", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Skills Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "MCP interop — load procedure text for external agents."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Full skill card", "request": {"params": {"project_id": 1, "skill_id": "coding.kiss"}, "tool": "agents.skills_get"}, "response": {"data": {"skill": {"id": "coding.kiss"}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "MCP interop — load procedure text for external agents.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.skills_list", "agents.skills_preview", "discovery.describe"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_skills_get", "semantic_input_mode": "inherit_workflow", "summary": "Fetch one skill card. Procedure text comes back whole until 64000 characters. truncated means chars is longer than text; that prefix is not the procedure to save.", "title": "Agents Skills Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "MCP interop — load procedure text for external agents.", "write_mode": null}, {"action": "agents.skills_preview", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.skills_preview", "related_tools": ["agents.skills_get", "agents.skills_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Skills Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compose packet skill_preview without full bodies."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.skills_preview", "related_tools": ["agents.skills_get", "agents.skills_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Skills Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compose packet skill_preview without full bodies."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Preview excerpts", "request": {"params": {"project_id": 1, "skill_ids": ["coding.kiss"]}, "tool": "agents.skills_preview"}, "response": {"data": {"previews": [{"id": "coding.kiss"}]}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Compose packet skill_preview without full bodies.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.skills_get", "agents.skills_list"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_skills_preview", "semantic_input_mode": "inherit_workflow", "summary": "Short skill preview for instruction packet (title + excerpt).", "title": "Agents Skills Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compose packet skill_preview without full bodies.", "write_mode": null}, {"action": "agents.team.create", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.orchestrator.gen1"], "id": "agents.team.create", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Team Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Team/specialist fleet goals — thin wrapper over plan_ingest playbook + optional orchestrate. home=project|self|project_self; env_uuid only with home=project. Prefer over raw integrations.oauth_begin f"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.orchestrator.gen1"], "id": "agents.team.create", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Team Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Team/specialist fleet goals — thin wrapper over plan_ingest playbook + optional orchestrate. home=project|self|project_self; env_uuid only with home=project. Prefer over raw integrations.oauth_begin f"}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"conditional_mutate": "ingest_playbook_plan_nodes on routed team.create goal", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Team/specialist fleet goals — thin wrapper over plan_ingest playbook + optional orchestrate. home=p…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_team_create", "semantic_input_mode": "inherit_workflow", "summary": "Thin wrapper: plan_ingest team template + optional orchestrate focus.", "title": "Agents Team Create", "wave_xix_atoms": {"WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_PLAN_FIRST": "Lightweight progress: agents.work_status (summary_only). Full autonomous loop: agents.work_next — follow next_action, not next_actions[0] parsing.", "WG_TEAM_OVER_INTEGRATION": "Team-create goals (agents.team.create): discovery rank demotes integrations.* — prefer agents.team.create / agents.orchestrate / agents.plan_* over integrations.oauth_begin."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Team/specialist fleet goals — thin wrapper over plan_ingest playbook + optional orchestrate. home=project|self|project_self; env_uuid only with home=project. Prefer over raw integrations.oauth_begin f", "write_mode": null}, {"action": "agents.plan_execute", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not execute without claim lease unless operator policy allows.", "anti_patterns": ["Do not execute without claim lease unless operator policy allows."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.agents.orchestrator.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_execute", "mutation_risk": "low", "recovery_blocks": {"orchestrator_binding_stale": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "orchestrator_binding_stale"}}, "related_tools": ["agents.work_next", "agents.plan_get", "agents.plan_claim"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Plan Execute", "when_blocked": {"capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_executable": "kind note and catalog are memory, not work. Do not plan_claim them. Claim a task, step, or issue on the same home.", "orchestrator_binding_stale": "agents.reconcile_binding repair=true", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_claim_required": "agents.plan_claim if_match_revision — in_progress lease before agents.plan_execute", "plan_completion_blocked": "Attach completion_predicates evidence; do not retry agents.plan_execute until allowed", "plan_focus_invalid": "agents.work_next detail=compact — refresh focus_node_id from packet next_action", "provision_required": "ensure_agent create=false (H5) then create=true then plan_claim", "run_failed": "agents.work_next detail=compact — inspect run traces; repair_plan or reclaim before retry", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verification_failed": "agents.plan_recovery_scan → plan_propose mode=repair_plan", "waiting_for_approval": "Run status waiting_for_approval — agents.approve_run with approval_artifact_hash from run_detail."}, "when_to_use": "Run closed-loop execute for a claimed leaf. Attach evidence for completion_predicates; read execution_summary from prior work_next when blocked. wait=true (default) polls fleet run up to wait_timeout_"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.agents.orchestrator.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_execute", "mutation_risk": "low", "recovery_blocks": {"orchestrator_binding_stale": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "orchestrator_binding_stale"}}, "related_tools": ["agents.work_next", "agents.plan_get", "agents.plan_claim"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Plan Execute", "when_blocked": {"capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_executable": "kind note and catalog are memory, not work. Do not plan_claim them. Claim a task, step, or issue on the same home.", "orchestrator_binding_stale": "agents.reconcile_binding repair=true", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_claim_required": "agents.plan_claim if_match_revision — in_progress lease before agents.plan_execute", "plan_completion_blocked": "Attach completion_predicates evidence; do not retry agents.plan_execute until allowed", "plan_focus_invalid": "agents.work_next detail=compact — refresh focus_node_id from packet next_action", "provision_required": "ensure_agent create=false (H5) then create=true then plan_claim", "run_failed": "agents.work_next detail=compact — inspect run traces; repair_plan or reclaim before retry", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verification_failed": "agents.plan_recovery_scan → plan_propose mode=repair_plan", "waiting_for_approval": "Run status waiting_for_approval — agents.approve_run with approval_artifact_hash from run_detail."}, "when_to_use": "Run closed-loop execute for a claimed leaf. Attach evidence for completion_predicates; read execution_summary from prior work_next when blocked. wait=true (default) polls fleet run up to wait_timeout_"}, "do_not_use_when": "Do not execute without claim lease unless operator policy allows.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "heavy", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "heavy", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Run closed-loop execute for a claimed leaf. Attach evidence for completion_predicates; read executi…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.work_next", "agents.plan_get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"action_readiness": {"description": "Executable vs actionable gate", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "error_code": {"description": "Structured code when success=false (waiting_for_approval, run_failed, …)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "next_action": {"description": "agents.work_next on success; agents.approve_run when paused_for_approval", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "next_actions": {"description": "Poll/approval ladder from fleet hints when run in flight", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "paused_for_approval": {"description": "True when wait=true and run needs agents.approve_run", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "plan_completion": {"description": "Completion engine receipt for focus node", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "plan_revision": {"description": "CAS revision after execute", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "run": {"description": "Fleet run envelope when resolve_and_run enqueues", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "run.agent_run_spec.output.message": {"description": "Primary assistant text when wait=true (also output.text / output.summary)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "run_status": {"description": "Terminal fleet status when wait=true (completed, failed, waiting_for_approval, …)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "run_succeeded": {"description": "False when run failed or paused for approval", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "work_state": {"description": "Harness work_state after execute", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.work_next", "agents.plan_get", "agents.plan_claim"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_execute", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Run orchestrator focused on current plan graph (alias for orchestrate with plan focus). Returns plan_revision / completion decision when available.", "title": "Execute Plan Node", "wave_xix_atoms": {"WG_AUTONOMOUS_CLAIM_REQUIRED": "When context.autonomous_mode is true, agents.plan_execute is denied unless the focus node status is in_progress (plan_claim_required). Claim via agents.plan_claim before execute in the mcp_work_loop_v1 spine.", "WG_CAPABILITY_HARD_GATE": "required_capabilities are mandatory — capability_mismatch blocks claim; route agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan; not handoff (capability_hard_gate_v1).", "WG_CLAIM_BEFORE_EXECUTE": "agents.plan_execute requires an active claim lease from agents.plan_claim unless operator policy allows execute-without-claim; pass if_match_revision from plan_get.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_EXECUTION_SUMMARY_ONLY": "Read execution_summary.missing_requirements — missing_roles is legacy; do not infer fleet gaps from validation.missing_roles when execution_summary is present.", "WG_PLAN_EXECUTE_HANDOFF": "After agents.plan_execute success (wait=true completed), follow data.next_action (usually agents.work_next) — do not invent a parallel loop from prose."}, "when_blocked": {"capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_executable": "kind note and catalog are memory, not work. Do not plan_claim them. Claim a task, step, or issue on the same home.", "orchestrator_binding_stale": "agents.reconcile_binding repair=true", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_claim_required": "agents.plan_claim if_match_revision — in_progress lease before agents.plan_execute", "plan_completion_blocked": "Attach completion_predicates evidence; do not retry agents.plan_execute until allowed", "plan_focus_invalid": "agents.work_next detail=compact — refresh focus_node_id from packet next_action", "provision_required": "ensure_agent create=false (H5) then create=true then plan_claim", "run_failed": "agents.work_next detail=compact — inspect run traces; repair_plan or reclaim before retry", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verification_failed": "agents.plan_recovery_scan → plan_propose mode=repair_plan", "waiting_for_approval": "Run status waiting_for_approval — agents.approve_run with approval_artifact_hash from run_detail."}, "when_blocked_locales": {"capability_mismatch": {"en-US": "Missing required_capabilities — agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan. Not handoff.", "pt-BR": "required_capabilities ausentes — agents.ensure_agent create=false (H5) depois create=true, ou plan_propose mode=repair_plan. Não é handoff.", "ru-RU": "Нет required_capabilities — agents.ensure_agent create=false (H5) затем create=true, или plan_propose mode=repair_plan. Не handoff."}, "invalid_parameters": {"en-US": "project_id and run_id required — agent_id optional when run_id is set", "pt-BR": "project_id e run_id obrigatórios — agent_id opcional com run_id", "ru-RU": "Нужны project_id и run_id — agent_id опционален при run_id"}, "permission_denied": {"en-US": "RBAC denied — rbac.check_permission, membership, or dev-operator persona", "pt-BR": "RBAC negado — rbac.check_permission, membership ou persona dev-operator", "ru-RU": "RBAC отказ — rbac.check_permission, членство или dev-operator persona"}, "plan_claim_required": {"en-US": "Claim lease first — agents.plan_claim with if_match_revision, then agents.plan_execute", "pt-BR": "Lease primeiro — agents.plan_claim com if_match_revision, depois agents.plan_execute", "ru-RU": "Сначала lease — agents.plan_claim с if_match_revision, затем agents.plan_execute"}, "plan_completion_blocked": {"en-US": "Completion blocked — attach completion_predicates evidence; do not retry plan_execute", "pt-BR": "Conclusão bloqueada — anexe completion_predicates; não repita plan_execute", "ru-RU": "Завершение заблокировано — приложите completion_predicates; не повторяйте plan_execute"}, "provision_required": {"en-US": "Provision — agents.ensure_agent create=false (H5) then create=true, then plan_claim", "pt-BR": "Provisione — agents.ensure_agent create=false (H5) depois create=true, então plan_claim", "ru-RU": "Провижн — agents.ensure_agent create=false (H5) затем create=true, затем plan_claim"}, "run_failed": {"en-US": "Run failed — agents.work_next then traces or plan_recovery_scan before retry", "pt-BR": "Run failed — agents.work_next, depois traces ou plan_recovery_scan antes de retry", "ru-RU": "Run failed — agents.work_next, затем traces или plan_recovery_scan перед retry"}, "verification_failed": {"en-US": "Verification failed — agents.plan_recovery_scan → plan_propose mode=repair_plan", "pt-BR": "Verificação falhou — agents.plan_recovery_scan → plan_propose mode=repair_plan", "ru-RU": "Верификация не прошла — agents.plan_recovery_scan → plan_propose mode=repair_plan"}, "waiting_for_approval": {"en-US": "Run waiting_for_approval — agents.approve_run with approval_artifact_hash", "pt-BR": "Run waiting_for_approval — agents.approve_run com approval_artifact_hash", "ru-RU": "Run waiting_for_approval — agents.approve_run с approval_artifact_hash"}}, "when_not_to_use": "Do not execute without claim lease unless operator policy allows.", "when_to_use": "Run closed-loop execute for a claimed leaf. Attach evidence for completion_predicates; read execution_summary from prior work_next when blocked. wait=true (default) polls fleet run up to wait_timeout_", "write_mode": null}, {"action": "agents.plan_suggest_tree", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_suggest_tree", "related_tools": ["agents.plan_propose", "agents.plan_apply_proposal"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Suggest Tree", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only nested plan tree draft from goal_text — no DNA write. Persist via agents.plan_propose with draft_tree or plan_apply_proposal after review."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_suggest_tree", "related_tools": ["agents.plan_propose", "agents.plan_apply_proposal"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Suggest Tree", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only nested plan tree draft from goal_text — no DNA write. Persist via agents.plan_propose with draft_tree or plan_apply_proposal after review."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Read-only nested plan tree draft from goal_text — no DNA write. Persist via agents.plan_propose wit…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_propose", "agents.plan_apply_proposal"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_propose", "agents.plan_apply_proposal"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_plan_suggest_tree", "semantic_input_mode": "inherit_workflow", "summary": "Suggest a nested plan tree draft from a goal (read-only). Does not mutate task_list — use plan_propose/create_plan + plan_apply_proposal to persist.", "title": "Agents Plan Suggest Tree", "wave_xix_atoms": {"WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_PLANNER_PLANE": "Backlog scan uses planner eligibility (decomposition_status=needed) — not execution_ready; validation_ok reflects plan_valid (structural+semantic), not fleet gaps.", "WG_PLANNING_ARTIFACT": "meta.planning_artifact nodes are evidence-only (resolution=non_executable_artifact) — attach evidence on parent; plan_process_backlog and claim skip them for execution."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only nested plan tree draft from goal_text — no DNA write. Persist via agents.plan_propose with draft_tree or plan_apply_proposal after review.", "write_mode": null}, {"action": "agents.plan_propose", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not patch task_list directly for multi-node decompositions — use propose + apply.", "anti_patterns": ["Do not patch task_list directly for multi-node decompositions — use propose + apply.", "validation.missing_roles alone is legacy; prefer missing_specializations / execution_summary."], "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "heavy", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_propose", "related_tools": ["agents.plan_get", "agents.plan_apply_proposal", "agents.work_next", "discovery.describe"], "semantic_input_mode": "per_step_nl", "source": "overlay", "title": "Agents Plan Propose", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_required_dependency": "agents.plan_propose mode=decompose_node or repair_plan — facet DAG edge missing (storage→knowledge, logic→scheduler); inspect dependencies_to_add", "mode_not_implemented": "Use create_plan | decompose_node | replan_subtree | repair_plan | optimize_plan — discovery.describe agents.plan_propose", "node_already_atomic": "Complexity too low to decompose — agents.work_next or agents.plan_get for another leaf", "node_not_found": "agents.plan_get include_claimable=true — node_id absent from graph slice", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "planner_duplicate_children": "agents.plan_get — semantic facet children already exist; re-propose is a no-op or use mode=replan_subtree", "replan_budget_exceeded": "Max replans per node exceeded — agents.plan_propose mode=repair_plan on parent or escalation", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "supersede_in_progress": "agents.plan_get then wait/retry — in-progress node cannot be superseded without options.force_supersede_in_progress (retryable)", "unknown_skill_id": "Fix node skill_ids to ecosystem catalog (agents.skills_list); use rag.retrieval / rag.ingest_acceptance — not MCP action names; re-run plan_propose after enrich", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal"}, "when_to_use": "Open the graph for durable work: draft only, no DNA write. persist_unexecutable if fleet gaps; check execution_summary before apply. supersede_in_progress or planner_duplicate_children -> plan_get."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "heavy", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_propose", "related_tools": ["agents.plan_get", "agents.plan_apply_proposal", "agents.work_next", "discovery.describe"], "semantic_input_mode": "per_step_nl", "source": "overlay", "title": "Agents Plan Propose", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_required_dependency": "agents.plan_propose mode=decompose_node or repair_plan — facet DAG edge missing (storage→knowledge, logic→scheduler); inspect dependencies_to_add", "mode_not_implemented": "Use create_plan | decompose_node | replan_subtree | repair_plan | optimize_plan — discovery.describe agents.plan_propose", "node_already_atomic": "Complexity too low to decompose — agents.work_next or agents.plan_get for another leaf", "node_not_found": "agents.plan_get include_claimable=true — node_id absent from graph slice", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "planner_duplicate_children": "agents.plan_get — semantic facet children already exist; re-propose is a no-op or use mode=replan_subtree", "replan_budget_exceeded": "Max replans per node exceeded — agents.plan_propose mode=repair_plan on parent or escalation", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "supersede_in_progress": "agents.plan_get then wait/retry — in-progress node cannot be superseded without options.force_supersede_in_progress (retryable)", "unknown_skill_id": "Fix node skill_ids to ecosystem catalog (agents.skills_list); use rag.retrieval / rag.ingest_acceptance — not MCP action names; re-run plan_propose after enrich", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal"}, "when_to_use": "Open the graph for durable work: draft only, no DNA write. persist_unexecutable if fleet gaps; check execution_summary before apply. supersede_in_progress or planner_duplicate_children -> plan_get."}, "do_not_use_when": "Do not patch task_list directly for multi-node decompositions — use propose + apply.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "conditional_mutate": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "effect_kind": "read", "examples": [{"description": "env_uuid pairs with plan_apply_proposal on the same sandbox fork. validation.execution.execution_summary rolls up per-node dependency_ready vs execution_ready fleet gaps.", "name": "Decompose with sandbox anchor", "request": {"params": {"env_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "mode": "decompose_node", "node_id": "obj-1", "project_id": 1}, "tool": "agents.plan_propose"}, "response": {"data": {"validation": {"executable_now": false, "execution": {"execution_summary": {"missing_specializations": ["frontend_developer"], "per_node": [{"execution_ready": false, "node_id": "child-1", "resolution": "provision_required"}], "provisionable_specializations": ["frontend_developer"]}, "fully_provisionable": true}, "plan_valid": true}}, "success": true}}, {"description": "After agents.plan_recovery_scan surfaces verification_failed, propose a repair without mutating DNA until plan_apply_proposal.", "name": "Repair plan after verification_failed", "request": {"params": {"env_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "mode": "repair_plan", "node_id": "leaf-verify", "project_id": 1}, "tool": "agents.plan_propose"}, "response": {"data": {"validation": {"execution": {"execution_summary": {"per_node": [{"node_id": "leaf-verify", "verification_failed": true}]}}, "plan_valid": true}}, "success": true}}], "execution_class": "heavy", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Open the graph for durable work: draft only, no DNA write. persist_unexecutable if fleet gaps; chec…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_apply_proposal", "agents.plan_get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "agents.plan_apply_proposal", "agents.work_next", "discovery.describe"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_plan_propose", "semantic_input_mode": "per_step_nl", "summary": "Build a validated planner proposal (draft) for create_plan or decompose_node. Does not mutate task_list — call agents.plan_apply_proposal to persist.", "title": "Propose Plan Changes", "wave_xix_atoms": {"WG_ALLOW_GENERIC_ACCEPTANCE": "allow_generic_acceptance defaults false; repair_plan / sandbox repair only — never default on complexity ≥3 decompose.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_FACET_REPAIR": "plan_propose runs ensure_proposal_facet_coverage (facet_repair, max 2 passes) after enrich for create_plan and decompose_node (including from_draft_tree meta under create_plan) — do not hand-patch semantic facet children; for facet gaps after other modes use mode=repair_plan.", "WG_OPTIMIZE_EXEC_STABLE": "optimize_plan must not change executable_now unless patches touch required_role, skill_ids, or completion criteria — check validation.execution.execution_summary.", "WG_PERSIST_UNEXECUTABLE": "validation_mode=persist_unexecutable on plan_propose / plan_apply_proposal / plan_process_backlog when plan_valid but fleet cannot execute — use the same mode on propose and apply.", "WG_PLANNER_PLANE": "Backlog scan uses planner eligibility (decomposition_status=needed) — not execution_ready; validation_ok reflects plan_valid (structural+semantic), not fleet gaps.", "WG_PLAN_VALID_NOT_EXECUTABLE": "plan_valid / validation_ok means structural+semantic OK — not fleet-executable; use validation_mode=persist_unexecutable or ensure_agent when plan_valid but not execution_ready; executable_now=false under semantic alias is intentional.", "WG_RECOVERY_VERIFICATION_FAILED": "Recovery reason SoT is verification_failed (aliases verify_failed, plan_verify_failed) — call agents.plan_recovery_scan first, then plan_propose mode=repair_plan via recovery.next_actions (not missing_roles).", "WG_ROLE_TAXONOMY": "no_compatible_agent for role=data|data_engineer is a taxonomy alias — prefer agents.ensure_agent create=false (H5) then create=true before repair_plan; create_from_template only when ensure_agent is ambiguous; role_matches_template in role_taxonomy.py is SoT."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_required_dependency": "agents.plan_propose mode=decompose_node or repair_plan — facet DAG edge missing (storage→knowledge, logic→scheduler); inspect dependencies_to_add", "mode_not_implemented": "Use create_plan | decompose_node | replan_subtree | repair_plan | optimize_plan — discovery.describe agents.plan_propose", "node_already_atomic": "Complexity too low to decompose — agents.work_next or agents.plan_get for another leaf", "node_not_found": "agents.plan_get include_claimable=true — node_id absent from graph slice", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "planner_duplicate_children": "agents.plan_get — semantic facet children already exist; re-propose is a no-op or use mode=replan_subtree", "replan_budget_exceeded": "Max replans per node exceeded — agents.plan_propose mode=repair_plan on parent or escalation", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "supersede_in_progress": "agents.plan_get then wait/retry — in-progress node cannot be superseded without options.force_supersede_in_progress (retryable)", "unknown_skill_id": "Fix node skill_ids to ecosystem catalog (agents.skills_list); use rag.retrieval / rag.ingest_acceptance — not MCP action names; re-run plan_propose after enrich", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal"}, "when_blocked_locales": {"missing_required_dependency": {"en-US": "Facet DAG edge missing — agents.plan_get then plan_propose decompose_node or repair_plan", "pt-BR": "Aresta DAG ausente — agents.plan_get depois plan_propose decompose_node ou repair_plan", "ru-RU": "Нет ребра DAG — agents.plan_get затем plan_propose decompose_node или repair_plan"}, "plan_revision_conflict": {"en-US": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal", "pt-BR": "Conflito CAS — agents.plan_get recarregue if_match_revision; nunca apply proposal obsoleto", "ru-RU": "CAS конфликт — agents.plan_get перечитать if_match_revision; не apply устаревший proposal"}, "planner_duplicate_children": {"en-US": "Duplicate facet children — agents.plan_get; skip re-propose or use mode=replan_subtree", "pt-BR": "Filhos facet duplicados — agents.plan_get; pule re-propose ou use mode=replan_subtree", "ru-RU": "Дубли facet children — agents.plan_get; не re-propose или mode=replan_subtree"}, "supersede_in_progress": {"en-US": "In-progress supersede blocked — agents.plan_get, wait/retry (or force_supersede_in_progress)", "pt-BR": "Supersede in_progress bloqueado — agents.plan_get, aguarde/retry (ou force_supersede_in_progress)", "ru-RU": "Supersede in_progress заблокирован — agents.plan_get, wait/retry (или force_supersede_in_progress)"}, "unknown_skill_id": {"en-US": "Fix skill_ids — agents.skills_list, use rag.* catalog ids, re-run plan_propose", "pt-BR": "Corrija skill_ids — agents.skills_list, ids do catálogo rag.*, plan_propose de novo", "ru-RU": "Исправь skill_ids — agents.skills_list, id из каталога rag.*, снова plan_propose"}}, "when_not_to_use": "Do not patch task_list directly for multi-node decompositions — use propose + apply.", "when_to_use": "Open the graph for durable work: draft only, no DNA write. persist_unexecutable if fleet gaps; check execution_summary before apply. supersede_in_progress or planner_duplicate_children -> plan_get.", "write_mode": null}, {"action": "agents.plan_apply_proposal", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not apply without reviewing validation.execution.execution_summary.", "anti_patterns": ["Do not apply without reviewing validation.execution.execution_summary.", "Do not pass a different env_uuid than the paired plan_propose on sandbox forks."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_apply_proposal", "mutation_risk": "low", "related_tools": ["agents.plan_get", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Apply Proposal", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal"}, "when_to_use": "Persist a validated proposal. Same env_uuid and validation_mode as paired plan_propose."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_apply_proposal", "mutation_risk": "low", "related_tools": ["agents.plan_get", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Apply Proposal", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal"}, "when_to_use": "Persist a validated proposal. Same env_uuid and validation_mode as paired plan_propose."}, "do_not_use_when": "Do not apply without reviewing validation.execution.execution_summary.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "heavy", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Apply replan with supersede", "request": {"params": {"if_match_revision": 12, "project_id": 1, "proposal": {"base_graph_revision": 12, "dependencies_to_add": [["task-b", "task-a"]], "mode": "replan_subtree", "nodes_to_create": [], "nodes_to_supersede": ["stale-task-1"], "nodes_to_update": [], "preserve_completed": true, "proposal_id": "pp-replan-demo", "supersede_reason": "replan_subtree"}}, "tool": "agents.plan_apply_proposal"}}], "execution_class": "heavy", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Persist a validated proposal. Same env_uuid and validation_mode as paired plan_propose.", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_get", "agents.work_next"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "agents.work_next"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_apply_proposal", "semantic_input_mode": "inherit_workflow", "summary": "Apply a planner proposal to the Work Graph with CAS (if_match_revision). Pass proposal from plan_propose and base_graph_revision unchanged.", "title": "Apply Plan Proposal", "wave_xix_atoms": {"MCP_DOMAIN_ERROR": "Domain denial: tools/call isError=false with structuredContent (ok=false, error_code, failure_kind=domain, recovery). Transport/internal uses isError=true (failure_kind=transport). plan_revision_conflict → agents.plan_get then retry with fresh if_match_revision.", "WG_CAS_RETRY": "plan_revision_conflict → plan_get reload if_match_revision — never apply stale proposal after concurrent plan_patch or backlog apply.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_EXECUTION_SUMMARY_ONLY": "Read execution_summary.missing_requirements — missing_roles is legacy; do not infer fleet gaps from validation.missing_roles when execution_summary is present.", "WG_PERSIST_UNEXECUTABLE": "validation_mode=persist_unexecutable on plan_propose / plan_apply_proposal / plan_process_backlog when plan_valid but fleet cannot execute — use the same mode on propose and apply."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal"}, "when_blocked_locales": {"plan_revision_conflict": {"en-US": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal", "pt-BR": "Conflito CAS — agents.plan_get recarregue if_match_revision; nunca apply proposal obsoleto", "ru-RU": "CAS конфликт — agents.plan_get перечитать if_match_revision; не apply устаревший proposal"}}, "when_not_to_use": "Do not apply without reviewing validation.execution.execution_summary.", "when_to_use": "Persist a validated proposal. Same env_uuid and validation_mode as paired plan_propose.", "write_mode": null}, {"action": "agents.plan_process_backlog", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not auto_apply on production without operator tier and explicit auto_apply_policy.", "anti_patterns": ["Do not auto_apply on production without operator tier and explicit auto_apply_policy."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"auto_apply": true, "auto_apply_policy": "safe"}, "semantic_input_mode": "inherit_workflow"}, "effect_override": {"conditional_mutate": "auto_apply_policy off = propose only; safe|force applies planner patches (mutate).", "effect_depends_on_params": true, "mutates_when": {"auto_apply": true, "auto_apply_policy": "safe"}}, "execution_class": "heavy", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_process_backlog", "mutates_when": {"auto_apply": true, "auto_apply_policy": "safe"}, "mutation_risk": "low", "related_tools": ["agents.plan_apply_proposal", "agents.plan_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Process Backlog", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "replan_budget_exceeded": "Max replans per node exceeded — agents.plan_propose mode=repair_plan on parent or escalation", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal"}, "when_to_use": "Scan decomposition backlog (planner plane) on home=project|self|project_self; env_uuid only with home=project. auto_apply_policy=off default; validation_mode=persist_unexecutable for intake-only; vali"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"auto_apply": true, "auto_apply_policy": "safe"}, "semantic_input_mode": "inherit_workflow"}, "effect_override": {"conditional_mutate": "auto_apply_policy off = propose only; safe|force applies planner patches (mutate).", "effect_depends_on_params": true, "mutates_when": {"auto_apply": true, "auto_apply_policy": "safe"}}, "execution_class": "heavy", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_process_backlog", "mutates_when": {"auto_apply": true, "auto_apply_policy": "safe"}, "mutation_risk": "low", "related_tools": ["agents.plan_apply_proposal", "agents.plan_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Process Backlog", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "replan_budget_exceeded": "Max replans per node exceeded — agents.plan_propose mode=repair_plan on parent or escalation", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal"}, "when_to_use": "Scan decomposition backlog (planner plane) on home=project|self|project_self; env_uuid only with home=project. auto_apply_policy=off default; validation_mode=persist_unexecutable for intake-only; vali"}, "do_not_use_when": "Do not auto_apply on production without operator tier and explicit auto_apply_policy.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "auto_apply_policy off = propose only; safe|force applies planner patches (mutate).", "effect_depends_on_params": true, "execution_class": "heavy", "generation": false, "kind": "mutate", "mutates_when": {"auto_apply": true, "auto_apply_policy": "safe"}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "auto_apply_policy off = propose only; safe|force applies planner patches (mutate).", "effect_depends_on_params": true, "mutates_when": {"auto_apply": true, "auto_apply_policy": "safe"}}, "examples": [{"description": "auto_apply_policy=off — proposals returned in results; no DNA mutation.", "name": "Propose-only backlog scan", "request": {"params": {"auto_apply_policy": "off", "env_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "max_nodes": 1, "project_id": 1}, "tool": "agents.plan_process_backlog"}, "response": {"data": {"candidates": [{"mode": "decompose_node", "node_id": "obj-1"}], "results": [{"applied": false, "node_id": "obj-1", "validation": {"execution": {"execution_summary": {"execution_ready": false}}}}]}, "success": true}}], "execution_class": "heavy", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Scan decomposition backlog (planner plane) on home=project|self|project_self; env_uuid only with ho…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_apply_proposal", "agents.plan_get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_apply_proposal", "agents.plan_get"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_process_backlog", "semantic_input_mode": "inherit_workflow", "summary": "Scan decomposition backlog (decomposition_status=needed, no execution decomposition) and build planner proposals. Claims planner-parent lease before decompose when required_role=planner (even when aut", "title": "Process Plan Backlog", "wave_xix_atoms": {"WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_FACET_REPAIR": "plan_propose runs ensure_proposal_facet_coverage (facet_repair, max 2 passes) after enrich for create_plan and decompose_node (including from_draft_tree meta under create_plan) — do not hand-patch semantic facet children; for facet gaps after other modes use mode=repair_plan.", "WG_PERSIST_UNEXECUTABLE": "validation_mode=persist_unexecutable on plan_propose / plan_apply_proposal / plan_process_backlog when plan_valid but fleet cannot execute — use the same mode on propose and apply.", "WG_PLANNER_PLANE": "Backlog scan uses planner eligibility (decomposition_status=needed) — not execution_ready; validation_ok reflects plan_valid (structural+semantic), not fleet gaps.", "WG_PLANNING_ARTIFACT": "meta.planning_artifact nodes are evidence-only (resolution=non_executable_artifact) — attach evidence on parent; plan_process_backlog and claim skip them for execution."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "replan_budget_exceeded": "Max replans per node exceeded — agents.plan_propose mode=repair_plan on parent or escalation", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal"}, "when_blocked_locales": {"permission_denied": {"en-US": "RBAC denied — rbac.check_permission, membership, or dev-operator persona", "pt-BR": "RBAC negado — rbac.check_permission, membership ou persona dev-operator", "ru-RU": "RBAC отказ — rbac.check_permission, членство или dev-operator persona"}, "plan_revision_conflict": {"en-US": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal", "pt-BR": "Conflito CAS — agents.plan_get recarregue if_match_revision; nunca apply proposal obsoleto", "ru-RU": "CAS конфликт — agents.plan_get перечитать if_match_revision; не apply устаревший proposal"}}, "when_not_to_use": "Do not auto_apply on production without operator tier and explicit auto_apply_policy.", "when_to_use": "Scan decomposition backlog (planner plane) on home=project|self|project_self; env_uuid only with home=project. auto_apply_policy=off default; validation_mode=persist_unexecutable for intake-only; vali", "write_mode": null}, {"action": "agents.plan_recovery_scan", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not mutate DNA from recovery_scan — use plan_propose repair_plan or plan_patch.", "anti_patterns": ["Do not mutate DNA from recovery_scan — use plan_propose repair_plan or plan_patch."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_recovery_scan", "related_tools": ["agents.plan_propose", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Recovery Scan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verification_failed": "agents.plan_recovery_scan → plan_propose mode=repair_plan"}, "when_to_use": "Read-only recovery preview after verification_failed or work_next recovery routes: candidates, stale_claims, recovery.next_actions, and next_action — no DNA mutation (optional env_uuid on sandbox fork"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_recovery_scan", "related_tools": ["agents.plan_propose", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Recovery Scan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verification_failed": "agents.plan_recovery_scan → plan_propose mode=repair_plan"}, "when_to_use": "Read-only recovery preview after verification_failed or work_next recovery routes: candidates, stale_claims, recovery.next_actions, and next_action — no DNA mutation (optional env_uuid on sandbox fork"}, "do_not_use_when": "Do not mutate DNA from recovery_scan — use plan_propose repair_plan or plan_patch.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Candidates carry reason=verification_failed and recovery.next_actions.", "name": "Recovery scan (sandbox)", "request": {"params": {"env_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "limit": 8, "project_id": 1}, "tool": "agents.plan_recovery_scan"}, "response": {"data": {"candidates": [{"mode": "repair_plan", "node_id": "leaf-verify", "reason": "verification_failed", "recovery": {"next_actions": [{"action": "agents.plan_propose", "params": {"mode": "repair_plan", "node_id": "leaf-verify"}}]}}], "next_actions": [], "stale_claims": []}, "success": true}}], "execution_class": "heavy", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Read-only recovery preview after verification_failed or work_next recovery routes: candidates, stal…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_propose", "agents.work_next"], "onboarding_tier": "domain_playbook", "operator_recovery_template": {"expired_claim": {"claim": {"action": "agents.plan_claim", "params": {"env_uuid": "<env_uuid_if_sandbox>", "home": "project", "if_match_revision": "<revision>", "node_ids": ["<node_id>"]}}, "reclaim": {"action": "agents.plan_reclaim_stale", "params": {"env_uuid": "<env_uuid_if_sandbox>", "home": "project"}}, "refresh": {"action": "agents.plan_get", "params": {"detail": "compact", "env_uuid": "<env_uuid_if_sandbox>", "home": "project", "if_match_revision": "<revision>"}}}, "verification_failed": {"handoff": {"action": "agents.work_next", "params": {"handoff": true, "home": "project", "node_id": "<node_id>"}}, "repair_apply": {"action": "agents.plan_apply_proposal", "params": {"env_uuid": "<env_uuid_if_sandbox>", "home": "project", "if_match_revision": "<revision>"}}, "repair_propose": {"action": "agents.plan_propose", "params": {"env_uuid": "<env_uuid_if_sandbox>", "home": "project", "mode": "repair_plan", "node_id": "<node_id>"}}, "scan": {"action": "agents.plan_recovery_scan", "params": {"env_uuid": "<env_uuid_if_sandbox>", "home": "project"}}}}, "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "recovery_ladder": ["agents.plan_compaction_preview → agents.plan_heal_leaf (dry_run then apply) — spill_incomplete or plan_graph_too_large", "agents.plan_recovery_scan — verification_failed candidates + stale claims; optional env_uuid", "agents.plan_propose mode=repair_plan — target node_id; allow_generic_acceptance repair-only", "agents.plan_apply_proposal — same env_uuid as propose on sandbox forks", "agents.work_next handoff=true node_id=… — re-resolve after repair or provision"], "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_propose", "agents.work_next"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_plan_recovery_scan", "semantic_input_mode": "inherit_workflow", "summary": "Read-only scan for verification_failed repair candidates and stale claims. Reason codes use recovery_engine SoT (verification_failed, expired_claim).", "title": "Scan Plan Recovery", "wave_xix_atoms": {"WG_CLOSED_LOOP_VERIFY_FAIL": "verification_failed — next_action agents.plan_recovery_scan then repair_plan.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_PROVISION_PARITY": "When execution.fully_provisionable and one top template, recovery routes agents.ensure_agent create=false (H5 preview) — SDK followWorkGraphAction runs ensureAgentSaga for create=true; ambiguous ties → create_from_template choose_template.", "WG_RECOVERY_VERIFICATION_FAILED": "Recovery reason SoT is verification_failed (aliases verify_failed, plan_verify_failed) — call agents.plan_recovery_scan first, then plan_propose mode=repair_plan via recovery.next_actions (not missing_roles).", "WG_REPAIR_METRICS_SCAN_COUNTS": "plan_recovery_scan meta.repair_metrics is scan summary only (candidate_count, stale_claim_count). Facet repair_metrics (nodes_created, repair_graph_edit_distance) and repair_diagnostics come from plan_propose mode=repair_plan — not from scan counts."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verification_failed": "agents.plan_recovery_scan → plan_propose mode=repair_plan"}, "when_blocked_locales": {"expired_claim": {"en-US": "Stale lease — agents.plan_reclaim_stale, then plan_claim with a fresh if_match_revision", "pt-BR": "Lease expirado — agents.plan_reclaim_stale, depois plan_claim com if_match_revision novo", "ru-RU": "Истёк lease — agents.plan_reclaim_stale, затем plan_claim с новым if_match_revision"}, "verification_failed": {"en-US": "Verification failed — agents.plan_recovery_scan → plan_propose mode=repair_plan", "pt-BR": "Verificação falhou — agents.plan_recovery_scan → plan_propose mode=repair_plan", "ru-RU": "Верификация не прошла — agents.plan_recovery_scan → plan_propose mode=repair_plan"}}, "when_not_to_use": "Do not mutate DNA from recovery_scan — use plan_propose repair_plan or plan_patch.", "when_to_use": "Read-only recovery preview after verification_failed or work_next recovery routes: candidates, stale_claims, recovery.next_actions, and next_action — no DNA mutation (optional env_uuid on sandbox fork", "write_mode": null}, {"action": "agents.work_next", "aliases": ["agent_os.open", "agentos.open", "os.open", "os.panels"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not infer missing_roles from validation when execution_summary is present.", "anti_patterns": ["Do not infer missing_roles from validation when execution_summary is present.", "dependency_ready=false is not fixed by switching agent identity — wait deps first.", "Do not call agents.run on strategic parent nodes with children."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.work_next", "recovery_blocks": {"guidance_user_row_not_found": {"next_actions": [{"action": "agents.work_next", "params": {"handoff": true}}], "reason": "guidance_user_row_not_found"}, "orchestrator_binding_stale": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "orchestrator_binding_stale"}, "work_next_enrich_failed": {"next_actions": [{"action": "agents.work_next", "params": {"detail": "compact", "handoff": true}}], "reason": "work_next_enrich_failed"}, "work_next_hydrate_failed": {"next_actions": [{"action": "agents.work_next", "params": {"repair": true}}], "reason": "work_next_hydrate_failed"}, "work_next_repeat_reconcile_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "work_next_repeat_reconcile_failed"}, "workflow_batch_bind_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_bind_failed"}, "workflow_batch_bind_skipped": {"next_actions": [{"action": "agents.work_next", "params": {"repair": true}}], "reason": "workflow_batch_bind_skipped"}, "workflow_batch_context_bind_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_context_bind_failed"}, "workflow_batch_receipt_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_receipt_failed"}, "workflow_inverse_sync_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_inverse_sync_failed"}, "workflow_receipt_context_missing": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_context_missing"}, "workflow_receipt_unbound": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_unbound"}, "workflow_state_key_stamp_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_state_key_stamp_failed"}}, "related_tools": ["agents.plan_claim", "agents.plan_execute", "agents.ensure_agent", "agents.plan_get", "agents.plan_recovery_scan", "agents.graph_health", "discovery.list", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Work Next", "when_blocked": {"agent_daily_cap": "Agent per_day_cap hit — patch AgentSpec.energy or wait for UTC day rollover.", "agent_not_found": "agent_id not in project fleet — use agents.team or plan_get before run_get.", "already_claimed": "agents.work_next — check in_progress lease (H11); handoff if wrong agent; plan_reclaim_stale if stale", "ambiguous_anchor": "patch_text search_replace — longer find, set count, or graph_file_get text window", "approval_hash_mismatch": "agents.run_get — approval_artifact_hash must match pending tool call on the run", "auth_required": "Authenticate before work-graph spine — auth.get_profile → context.project_id → agents.work_next (not discovery.search).", "batch_project_scope_leak": "A failed MCP batch step with params.project_id does not retarget later steps — only auth.switch_project may promote batch context.project_id. Re-bind context.project_id before mutations if a step used a probe pid.", "batch_semantic_anchor_conflict": "Align step NL with batch goal anchor — use one goal_text for the batch or split batches", "batch_semantic_anchor_required": "Batch includes a mutating or non-plain-read step: set options.execution_intent=direct for authorized CRUD, or options.goal, focus_node_id, or plan_execute_mode for workflow. Plain reads and validate_only (e.g. script.put) may run without goal. Use preflight.check simulate_batch_actions + simulate_batch_params (or execution_intent) to preview anchor.", "capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "checklist_gate_open": "Complete checklist gates on meta.checklist_gates (plan_node entity); agents.plan_get node_id=… — do not patch description as a blocker", "claim_empty": "agents.work_next handoff=true — no nodes claimed; refresh claimable set", "claim_heartbeat_failed": "No active in_progress lease for node_id — plan_claim the node before heartbeat_only pin ops", "conflicting_semantic_anchor": "Same as batch_semantic_anchor_conflict — per-step NL vs batch semantic_contract", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "created_agent_not_eligible": "Provision rolled back — plan_propose mode=repair_plan or pick template with matching caps (H5)", "decomposition_blocked": "agents.plan_propose mode=decompose_node — parent has open decomposition children", "dependency_blocked": "agents.plan_get to inspect upstream deps; do not ensure_agent; do not claim", "dependency_error": "Batch only — DAG: a prior step failed or was skipped; fix the first failed step_id. Standalone notifications.deliver / channels.deliver use channel_not_linked or channels.create_bind_link, not dependency_error.", "dependency_failed": "Prerequisite batch step did not succeed — fix or remove dependsOn; poll verification_action before retrying dependent step", "discovery_search_recursion": "Prefer discovery.list (optional domain=) to copy exact action ids, then discovery.describe. If you use discovery.search: one concrete q= per execute, then describe — do not chain many search steps; in goal-anchored batches run search in a separate execute (batch_semantic_anchor_conflict).", "energy_denied": "Insufficient builder_energy before agents.run — energy.get_balance then payments.create intent=energy_pack; follow packet.next_action.", "ensure_agent_stamp_mismatch": "Replay create=false preview; create=true must match preview_template_id + graph_revision", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "fleet_skipped": "Fleet was not loaded for this work_next call (compact/rank-only path) — not the same as no_compatible_agent; load fleet or use full work_next when matching agents to tasks.", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "fully_provisionable": "ensure_agent create=false (H5) then create=true (preferred over create_from_template)", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_address_required": "Personal home needs a resolved session address. Pass home on the tool and ensure the operator session has user_id before patch.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "graph_storage_empty": "Prod task_list leaf is empty at revision 0 with storage hash — restore via generation supply and agents.plan_patch; do not empty-overwrite revision 0.", "guidance_user_row_not_found": "auth.get_profile then agents.work_next handoff=true", "idle": "Orchestrator graph has no tasks yet (revision 0) — valid idle; seed with agents.plan_propose or agents.plan_patch before claim/execute.", "import_pack_personal_home_unsupported": "Orchestrator import pack requires home=project; personal session graphs use export/read paths only.", "internal_execution_error": "agents.plan_recovery_scan → plan_propose mode=repair_plan; retry after catalog refresh", "invalid_channel": "channel must be workspace, messenger, bot, mcp, or api — retry agents.orchestrate with a supported surface", "invalid_detail": "detail/projection/limit validation — see problem.field in error payload", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "invalid_state_transition": "agents.plan_get node status — legal FSM only; completed↔cancelled retries are no-ops", "join_not_allowed": "Project is not open-join — request invite or projects.add_user from an owner.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "membership_required": "Open community hub: call projects.join on context.project_id, then agents.work_next with home=project_self (recipe mcp_community_hub_v1).", "missing_capability": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "missing_required_dependency": "agents.plan_propose mode=decompose_node or repair_plan — facet DAG edge missing (storage→knowledge, logic→scheduler); inspect dependencies_to_add", "mode_not_implemented": "Use create_plan | decompose_node | replan_subtree | repair_plan | optimize_plan — discovery.describe agents.plan_propose", "needs_seed": "Graph revision > 0 but task list is empty — propose or patch a plan; do not run plan_recovery_scan against an intentionally empty graph.", "no_compatible_agent": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "node_already_atomic": "Complexity too low to decompose — agents.work_next or agents.plan_get for another leaf", "node_not_eligible": "agents.plan_get on the same home — node failed evaluate_work_eligibility; agents.work_next handoff=true and follow recovery.next_actions", "node_not_found": "agents.plan_get include_claimable=true — node_id absent from graph slice", "not_authenticated": "MCP is required. This channel has no operator session — authorize first (Connect on plugin AgentStack MCP or /agentstack-authorize). Confirm with mcp-execute.mjs auth.get_profile. Do not retry the unsigned plugin call and do not call mcp_auth.", "not_executable": "kind note and catalog are memory, not work. Do not plan_claim them. Claim a task, step, or issue on the same home.", "operator_closure": "operator_closure: tell the user in chat (operator_gate.messages) and ask yes/no. agents.plan_patch gates_passed only after an explicit yes. terminal means wait, not skip the leaf.", "orchestrate_failed": "resolve_and_run failed — read data.error_code; agents.fleet_diagnostics, agents.reconcile_binding, or agents.run_get when run_uuid is present", "orchestration_step_violation": "Action outside current workflow step — follow packet next_action / inverse_resume; do not mutate graph until step advances. For ad-hoc reads (auth.get_profile) or plan writes outside the spine, rerun the batch with options.execution_mode=plain or options.execution_intent=direct on a single allowed action. For notifications.deliver inside a playbook: run preflight.check first or use packet.next_action — not a raw deliver outside the step allow-list.", "orchestrator_agent_missing": "projects.orchestrator.get then projects.orchestrator.patch (or owner/agents_admin auto-provision on prod); sandbox env_uuid cannot provision — bind on prod and reconcile before sandbox orchestrate", "orchestrator_agent_stale": "Bound agent_uuid no longer matches fleet — agents.reconcile_binding repair=true; agents.ensure_agent when the template row is missing; then agents.work_next handoff=true.", "orchestrator_binding_stale": "agents.reconcile_binding repair=true", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "pin_inventory_full": "Goal pin inventory at active_max — unpin a slot (plan affinity) then retry agents.plan_claim", "pin_slot_not_found": "No matching goal pin slot for skill_id and agent_id — agents.plan_get pin_slots then retry", "plan_archive_no_effect": "Archive patch matched no nodes — agents.plan_get detail=compact; confirm archive_ids / node_id scope; use agents.plan_patch with if_match_revision, not empty ops.", "plan_claim_owner_conflict": "agents.work_next handoff=true — another operator holds the lease", "plan_claim_required": "agents.plan_claim if_match_revision — in_progress lease before agents.plan_execute", "plan_completion_blocked": "Attach completion_predicates evidence; do not retry agents.plan_execute until allowed", "plan_focus_invalid": "agents.work_next detail=compact — refresh focus_node_id from packet next_action", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_children_exceeded": "Direct children per parent are capped (32). Flat parent_id storage counts siblings under each parent_id — not total graph nodes. Split into sub-groups or use agents.plan_propose decompose_node.", "plan_graph_load_failed": "DNA/graph slice failed to load — plan_get (compact) then retry. If patch used a long title (>256), use patch_text or shorten title; see validation_error + field=title instead of this code when preflight maps PGVE.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_private": "Orchestrator graph is private — sign in (user_id in MCP context) or set orchestrator public_read; project API keys must include created_by user.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_ops_parent_missing": "add_child parent_id is not in the graph — create the parent first or fix parent_id. On an empty project graph (revision 0, no tasks), omit parent_id and send {op:add_child, node:{id, title, kind}} with if_match_revision:0 from plan_get; do not use op set for new ids.", "plan_patch_inline_body_spill": "Inline prose exceeds chunk seal — agents.graph_file_put; follow spill recovery in error data", "plan_patch_nodes_missing_from_changed": "Revision moved but new node ids are absent on plan_get — align generation_env_uuid on context and tool params; deploy compaction protect_ids (undated completed purge); run prelude bucket parents before child ingest batches.", "plan_patch_ops_limit": "Too many ops[] in one plan_patch — split batches; plan_get between writes (max 50)", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "planner_duplicate_children": "agents.plan_get — semantic facet children already exist; re-propose is a no-op or use mode=replan_subtree", "planning_blocked": "agents.plan_propose mode=decompose_node or plan_process_backlog — finish planner plane first", "planning_required": "agents.plan_propose mode=create_plan or decompose_node — strategic/decomposition node, not execution", "provision_required": "ensure_agent create=false (H5) then create=true then plan_claim", "provisioning_failed": "create_from_template or bind failed — retry agents.ensure_agent create=false (H5) then create=true", "relogin_required": "Session invalidated (deploy, eviction, or X-Session-Action: relogin_required) — re-authenticate: auth.get_profile or hosted remint; do not retry the same Bearer in a loop.", "replan_budget_exceeded": "Max replans per node exceeded — agents.plan_propose mode=repair_plan on parent or escalation", "role_mismatch": "work_next handoff=true node_id=… — do not retry same agent", "run_failed": "agents.work_next detail=compact — inspect run traces; repair_plan or reclaim before retry", "run_mismatch": "run_id does not belong to the supplied agent_id — omit agent_id or fix the pair.", "run_not_found": "No run row for run_id in this project — verify run_id from agents.run or traces.", "run_not_waiting_for_approval": "agents.run_get — run is not waiting_for_approval; poll status before approve_run", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Key lacks required L1 cap (often mcp_read or project_admin for plan_patch). Widen via apikeys.create (full_project) or reconnect MCP with full OAuth scope. If project role is owner/admin, MCP widens caps for execute project_id — call auth.get_profile (credential_plane) to confirm key_preview and caps; align context.project_id with the tenant before agents.plan_get / plan_patch.", "service_caps_required_in_prod": "Project API key has no L1 service_caps — recreate with admin permissions (auto agents_autonomous_loop in prod) or user.apikeys.create preset agents_autonomous_loop / full_project; pass context.project_id=1 for ecosystem graph.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "skill_mismatch": "agents.work_next handoff=true — skill_ids mismatch; follow recovery.next_actions", "specialization_mismatch": "work_next handoff=true — follow recovery.next_actions", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "status_not_claimable": "agents.plan_get on the same home. Claim only pending or ready nodes, or an in_progress node whose lease has expired.", "supersede_in_progress": "agents.plan_get then wait/retry — in-progress node cannot be superseded without options.force_supersede_in_progress (retryable)", "template_not_found": "agents.templates_list — template_id missing from catalog; agents.template_preview before create=true", "terminal": "agents.work_next — skip terminal node; pick another leaf (completed/cancelled not claimable)", "text_revision_conflict": "patch_text — re-read the field from plan_get; refresh expected_text_sha256", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "unknown_skill_id": "Fix node skill_ids to ecosystem catalog (agents.skills_list); use rag.retrieval / rag.ingest_acceptance — not MCP action names; re-run plan_propose after enrich", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal", "verification_failed": "agents.plan_recovery_scan → plan_propose mode=repair_plan", "waiting_approval": "agents.work_next — wait approval gate; agents.plan_get to inspect approval meta", "waiting_for_approval": "Run status waiting_for_approval — agents.approve_run with approval_artifact_hash from run_detail.", "waiting_input": "agents.work_next — ask_user recovery; do not plan_claim until operator input arrives", "wip_full": "Agent WIP cap reached — agents.plan_get then complete/release in_progress claims; retry plan_claim", "wire_budget_exceeded": "Slice too large — narrow node_id, max_depth, or use detail=cards (detail=body|full past wire budget)", "work_next_enrich_failed": "agents.work_next handoff=true detail=compact", "work_next_hydrate_failed": "Work-graph hydrate failed — run agents.work_next with repair=true and detail=compact; on preflight failures narrow batch targets; on discovery failures narrow scope or defer hydrate.", "work_next_repeat_reconcile_failed": "agents.reconcile_binding repair=true", "workflow_batch_bind_failed": "agents.reconcile_binding repair=true — guidance bind failed; check member row / session", "workflow_batch_bind_skipped": "Binding skipped (read-only batch or missing workflow_run_id) — agents.work_next handoff=true if follow-up work is expected", "workflow_batch_context_bind_failed": "agents.reconcile_binding repair=true — batch context bind failed", "workflow_batch_receipt_failed": "Step succeeded but receipt stamp failed — agents.reconcile_binding repair=true; retry read-only agents.plan_get before mutating", "workflow_inverse_sync_failed": "agents.reconcile_binding repair=true — inverse session sync failed", "workflow_receipt_context_missing": "Active workflow receipt missing workflow_run_id or step_id — agents.reconcile_binding repair=true; agents.work_next handoff=true detail=compact", "workflow_receipt_unbound": "Workflow receipt not bound to session — agents.reconcile_binding repair=true", "workflow_scope_leak": "Batch step params.project_id disagrees with MCP context.project_id — fix the batch, not the work graph: ecosystem bus uses project_id=1 on bots.bus.* while context may be a tenant pin; StackScript/generation steps carry the subject tenant in params; omit duplicate project_id on global reads or align context via auth.switch_project. Run preflight.check — do not plan_heal_leaf or repair_plan for this error.", "workflow_state_key_stamp_failed": "agents.reconcile_binding repair=true — workflow_state_key stamp failed"}, "when_to_use": "After VPS backend restart, first agents.work_next may fail while MCP tools import — wait ~15s and retry once (not a plan graph bug). Bound project: agents.work_next (recipe mcp_work_loop_v1) before ca"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.work_next", "recovery_blocks": {"guidance_user_row_not_found": {"next_actions": [{"action": "agents.work_next", "params": {"handoff": true}}], "reason": "guidance_user_row_not_found"}, "orchestrator_binding_stale": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "orchestrator_binding_stale"}, "work_next_enrich_failed": {"next_actions": [{"action": "agents.work_next", "params": {"detail": "compact", "handoff": true}}], "reason": "work_next_enrich_failed"}, "work_next_hydrate_failed": {"next_actions": [{"action": "agents.work_next", "params": {"repair": true}}], "reason": "work_next_hydrate_failed"}, "work_next_repeat_reconcile_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "work_next_repeat_reconcile_failed"}, "workflow_batch_bind_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_bind_failed"}, "workflow_batch_bind_skipped": {"next_actions": [{"action": "agents.work_next", "params": {"repair": true}}], "reason": "workflow_batch_bind_skipped"}, "workflow_batch_context_bind_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_context_bind_failed"}, "workflow_batch_receipt_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_receipt_failed"}, "workflow_inverse_sync_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_inverse_sync_failed"}, "workflow_receipt_context_missing": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_context_missing"}, "workflow_receipt_unbound": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_unbound"}, "workflow_state_key_stamp_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_state_key_stamp_failed"}}, "related_tools": ["agents.plan_claim", "agents.plan_execute", "agents.ensure_agent", "agents.plan_get", "agents.plan_recovery_scan", "agents.graph_health", "discovery.list", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Work Next", "when_blocked": {"agent_daily_cap": "Agent per_day_cap hit — patch AgentSpec.energy or wait for UTC day rollover.", "agent_not_found": "agent_id not in project fleet — use agents.team or plan_get before run_get.", "already_claimed": "agents.work_next — check in_progress lease (H11); handoff if wrong agent; plan_reclaim_stale if stale", "ambiguous_anchor": "patch_text search_replace — longer find, set count, or graph_file_get text window", "approval_hash_mismatch": "agents.run_get — approval_artifact_hash must match pending tool call on the run", "auth_required": "Authenticate before work-graph spine — auth.get_profile → context.project_id → agents.work_next (not discovery.search).", "batch_project_scope_leak": "A failed MCP batch step with params.project_id does not retarget later steps — only auth.switch_project may promote batch context.project_id. Re-bind context.project_id before mutations if a step used a probe pid.", "batch_semantic_anchor_conflict": "Align step NL with batch goal anchor — use one goal_text for the batch or split batches", "batch_semantic_anchor_required": "Batch includes a mutating or non-plain-read step: set options.execution_intent=direct for authorized CRUD, or options.goal, focus_node_id, or plan_execute_mode for workflow. Plain reads and validate_only (e.g. script.put) may run without goal. Use preflight.check simulate_batch_actions + simulate_batch_params (or execution_intent) to preview anchor.", "capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "checklist_gate_open": "Complete checklist gates on meta.checklist_gates (plan_node entity); agents.plan_get node_id=… — do not patch description as a blocker", "claim_empty": "agents.work_next handoff=true — no nodes claimed; refresh claimable set", "claim_heartbeat_failed": "No active in_progress lease for node_id — plan_claim the node before heartbeat_only pin ops", "conflicting_semantic_anchor": "Same as batch_semantic_anchor_conflict — per-step NL vs batch semantic_contract", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "created_agent_not_eligible": "Provision rolled back — plan_propose mode=repair_plan or pick template with matching caps (H5)", "decomposition_blocked": "agents.plan_propose mode=decompose_node — parent has open decomposition children", "dependency_blocked": "agents.plan_get to inspect upstream deps; do not ensure_agent; do not claim", "dependency_error": "Batch only — DAG: a prior step failed or was skipped; fix the first failed step_id. Standalone notifications.deliver / channels.deliver use channel_not_linked or channels.create_bind_link, not dependency_error.", "dependency_failed": "Prerequisite batch step did not succeed — fix or remove dependsOn; poll verification_action before retrying dependent step", "discovery_search_recursion": "Prefer discovery.list (optional domain=) to copy exact action ids, then discovery.describe. If you use discovery.search: one concrete q= per execute, then describe — do not chain many search steps; in goal-anchored batches run search in a separate execute (batch_semantic_anchor_conflict).", "energy_denied": "Insufficient builder_energy before agents.run — energy.get_balance then payments.create intent=energy_pack; follow packet.next_action.", "ensure_agent_stamp_mismatch": "Replay create=false preview; create=true must match preview_template_id + graph_revision", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "fleet_skipped": "Fleet was not loaded for this work_next call (compact/rank-only path) — not the same as no_compatible_agent; load fleet or use full work_next when matching agents to tasks.", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "fully_provisionable": "ensure_agent create=false (H5) then create=true (preferred over create_from_template)", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_address_required": "Personal home needs a resolved session address. Pass home on the tool and ensure the operator session has user_id before patch.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "graph_storage_empty": "Prod task_list leaf is empty at revision 0 with storage hash — restore via generation supply and agents.plan_patch; do not empty-overwrite revision 0.", "guidance_user_row_not_found": "auth.get_profile then agents.work_next handoff=true", "idle": "Orchestrator graph has no tasks yet (revision 0) — valid idle; seed with agents.plan_propose or agents.plan_patch before claim/execute.", "import_pack_personal_home_unsupported": "Orchestrator import pack requires home=project; personal session graphs use export/read paths only.", "internal_execution_error": "agents.plan_recovery_scan → plan_propose mode=repair_plan; retry after catalog refresh", "invalid_channel": "channel must be workspace, messenger, bot, mcp, or api — retry agents.orchestrate with a supported surface", "invalid_detail": "detail/projection/limit validation — see problem.field in error payload", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "invalid_state_transition": "agents.plan_get node status — legal FSM only; completed↔cancelled retries are no-ops", "join_not_allowed": "Project is not open-join — request invite or projects.add_user from an owner.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "membership_required": "Open community hub: call projects.join on context.project_id, then agents.work_next with home=project_self (recipe mcp_community_hub_v1).", "missing_capability": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "missing_required_dependency": "agents.plan_propose mode=decompose_node or repair_plan — facet DAG edge missing (storage→knowledge, logic→scheduler); inspect dependencies_to_add", "mode_not_implemented": "Use create_plan | decompose_node | replan_subtree | repair_plan | optimize_plan — discovery.describe agents.plan_propose", "needs_seed": "Graph revision > 0 but task list is empty — propose or patch a plan; do not run plan_recovery_scan against an intentionally empty graph.", "no_compatible_agent": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "node_already_atomic": "Complexity too low to decompose — agents.work_next or agents.plan_get for another leaf", "node_not_eligible": "agents.plan_get on the same home — node failed evaluate_work_eligibility; agents.work_next handoff=true and follow recovery.next_actions", "node_not_found": "agents.plan_get include_claimable=true — node_id absent from graph slice", "not_authenticated": "MCP is required. This channel has no operator session — authorize first (Connect on plugin AgentStack MCP or /agentstack-authorize). Confirm with mcp-execute.mjs auth.get_profile. Do not retry the unsigned plugin call and do not call mcp_auth.", "not_executable": "kind note and catalog are memory, not work. Do not plan_claim them. Claim a task, step, or issue on the same home.", "operator_closure": "operator_closure: tell the user in chat (operator_gate.messages) and ask yes/no. agents.plan_patch gates_passed only after an explicit yes. terminal means wait, not skip the leaf.", "orchestrate_failed": "resolve_and_run failed — read data.error_code; agents.fleet_diagnostics, agents.reconcile_binding, or agents.run_get when run_uuid is present", "orchestration_step_violation": "Action outside current workflow step — follow packet next_action / inverse_resume; do not mutate graph until step advances. For ad-hoc reads (auth.get_profile) or plan writes outside the spine, rerun the batch with options.execution_mode=plain or options.execution_intent=direct on a single allowed action. For notifications.deliver inside a playbook: run preflight.check first or use packet.next_action — not a raw deliver outside the step allow-list.", "orchestrator_agent_missing": "projects.orchestrator.get then projects.orchestrator.patch (or owner/agents_admin auto-provision on prod); sandbox env_uuid cannot provision — bind on prod and reconcile before sandbox orchestrate", "orchestrator_agent_stale": "Bound agent_uuid no longer matches fleet — agents.reconcile_binding repair=true; agents.ensure_agent when the template row is missing; then agents.work_next handoff=true.", "orchestrator_binding_stale": "agents.reconcile_binding repair=true", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "pin_inventory_full": "Goal pin inventory at active_max — unpin a slot (plan affinity) then retry agents.plan_claim", "pin_slot_not_found": "No matching goal pin slot for skill_id and agent_id — agents.plan_get pin_slots then retry", "plan_archive_no_effect": "Archive patch matched no nodes — agents.plan_get detail=compact; confirm archive_ids / node_id scope; use agents.plan_patch with if_match_revision, not empty ops.", "plan_claim_owner_conflict": "agents.work_next handoff=true — another operator holds the lease", "plan_claim_required": "agents.plan_claim if_match_revision — in_progress lease before agents.plan_execute", "plan_completion_blocked": "Attach completion_predicates evidence; do not retry agents.plan_execute until allowed", "plan_focus_invalid": "agents.work_next detail=compact — refresh focus_node_id from packet next_action", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_children_exceeded": "Direct children per parent are capped (32). Flat parent_id storage counts siblings under each parent_id — not total graph nodes. Split into sub-groups or use agents.plan_propose decompose_node.", "plan_graph_load_failed": "DNA/graph slice failed to load — plan_get (compact) then retry. If patch used a long title (>256), use patch_text or shorten title; see validation_error + field=title instead of this code when preflight maps PGVE.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_private": "Orchestrator graph is private — sign in (user_id in MCP context) or set orchestrator public_read; project API keys must include created_by user.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_ops_parent_missing": "add_child parent_id is not in the graph — create the parent first or fix parent_id. On an empty project graph (revision 0, no tasks), omit parent_id and send {op:add_child, node:{id, title, kind}} with if_match_revision:0 from plan_get; do not use op set for new ids.", "plan_patch_inline_body_spill": "Inline prose exceeds chunk seal — agents.graph_file_put; follow spill recovery in error data", "plan_patch_nodes_missing_from_changed": "Revision moved but new node ids are absent on plan_get — align generation_env_uuid on context and tool params; deploy compaction protect_ids (undated completed purge); run prelude bucket parents before child ingest batches.", "plan_patch_ops_limit": "Too many ops[] in one plan_patch — split batches; plan_get between writes (max 50)", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "planner_duplicate_children": "agents.plan_get — semantic facet children already exist; re-propose is a no-op or use mode=replan_subtree", "planning_blocked": "agents.plan_propose mode=decompose_node or plan_process_backlog — finish planner plane first", "planning_required": "agents.plan_propose mode=create_plan or decompose_node — strategic/decomposition node, not execution", "provision_required": "ensure_agent create=false (H5) then create=true then plan_claim", "provisioning_failed": "create_from_template or bind failed — retry agents.ensure_agent create=false (H5) then create=true", "relogin_required": "Session invalidated (deploy, eviction, or X-Session-Action: relogin_required) — re-authenticate: auth.get_profile or hosted remint; do not retry the same Bearer in a loop.", "replan_budget_exceeded": "Max replans per node exceeded — agents.plan_propose mode=repair_plan on parent or escalation", "role_mismatch": "work_next handoff=true node_id=… — do not retry same agent", "run_failed": "agents.work_next detail=compact — inspect run traces; repair_plan or reclaim before retry", "run_mismatch": "run_id does not belong to the supplied agent_id — omit agent_id or fix the pair.", "run_not_found": "No run row for run_id in this project — verify run_id from agents.run or traces.", "run_not_waiting_for_approval": "agents.run_get — run is not waiting_for_approval; poll status before approve_run", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Key lacks required L1 cap (often mcp_read or project_admin for plan_patch). Widen via apikeys.create (full_project) or reconnect MCP with full OAuth scope. If project role is owner/admin, MCP widens caps for execute project_id — call auth.get_profile (credential_plane) to confirm key_preview and caps; align context.project_id with the tenant before agents.plan_get / plan_patch.", "service_caps_required_in_prod": "Project API key has no L1 service_caps — recreate with admin permissions (auto agents_autonomous_loop in prod) or user.apikeys.create preset agents_autonomous_loop / full_project; pass context.project_id=1 for ecosystem graph.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "skill_mismatch": "agents.work_next handoff=true — skill_ids mismatch; follow recovery.next_actions", "specialization_mismatch": "work_next handoff=true — follow recovery.next_actions", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "status_not_claimable": "agents.plan_get on the same home. Claim only pending or ready nodes, or an in_progress node whose lease has expired.", "supersede_in_progress": "agents.plan_get then wait/retry — in-progress node cannot be superseded without options.force_supersede_in_progress (retryable)", "template_not_found": "agents.templates_list — template_id missing from catalog; agents.template_preview before create=true", "terminal": "agents.work_next — skip terminal node; pick another leaf (completed/cancelled not claimable)", "text_revision_conflict": "patch_text — re-read the field from plan_get; refresh expected_text_sha256", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "unknown_skill_id": "Fix node skill_ids to ecosystem catalog (agents.skills_list); use rag.retrieval / rag.ingest_acceptance — not MCP action names; re-run plan_propose after enrich", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal", "verification_failed": "agents.plan_recovery_scan → plan_propose mode=repair_plan", "waiting_approval": "agents.work_next — wait approval gate; agents.plan_get to inspect approval meta", "waiting_for_approval": "Run status waiting_for_approval — agents.approve_run with approval_artifact_hash from run_detail.", "waiting_input": "agents.work_next — ask_user recovery; do not plan_claim until operator input arrives", "wip_full": "Agent WIP cap reached — agents.plan_get then complete/release in_progress claims; retry plan_claim", "wire_budget_exceeded": "Slice too large — narrow node_id, max_depth, or use detail=cards (detail=body|full past wire budget)", "work_next_enrich_failed": "agents.work_next handoff=true detail=compact", "work_next_hydrate_failed": "Work-graph hydrate failed — run agents.work_next with repair=true and detail=compact; on preflight failures narrow batch targets; on discovery failures narrow scope or defer hydrate.", "work_next_repeat_reconcile_failed": "agents.reconcile_binding repair=true", "workflow_batch_bind_failed": "agents.reconcile_binding repair=true — guidance bind failed; check member row / session", "workflow_batch_bind_skipped": "Binding skipped (read-only batch or missing workflow_run_id) — agents.work_next handoff=true if follow-up work is expected", "workflow_batch_context_bind_failed": "agents.reconcile_binding repair=true — batch context bind failed", "workflow_batch_receipt_failed": "Step succeeded but receipt stamp failed — agents.reconcile_binding repair=true; retry read-only agents.plan_get before mutating", "workflow_inverse_sync_failed": "agents.reconcile_binding repair=true — inverse session sync failed", "workflow_receipt_context_missing": "Active workflow receipt missing workflow_run_id or step_id — agents.reconcile_binding repair=true; agents.work_next handoff=true detail=compact", "workflow_receipt_unbound": "Workflow receipt not bound to session — agents.reconcile_binding repair=true", "workflow_scope_leak": "Batch step params.project_id disagrees with MCP context.project_id — fix the batch, not the work graph: ecosystem bus uses project_id=1 on bots.bus.* while context may be a tenant pin; StackScript/generation steps carry the subject tenant in params; omit duplicate project_id on global reads or align context via auth.switch_project. Run preflight.check — do not plan_heal_leaf or repair_plan for this error.", "workflow_state_key_stamp_failed": "agents.reconcile_binding repair=true — workflow_state_key stamp failed"}, "when_to_use": "After VPS backend restart, first agents.work_next may fail while MCP tools import — wait ~15s and retry once (not a plan graph bug). Bound project: agents.work_next (recipe mcp_work_loop_v1) before ca"}, "do_not_use_when": "Do not infer missing_roles from validation when execution_summary is present.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "next_work.execution carries dependency_ready, execution_ready, and execution_summary; instruction_packet mirrors execution_summary.", "name": "Executable next work", "request": {"params": {"detail": "compact", "env_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "project_id": 1}, "tool": "agents.work_next"}, "response": {"data": {"detail": "compact", "instruction_packet": {"execution_summary": {"execution_ready": true}}, "next_action": {"action": "agents.plan_claim", "params": {"node_id": "task-a", "project_id": 1}}, "next_work": {"execution": {"dependency_ready": true, "execution_ready": true, "execution_summary": {"per_node": [{"execution_ready": true, "node_id": "task-a"}]}}, "node_id": "task-a"}, "node_id": "task-a", "panels": [{"bytes": 2, "count": 0, "id": "pin_slots"}], "reason": "", "revision": 2, "state": "actionable"}, "success": true}}, {"description": "dependency_ready true but execution_ready false → state=blocked; recovery routes to agents.ensure_agent; claim errors add recovery_block.", "name": "Blocked with recovery", "request": {"params": {"env_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "handoff": true, "node_id": "task-b", "project_id": 1}, "tool": "agents.work_next"}, "response": {"data": {"blocked_work": [{"dependency_ready": true, "execution": {"dependency_ready": true, "execution_ready": false, "execution_summary": {"provisionable_specializations": ["frontend_developer"]}}, "execution_ready": false, "node_id": "task-b"}], "detail": "compact", "panels": [{"bytes": 2, "count": 0, "id": "pin_slots"}], "recovery": {"next_actions": [{"action": "agents.ensure_agent", "params": {"create": true, "node_id": "task-b", "project_id": 1}}], "reason": "provision_required"}, "state": "blocked"}, "success": true}}], "execution_class": "plain_read", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "hydrate_mode_note": "discovery rank_only hydrate skips fleet — run full agents.work_next before plan_claim.", "instruction_hint": "After VPS backend restart, first agents.work_next may fail while MCP tools import — wait ~15s and r…", "kind": "mcp_domain", "ladder": ["agents.plan_get — include_execution_eligibility=true; optional env_uuid for sandbox slice", "agents.work_next — read dependency_ready (structural) vs execution_ready (fleet) separately; blocked_work.execution_summary + instruction_packet.execution_summary; dependency_ready=false → wait deps; execution_ready=false with deps ok → provision before claim", "agents.plan_claim — CAS revision; role_mismatch → handoff not retry loop", "agents.plan_execute — only after claim; attach evidence for completion_predicates"], "loop_compact": {"anti_pattern": "Do not projects.patch_data full orchestrator task_list blobs — use plan_heal_leaf ladder.", "cheap_sync_batch": ["agents.work_next", "agents.plan_get", "agents.plan_claim"], "heavy_expand": ["blocked_work", "diagnostics", "generation_pending", "goal_summary", "instruction_packet", "instruction_slice", "pin_slots", "plan_summary", "skills"], "hot_loop": {"detail": "compact", "home": "project"}, "leaf_overflow_ladder": ["agents.graph_health | agents.plan_compaction_preview (read)", "agents.plan_heal_leaf dry_run=true then apply", "agents.plan_patch archive ops | agents.graph_file_put if still over cap"], "recipe_id": "mcp_work_loop_v1", "recommended_expand": {"default": [], "detail_full_default": ["instruction_packet"], "when_promote_pending": ["generation_pending"], "when_state_blocked": ["instruction_packet", "blocked_work"]}, "rule": "Follow packet.next_action; discovery.search only when next_action is absent.", "spine": ["agents.work_next", "agents.plan_claim", "agents.plan_execute", "agents.work_next"]}, "mutation_kind": "none", "next_actions": ["agents.plan_claim", "agents.ensure_agent", "agents.plan_execute"], "onboarding_tier": "domain_playbook", "operator_closure_plan_patch": {"blocked_reason": "operator_closure", "describe": {"action": "discovery.describe", "params": {"action": "agents.plan_patch", "detail": "default"}}, "operator_complete": {"completion_meta_keys": ["completion_note", "completion_waived", "gate_evidence", "gates_passed"], "example_ops": [{"id": "<node_id>", "op": "set", "status": "in_progress"}, {"id": "<node_id>", "key": "gates_passed", "op": "set_meta", "value": true}, {"id": "<node_id>", "key": "gate_evidence", "op": "set_meta", "value": "Evidence line (HTTP probe, checklist doc, etc.)"}, {"id": "<node_id>", "op": "set", "status": "verifying"}, {"completion_note": "Evidence line (HTTP probe, checklist doc, etc.)", "id": "<node_id>", "op": "set", "status": "completed"}], "recommended_mode": "operator_complete", "rule": "Roleless platform ops leaves (human_required): set_meta gates_passed + gate_evidence, then FSM in_progress→verifying→completed. Pass from_status from plan_get node status."}, "plan_patch": {"action": "agents.plan_patch", "params": {"home": "project", "if_match_revision": "<revision>", "ops": [{"id": "<node_id>", "op": "set", "status": "in_progress"}, {"id": "<node_id>", "key": "gates_passed", "op": "set_meta", "value": true}, {"id": "<node_id>", "key": "gate_evidence", "op": "set_meta", "value": "Operator evidence (probe URL, checklist, deploy gate)"}, {"id": "<node_id>", "op": "set", "status": "verifying"}, {"completion_note": "Operator evidence (probe URL, checklist, deploy gate)", "id": "<node_id>", "op": "set", "status": "completed"}]}}, "preflight": {"action": "agents.plan_get", "params": {"detail": "compact", "if_match_revision": "<revision>", "node_id": "<node_id>"}}, "recommended_mode": "operator_complete", "speak_first": "operator_closure: tell the user in chat (operator_gate.messages) and ask yes/no. agents.plan_patch gates_passed only after an explicit yes. terminal means wait, not skip the leaf."}, "organ_id": "mcp.diagnostics", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"action_readiness": {"description": "Whether next_action is executable vs actionable", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "alternative_actions": {"description": "Secondary actions when primary is blocked", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "blocked_cursor": {"description": "REST GET/POST — pages blocked_work when detail=full", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "blocked_limit": {"description": "REST GET/POST — blocked_work page size (default 8)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "blocked_node_id": {"description": "Focused blocked node when state=blocked (rv-28 Copilot deep link)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "blocked_reason_code": {"description": "Canonical block_reason code when state=blocked (rv-28)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "blocked_work": {"description": "First three nodes when state=blocked, without expand. Full list when detail=full or expand=blocked_work.", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "blocked_work_page": {"description": "Cursor page when blocked_work exceeds compact cap", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "claim": {"description": "Claim CTA metadata when lease available", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "claim_result": {"description": "Present after claim=true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "detail": {"description": "compact | full", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "diagnostics": {"description": "Loop compliance when detail=full or expand=diagnostics. After MCP batch hydrate, plain compact polls may set batch_packet_reuse=true (skip graph reload; claim/handoff/observed opt out). timings_ms (incl. graph_skipped) when diagnostics expanded.", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "expand_warnings": {"description": "Non-fatal expand panel issues (unknown panel id, budget clip)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "generation_pending": {"description": "When include_generation_pending or expand generation_pending", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "goal": {"description": "Goal summary when detail=full", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "goal_id": {"description": "Focused strategic goal", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "goal_summary": {"description": "When detail=full or expand=goal_summary", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "graph_slice": {"description": "1-hop plan cards when expand is node:<id> or neighborhood. This response only.", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "hydrate_mode": {"description": "discovery rank_only | light | full — how work_next was hydrated for this packet", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "instruction_packet": {"description": "Enriched slice when detail=full or expand=instruction_packet", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "instruction_slice": {"description": "When_blocked / recovery ladder copy for agents and operators on compact wire", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "locale": {"description": "Resolved locale for instruction copy", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "loop_mode": {"description": "Short closed-loop hint copied on compact when diagnostics.loop_mode is set", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "meta": {"description": "Compact hydrate stamps (source packet ids, clip hints) when discovery/light path composed the packet", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "next_action": {"description": "Recommended MCP action + params", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "next_actions": {"description": "Recovery ladder steps from build_work_next_packet (not only plan_recovery_scan)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "next_work": {"description": "Alternate candidates when detail=full", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "node_id": {"description": "Focused work graph node", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "observed": {"description": "Inverse slots when batch/workflow context is active", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "operator_gate": {"description": "operator_closure gate — speak-first messages when human approval blocks execution", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "panels": {"description": "Always the string expand. Ids are on the expand parameter. Omitting expand still copies pin_slots pointers, and blocked_work plus recovery when state=blocked.", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "pin_limits": {"description": "Pin inventory caps snapshot when expand touches pin_slots/skills", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "pin_slots": {"description": "Pointers on every compact packet. expand=pin_slots adds non-held bodies to skills for this response. Held stays a title.", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "plan_focus": {"description": "Instruction focus node/goal for UI and MCP context", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "plan_summary": {"description": "When detail=full or expand=plan_summary", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Logical project id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "reason": {"description": "Human-readable blocked/idle reason", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "recovery": {"description": "Recovery engine payload when blocked", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "recovery_actions": {"description": "Compact recovery CTAs when state=blocked or wip_full (session-gated extras omitted)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "recovery_hint": {"description": "Short recovery copy for operators", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "rest_surfaces": {"description": "GET|POST /api/projects/{project_id}/orchestrator/work-next (GET read-only; POST claim=false default, claim=true to lease)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "revision": {"description": "Plan graph revision for CAS", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "sandbox_ops": {"description": "Static generation ladder (diff_vs_prod, gates, promote) — omit env_uuid; each action = separate sync execute (GENERATION_SYNC_BATCH_BUDGET)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "semantic_contract": {"description": "Fingerprinted goal facets when goal_text or focus compiles", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "semantic_fingerprint": {"description": "Stable digest alias of semantic_contract.fingerprint", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "skills": {"description": "Clipped bodies when expand includes skills, pin_slots, or skill:<id>. This response only.", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "state": {"description": "actionable | blocked | idle | …", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "viewer_urls": {"description": "Deep links for UI surfaces", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "workflow_diagnostics": {"description": "Non-fatal workflow loop hints (e.g. repeated next_action)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "workflow_revision": {"description": "Monotonic workflow revision after reconcile", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "workflow_run_id": {"description": "Ingress correlation id echoed when workflow context is active", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "workflow_state_key": {"description": "Scope identity (project_id, workflow_run_id, principal_id)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "recovery_ladder": ["agents.plan_compaction_preview → agents.plan_heal_leaf (dry_run then apply) — spill_incomplete or plan_graph_too_large", "agents.plan_recovery_scan — verification_failed candidates + stale claims; optional env_uuid", "agents.plan_propose mode=repair_plan — target node_id; allow_generic_acceptance repair-only", "agents.plan_apply_proposal — same env_uuid as propose on sandbox forks", "agents.work_next handoff=true node_id=… — re-resolve after repair or provision"], "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_claim", "agents.plan_execute", "agents.ensure_agent", "agents.plan_get", "agents.plan_recovery_scan", "agents.graph_health", "discovery.list", "discovery.describe"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_work_next", "semantic_input_mode": "inherit_workflow", "summary": "Agent-native next-work packet. Default detail=compact: state, next_action, reason, revision. panels is the string expand. Pass expand (array or comma string) to inline sections on this response only: ", "title": "Get Next Work Item", "wave_xix_atoms": {"WG_BIND_VS_CLAIM": "node.agent_id binding ≠ active claim lease — already_claimed requires status=in_progress with non-expired lease meta; bound agent on ready/pending is not already_claimed; retry ensure_agent idempotent_replay or plan_claim with if_match_revision.", "WG_BLOCKED_REASON": "blocked_work[].blocked_reason is canonical (block_reason.REASON_PRIORITY); use recovery.next_actions — not validation.missing_roles.", "WG_CAPABILITY_HARD_GATE": "required_capabilities are mandatory — capability_mismatch blocks claim; route agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan; not handoff (capability_hard_gate_v1).", "WG_CLOSED_LOOP_DEPENDENCY": "dependency_blocked — no claim; reason names upstream node_id until deps complete.", "WG_CLOSED_LOOP_EXECUTABLE": "state=actionable (alias executable) and execution_ready — next_action agents.plan_claim with if_match_revision from plan_get.", "WG_CLOSED_LOOP_PLANNING": "planning_required — next_action agents.plan_propose mode=create_plan or decompose_node.", "WG_CLOSED_LOOP_PROVISION": "resolution=provision_required — next_action agents.ensure_agent create=false (H5) then create=true before plan_claim.", "WG_CLOSED_LOOP_STALE_CLAIM": "blocked_reason=expired_claim — next_action agents.plan_reclaim_stale; beats downstream dependency_blocked when no executable leaf.", "WG_CLOSED_LOOP_VERIFY_FAIL": "verification_failed — next_action agents.plan_recovery_scan then repair_plan.", "WG_DEPENDENCY_VS_EXECUTION_READY": "dependency_ready is structural (deps/status/decomposition); execution_ready is fleet (live agent or provision path) — never collapse the two gates.", "WG_DISCOVERY_ROUTE": "Discovery naming: intent_id (taxonomy) ≠ primary_action (router verb) ≠ agents.work_next (fleet pick) — do not treat a route phrase as an MCP action name. discovery.describe requires param action=<catalog action id> (not optional).", "WG_ENSURE_H5": "agents.ensure_agent preview template_id must match agents.work_next top compatible_templates[0] for the same node (harness H5 / resolver_parity_v1).", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_EXECUTION_SUMMARY_ONLY": "Read execution_summary.missing_requirements — missing_roles is legacy; do not infer fleet gaps from validation.missing_roles when execution_summary is present.", "WG_HANDOFF_RECOVERY": "role_mismatch / specialization_mismatch after claim → work_next handoff=true node_id=… — follow recovery.next_actions, do not retry same agent. capability_mismatch is missing required_capabilities: repair_plan or ensure_agent, not handoff.", "WG_HARNESS_GATES": "Dev gates: doctor --full (repo.ops.closed_loop.harness.gen1); key suites: ensure_agent_provision_e2e_v2, ensure_agent_idempotent_retry_v1, bind_vs_claim_semantics_v1, persist_unexecutable_v1, mcp_structured_domain_error_v1, resolver_parity_v1, instruction_plane_dry_v2, planner_runtime_parity_v3.", "WG_HARNESS_STATE": "Blocked agents.work_next packets include diagnostics.harness_state — read-only projection (dependency_ready, execution_ready, blocked_reason); not a second orchestrator.", "WG_LOOP_ERROR_BUDGET": "Loop error budget (WG-SLO-03/04): follow packet.next_action from agents.work_next — discovery.search while next_action is present burns compliance (target ≥90% followed). Heavy batches: options.async=true; full budget GET /mcp/actions execute_budget.", "WG_PLAN_FIRST": "Lightweight progress: agents.work_status (summary_only). Full autonomous loop: agents.work_next — follow next_action, not next_actions[0] parsing.", "WG_PLAN_VALID_NOT_EXECUTABLE": "plan_valid / validation_ok means structural+semantic OK — not fleet-executable; use validation_mode=persist_unexecutable or ensure_agent when plan_valid but not execution_ready; executable_now=false under semantic alias is intentional.", "WG_PROVISION_PARITY": "When execution.fully_provisionable and one top template, recovery routes agents.ensure_agent create=false (H5 preview) — SDK followWorkGraphAction runs ensureAgentSaga for create=true; ambiguous ties → create_from_template choose_template.", "WG_RECOVERY_VERIFICATION_FAILED": "Recovery reason SoT is verification_failed (aliases verify_failed, plan_verify_failed) — call agents.plan_recovery_scan first, then plan_propose mode=repair_plan via recovery.next_actions (not missing_roles).", "WG_ROLE_TAXONOMY": "no_compatible_agent for role=data|data_engineer is a taxonomy alias — prefer agents.ensure_agent create=false (H5) then create=true before repair_plan; create_from_template only when ensure_agent is ambiguous; role_matches_template in role_taxonomy.py is SoT.", "WG_TEAM_OVER_INTEGRATION": "Team-create goals (agents.team.create): discovery rank demotes integrations.* — prefer agents.team.create / agents.orchestrate / agents.plan_* over integrations.oauth_begin.", "WG_WORK_NEXT_LOOP": "Closed loop: plan_get → work_next → next_action → execute/claim → work_next until state=idle. Blocked: read recovery.next_actions or singular next_action."}, "when_blocked": {"agent_daily_cap": "Agent per_day_cap hit — patch AgentSpec.energy or wait for UTC day rollover.", "agent_not_found": "agent_id not in project fleet — use agents.team or plan_get before run_get.", "already_claimed": "agents.work_next — check in_progress lease (H11); handoff if wrong agent; plan_reclaim_stale if stale", "ambiguous_anchor": "patch_text search_replace — longer find, set count, or graph_file_get text window", "approval_hash_mismatch": "agents.run_get — approval_artifact_hash must match pending tool call on the run", "auth_required": "Authenticate before work-graph spine — auth.get_profile → context.project_id → agents.work_next (not discovery.search).", "batch_project_scope_leak": "A failed MCP batch step with params.project_id does not retarget later steps — only auth.switch_project may promote batch context.project_id. Re-bind context.project_id before mutations if a step used a probe pid.", "batch_semantic_anchor_conflict": "Align step NL with batch goal anchor — use one goal_text for the batch or split batches", "batch_semantic_anchor_required": "Batch includes a mutating or non-plain-read step: set options.execution_intent=direct for authorized CRUD, or options.goal, focus_node_id, or plan_execute_mode for workflow. Plain reads and validate_only (e.g. script.put) may run without goal. Use preflight.check simulate_batch_actions + simulate_batch_params (or execution_intent) to preview anchor.", "capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "checklist_gate_open": "Complete checklist gates on meta.checklist_gates (plan_node entity); agents.plan_get node_id=… — do not patch description as a blocker", "claim_empty": "agents.work_next handoff=true — no nodes claimed; refresh claimable set", "claim_heartbeat_failed": "No active in_progress lease for node_id — plan_claim the node before heartbeat_only pin ops", "conflicting_semantic_anchor": "Same as batch_semantic_anchor_conflict — per-step NL vs batch semantic_contract", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "created_agent_not_eligible": "Provision rolled back — plan_propose mode=repair_plan or pick template with matching caps (H5)", "decomposition_blocked": "agents.plan_propose mode=decompose_node — parent has open decomposition children", "dependency_blocked": "agents.plan_get to inspect upstream deps; do not ensure_agent; do not claim", "dependency_error": "Batch only — DAG: a prior step failed or was skipped; fix the first failed step_id. Standalone notifications.deliver / channels.deliver use channel_not_linked or channels.create_bind_link, not dependency_error.", "dependency_failed": "Prerequisite batch step did not succeed — fix or remove dependsOn; poll verification_action before retrying dependent step", "discovery_search_recursion": "Prefer discovery.list (optional domain=) to copy exact action ids, then discovery.describe. If you use discovery.search: one concrete q= per execute, then describe — do not chain many search steps; in goal-anchored batches run search in a separate execute (batch_semantic_anchor_conflict).", "energy_denied": "Insufficient builder_energy before agents.run — energy.get_balance then payments.create intent=energy_pack; follow packet.next_action.", "ensure_agent_stamp_mismatch": "Replay create=false preview; create=true must match preview_template_id + graph_revision", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "fleet_skipped": "Fleet was not loaded for this work_next call (compact/rank-only path) — not the same as no_compatible_agent; load fleet or use full work_next when matching agents to tasks.", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "fully_provisionable": "ensure_agent create=false (H5) then create=true (preferred over create_from_template)", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_address_required": "Personal home needs a resolved session address. Pass home on the tool and ensure the operator session has user_id before patch.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "graph_storage_empty": "Prod task_list leaf is empty at revision 0 with storage hash — restore via generation supply and agents.plan_patch; do not empty-overwrite revision 0.", "guidance_user_row_not_found": "auth.get_profile then agents.work_next handoff=true", "idle": "Orchestrator graph has no tasks yet (revision 0) — valid idle; seed with agents.plan_propose or agents.plan_patch before claim/execute.", "import_pack_personal_home_unsupported": "Orchestrator import pack requires home=project; personal session graphs use export/read paths only.", "internal_execution_error": "agents.plan_recovery_scan → plan_propose mode=repair_plan; retry after catalog refresh", "invalid_channel": "channel must be workspace, messenger, bot, mcp, or api — retry agents.orchestrate with a supported surface", "invalid_detail": "detail/projection/limit validation — see problem.field in error payload", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "invalid_state_transition": "agents.plan_get node status — legal FSM only; completed↔cancelled retries are no-ops", "join_not_allowed": "Project is not open-join — request invite or projects.add_user from an owner.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "membership_required": "Open community hub: call projects.join on context.project_id, then agents.work_next with home=project_self (recipe mcp_community_hub_v1).", "missing_capability": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "missing_required_dependency": "agents.plan_propose mode=decompose_node or repair_plan — facet DAG edge missing (storage→knowledge, logic→scheduler); inspect dependencies_to_add", "mode_not_implemented": "Use create_plan | decompose_node | replan_subtree | repair_plan | optimize_plan — discovery.describe agents.plan_propose", "needs_seed": "Graph revision > 0 but task list is empty — propose or patch a plan; do not run plan_recovery_scan against an intentionally empty graph.", "no_compatible_agent": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "node_already_atomic": "Complexity too low to decompose — agents.work_next or agents.plan_get for another leaf", "node_not_eligible": "agents.plan_get on the same home — node failed evaluate_work_eligibility; agents.work_next handoff=true and follow recovery.next_actions", "node_not_found": "agents.plan_get include_claimable=true — node_id absent from graph slice", "not_authenticated": "MCP is required. This channel has no operator session — authorize first (Connect on plugin AgentStack MCP or /agentstack-authorize). Confirm with mcp-execute.mjs auth.get_profile. Do not retry the unsigned plugin call and do not call mcp_auth.", "not_executable": "kind note and catalog are memory, not work. Do not plan_claim them. Claim a task, step, or issue on the same home.", "operator_closure": "operator_closure: tell the user in chat (operator_gate.messages) and ask yes/no. agents.plan_patch gates_passed only after an explicit yes. terminal means wait, not skip the leaf.", "orchestrate_failed": "resolve_and_run failed — read data.error_code; agents.fleet_diagnostics, agents.reconcile_binding, or agents.run_get when run_uuid is present", "orchestration_step_violation": "Action outside current workflow step — follow packet next_action / inverse_resume; do not mutate graph until step advances. For ad-hoc reads (auth.get_profile) or plan writes outside the spine, rerun the batch with options.execution_mode=plain or options.execution_intent=direct on a single allowed action. For notifications.deliver inside a playbook: run preflight.check first or use packet.next_action — not a raw deliver outside the step allow-list.", "orchestrator_agent_missing": "projects.orchestrator.get then projects.orchestrator.patch (or owner/agents_admin auto-provision on prod); sandbox env_uuid cannot provision — bind on prod and reconcile before sandbox orchestrate", "orchestrator_agent_stale": "Bound agent_uuid no longer matches fleet — agents.reconcile_binding repair=true; agents.ensure_agent when the template row is missing; then agents.work_next handoff=true.", "orchestrator_binding_stale": "agents.reconcile_binding repair=true", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "pin_inventory_full": "Goal pin inventory at active_max — unpin a slot (plan affinity) then retry agents.plan_claim", "pin_slot_not_found": "No matching goal pin slot for skill_id and agent_id — agents.plan_get pin_slots then retry", "plan_archive_no_effect": "Archive patch matched no nodes — agents.plan_get detail=compact; confirm archive_ids / node_id scope; use agents.plan_patch with if_match_revision, not empty ops.", "plan_claim_owner_conflict": "agents.work_next handoff=true — another operator holds the lease", "plan_claim_required": "agents.plan_claim if_match_revision — in_progress lease before agents.plan_execute", "plan_completion_blocked": "Attach completion_predicates evidence; do not retry agents.plan_execute until allowed", "plan_focus_invalid": "agents.work_next detail=compact — refresh focus_node_id from packet next_action", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_children_exceeded": "Direct children per parent are capped (32). Flat parent_id storage counts siblings under each parent_id — not total graph nodes. Split into sub-groups or use agents.plan_propose decompose_node.", "plan_graph_load_failed": "DNA/graph slice failed to load — plan_get (compact) then retry. If patch used a long title (>256), use patch_text or shorten title; see validation_error + field=title instead of this code when preflight maps PGVE.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_private": "Orchestrator graph is private — sign in (user_id in MCP context) or set orchestrator public_read; project API keys must include created_by user.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_ops_parent_missing": "add_child parent_id is not in the graph — create the parent first or fix parent_id. On an empty project graph (revision 0, no tasks), omit parent_id and send {op:add_child, node:{id, title, kind}} with if_match_revision:0 from plan_get; do not use op set for new ids.", "plan_patch_inline_body_spill": "Inline prose exceeds chunk seal — agents.graph_file_put; follow spill recovery in error data", "plan_patch_nodes_missing_from_changed": "Revision moved but new node ids are absent on plan_get — align generation_env_uuid on context and tool params; deploy compaction protect_ids (undated completed purge); run prelude bucket parents before child ingest batches.", "plan_patch_ops_limit": "Too many ops[] in one plan_patch — split batches; plan_get between writes (max 50)", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "planner_duplicate_children": "agents.plan_get — semantic facet children already exist; re-propose is a no-op or use mode=replan_subtree", "planning_blocked": "agents.plan_propose mode=decompose_node or plan_process_backlog — finish planner plane first", "planning_required": "agents.plan_propose mode=create_plan or decompose_node — strategic/decomposition node, not execution", "provision_required": "ensure_agent create=false (H5) then create=true then plan_claim", "provisioning_failed": "create_from_template or bind failed — retry agents.ensure_agent create=false (H5) then create=true", "relogin_required": "Session invalidated (deploy, eviction, or X-Session-Action: relogin_required) — re-authenticate: auth.get_profile or hosted remint; do not retry the same Bearer in a loop.", "replan_budget_exceeded": "Max replans per node exceeded — agents.plan_propose mode=repair_plan on parent or escalation", "role_mismatch": "work_next handoff=true node_id=… — do not retry same agent", "run_failed": "agents.work_next detail=compact — inspect run traces; repair_plan or reclaim before retry", "run_mismatch": "run_id does not belong to the supplied agent_id — omit agent_id or fix the pair.", "run_not_found": "No run row for run_id in this project — verify run_id from agents.run or traces.", "run_not_waiting_for_approval": "agents.run_get — run is not waiting_for_approval; poll status before approve_run", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Key lacks required L1 cap (often mcp_read or project_admin for plan_patch). Widen via apikeys.create (full_project) or reconnect MCP with full OAuth scope. If project role is owner/admin, MCP widens caps for execute project_id — call auth.get_profile (credential_plane) to confirm key_preview and caps; align context.project_id with the tenant before agents.plan_get / plan_patch.", "service_caps_required_in_prod": "Project API key has no L1 service_caps — recreate with admin permissions (auto agents_autonomous_loop in prod) or user.apikeys.create preset agents_autonomous_loop / full_project; pass context.project_id=1 for ecosystem graph.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "skill_mismatch": "agents.work_next handoff=true — skill_ids mismatch; follow recovery.next_actions", "specialization_mismatch": "work_next handoff=true — follow recovery.next_actions", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "status_not_claimable": "agents.plan_get on the same home. Claim only pending or ready nodes, or an in_progress node whose lease has expired.", "supersede_in_progress": "agents.plan_get then wait/retry — in-progress node cannot be superseded without options.force_supersede_in_progress (retryable)", "template_not_found": "agents.templates_list — template_id missing from catalog; agents.template_preview before create=true", "terminal": "agents.work_next — skip terminal node; pick another leaf (completed/cancelled not claimable)", "text_revision_conflict": "patch_text — re-read the field from plan_get; refresh expected_text_sha256", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "unknown_skill_id": "Fix node skill_ids to ecosystem catalog (agents.skills_list); use rag.retrieval / rag.ingest_acceptance — not MCP action names; re-run plan_propose after enrich", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal", "verification_failed": "agents.plan_recovery_scan → plan_propose mode=repair_plan", "waiting_approval": "agents.work_next — wait approval gate; agents.plan_get to inspect approval meta", "waiting_for_approval": "Run status waiting_for_approval — agents.approve_run with approval_artifact_hash from run_detail.", "waiting_input": "agents.work_next — ask_user recovery; do not plan_claim until operator input arrives", "wip_full": "Agent WIP cap reached — agents.plan_get then complete/release in_progress claims; retry plan_claim", "wire_budget_exceeded": "Slice too large — narrow node_id, max_depth, or use detail=cards (detail=body|full past wire budget)", "work_next_enrich_failed": "agents.work_next handoff=true detail=compact", "work_next_hydrate_failed": "Work-graph hydrate failed — run agents.work_next with repair=true and detail=compact; on preflight failures narrow batch targets; on discovery failures narrow scope or defer hydrate.", "work_next_repeat_reconcile_failed": "agents.reconcile_binding repair=true", "workflow_batch_bind_failed": "agents.reconcile_binding repair=true — guidance bind failed; check member row / session", "workflow_batch_bind_skipped": "Binding skipped (read-only batch or missing workflow_run_id) — agents.work_next handoff=true if follow-up work is expected", "workflow_batch_context_bind_failed": "agents.reconcile_binding repair=true — batch context bind failed", "workflow_batch_receipt_failed": "Step succeeded but receipt stamp failed — agents.reconcile_binding repair=true; retry read-only agents.plan_get before mutating", "workflow_inverse_sync_failed": "agents.reconcile_binding repair=true — inverse session sync failed", "workflow_receipt_context_missing": "Active workflow receipt missing workflow_run_id or step_id — agents.reconcile_binding repair=true; agents.work_next handoff=true detail=compact", "workflow_receipt_unbound": "Workflow receipt not bound to session — agents.reconcile_binding repair=true", "workflow_scope_leak": "Batch step params.project_id disagrees with MCP context.project_id — fix the batch, not the work graph: ecosystem bus uses project_id=1 on bots.bus.* while context may be a tenant pin; StackScript/generation steps carry the subject tenant in params; omit duplicate project_id on global reads or align context via auth.switch_project. Run preflight.check — do not plan_heal_leaf or repair_plan for this error.", "workflow_state_key_stamp_failed": "agents.reconcile_binding repair=true — workflow_state_key stamp failed"}, "when_blocked_locales": {"agent_not_found": {"en-US": "agent_id not in fleet — agents.team or plan_get first", "pt-BR": "agent_id fora da frota — agents.team ou plan_get antes", "ru-RU": "agent_id нет во флоте — сначала agents.team или plan_get"}, "already_claimed": {"en-US": "In progress lease — agents.work_next (H11); handoff or plan_reclaim_stale if stale", "pt-BR": "Lease in_progress — agents.work_next (H11); handoff se o agente for outro; plan_reclaim_stale só se expirado", "ru-RU": "Lease in_progress — agents.work_next (H11); handoff если чужой агент; plan_reclaim_stale только если lease протух"}, "capability_mismatch": {"en-US": "Missing required_capabilities — agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan. Not handoff.", "pt-BR": "required_capabilities ausentes — agents.ensure_agent create=false (H5) depois create=true, ou plan_propose mode=repair_plan. Não é handoff.", "ru-RU": "Нет required_capabilities — agents.ensure_agent create=false (H5) затем create=true, или plan_propose mode=repair_plan. Не handoff."}, "checklist_gate_open": {"en-US": "Finish checklist gates (meta.checklist_gates); agents.plan_get node_id=… — use link/dependencies for node blockers, not description", "pt-BR": "Conclua checklist gates (meta.checklist_gates); agents.plan_get node_id=… — bloqueios via link/dependencies, não description", "ru-RU": "Закройте checklist gates (meta.checklist_gates); agents.plan_get node_id=… — блокеры через link/dependencies, не description"}, "claim_heartbeat_failed": {"en-US": "Claim lease missing — plan_claim the node before heartbeat_only pin writes", "pt-BR": "Sem lease — faça plan_claim do nó antes de pin com heartbeat_only", "ru-RU": "Нет lease — сначала plan_claim узла, затем heartbeat_only для pin"}, "created_agent_not_eligible": {"en-US": "Rollback — plan_propose mode=repair_plan or template with matching caps (H5)", "pt-BR": "Rollback — plan_propose mode=repair_plan ou template com caps (H5)", "ru-RU": "Rollback — plan_propose mode=repair_plan или шаблон с caps (H5)"}, "decomposition_blocked": {"en-US": "Decompose first — agents.plan_propose mode=decompose_node on parent", "pt-BR": "Decomponha primeiro — agents.plan_propose mode=decompose_node no parent", "ru-RU": "Сначала decompose — agents.plan_propose mode=decompose_node на parent"}, "dependency_blocked": {"en-US": "Wait on deps — agents.work_next after upstream finishes; agents.plan_get to inspect graph; do not ensure_agent", "pt-BR": "Aguarde deps — agents.work_next após upstream; agents.plan_get para inspecionar o grafo; não ensure_agent", "ru-RU": "Дождитесь deps — agents.work_next после upstream; agents.plan_get для просмотра графа; не ensure_agent"}, "ensure_agent_stamp_mismatch": {"en-US": "Stamp mismatch — replay create=false; create=true must match preview + revision", "pt-BR": "Stamp mismatch — repita create=false; create=true = preview + revision", "ru-RU": "Stamp mismatch — повторите create=false; create=true = preview + revision"}, "expired_claim": {"en-US": "Stale lease — agents.plan_reclaim_stale, then plan_claim with a fresh if_match_revision", "pt-BR": "Lease expirado — agents.plan_reclaim_stale, depois plan_claim com if_match_revision novo", "ru-RU": "Истёк lease — agents.plan_reclaim_stale, затем plan_claim с новым if_match_revision"}, "fleet_skipped": {"en-US": "Fleet load skipped for this work_next request — rank-only or compact read; retry with include_execution_eligibility=true (loads fleet once) or claim=true; do not treat as no_compatible_agent until fleet is loaded.", "pt-BR": "Fleet omitido neste work_next — rank-only ou leitura compact; repita com include_execution_eligibility=true (carrega fleet uma vez) ou claim=true; não trate como no_compatible_agent até carregar fleet.", "ru-RU": "Fleet не загружался для этого work_next — rank-only или compact read; повторите с include_execution_eligibility=true (один раз подгрузит fleet) или claim=true; не считайте no_compatible_agent, пока fleet не подгружен."}, "fully_provisionable": {"en-US": "Template ready — agents.ensure_agent create=false (H5) then create=true (preferred over create_from_template)", "pt-BR": "Template pronto — agents.ensure_agent create=false (H5) depois create=true (preferido a create_from_template)", "ru-RU": "Шаблон готов — agents.ensure_agent create=false (H5) затем create=true (предпочтительнее create_from_template)"}, "graph_storage_empty": {"en-US": "Storage hash shows empty prod leaf — generation supply + plan_patch; never wipe revision 0", "pt-BR": "Leaf prod vazio pelo hash — generation supply + plan_patch; não apague revision 0", "ru-RU": "Пустой prod leaf по hash — generation supply + plan_patch; не затирай revision 0"}, "idle": {"en-US": "Empty graph at revision 0 is idle — agents.plan_propose to seed work; compact work_next skips fleet load", "pt-BR": "Grafo vazio revision 0 — idle; agents.plan_propose para iniciar; compact work_next sem carregar frota", "ru-RU": "Пустой граф revision 0 — idle; agents.plan_propose для старта; compact work_next без загрузки флота"}, "internal_execution_error": {"en-US": "Resolver error — agents.plan_recovery_scan → repair_plan; refresh catalog then retry", "pt-BR": "Erro resolver — agents.plan_recovery_scan → repair_plan; atualize o catálogo e então retry", "ru-RU": "Ошибка resolver — agents.plan_recovery_scan → repair_plan; обновите каталог, затем retry"}, "invalid_parameters": {"en-US": "project_id and run_id required — agent_id optional when run_id is set", "pt-BR": "project_id e run_id obrigatórios — agent_id opcional com run_id", "ru-RU": "Нужны project_id и run_id — agent_id опционален при run_id"}, "missing_capability": {"en-US": "Missing caps — agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "pt-BR": "Caps ausentes — agents.ensure_agent create=false (H5) depois create=true, ou plan_propose mode=repair_plan", "ru-RU": "Нет caps — agents.ensure_agent create=false (H5) затем create=true, или plan_propose mode=repair_plan"}, "missing_required_dependency": {"en-US": "Facet DAG edge missing — agents.plan_get then plan_propose decompose_node or repair_plan", "pt-BR": "Aresta DAG ausente — agents.plan_get depois plan_propose decompose_node ou repair_plan", "ru-RU": "Нет ребра DAG — agents.plan_get затем plan_propose decompose_node или repair_plan"}, "needs_seed": {"en-US": "Revision > 0 but no tasks — agents.plan_propose or plan_patch; not graph_storage_empty corruption", "pt-BR": "Revision > 0 sem tarefas — agents.plan_propose ou plan_patch; não é graph_storage_empty", "ru-RU": "Revision > 0 без задач — agents.plan_propose или plan_patch; это не graph_storage_empty"}, "no_compatible_agent": {"en-US": "No fleet match — agents.ensure_agent create=false (H5) then create=true, or repair_plan", "pt-BR": "Sem agente na frota — agents.ensure_agent create=false (H5) depois create=true ou repair_plan", "ru-RU": "Нет агента во флоте — agents.ensure_agent create=false (H5) затем create=true или repair_plan"}, "operator_closure": {"en-US": "operator_closure: tell the user in chat (operator_gate.messages) and ask yes/no. agents.plan_patch gates_passed only after an explicit yes. terminal means wait, not skip the leaf.", "pt-BR": "operator_closure: diga ao usuário no chat (operator_gate.messages) e peça sim/não. agents.plan_patch só depois do sim. terminal significa esperar, não pular o nó.", "ru-RU": "operator_closure: скажи пользователю в чате (operator_gate.messages) и спроси да/нет. agents.plan_patch (gates_passed) только после явного «да». terminal = ждать, не пропускать узел."}, "permission_denied": {"en-US": "RBAC denied — rbac.check_permission, membership, or dev-operator persona", "pt-BR": "RBAC negado — rbac.check_permission, membership ou persona dev-operator", "ru-RU": "RBAC отказ — rbac.check_permission, членство или dev-operator persona"}, "pin_inventory_full": {"en-US": "Pin inventory full — unpin a goal slot, then retry agents.plan_claim", "pt-BR": "Inventário de pin cheio — desafixe um slot, depois agents.plan_claim", "ru-RU": "Инвентарь pin заполнен — освободите слот, затем agents.plan_claim"}, "pin_slot_not_found": {"en-US": "Pin slot not found — check skill_id and agent_id on the goal inventory", "pt-BR": "Slot pin não encontrado — confira skill_id e agent_id no inventário da meta", "ru-RU": "Слот pin не найден — проверьте skill_id и agent_id в инвентаре цели"}, "plan_claim_required": {"en-US": "Claim lease first — agents.plan_claim with if_match_revision, then agents.plan_execute", "pt-BR": "Lease primeiro — agents.plan_claim com if_match_revision, depois agents.plan_execute", "ru-RU": "Сначала lease — agents.plan_claim с if_match_revision, затем agents.plan_execute"}, "plan_completion_blocked": {"en-US": "Completion blocked — attach completion_predicates evidence; do not retry plan_execute", "pt-BR": "Conclusão bloqueada — anexe completion_predicates; não repita plan_execute", "ru-RU": "Завершение заблокировано — приложите completion_predicates; не повторяйте plan_execute"}, "plan_graph_load_failed": {"en-US": "Graph load failed — agents.plan_get (compact) then retry. Long titles: max 256 chars (field=title); use patch_text for prose.", "pt-BR": "Falha ao carregar grafo — agents.plan_get (compact) e retry. title ≤256; texto longo — patch_text.", "ru-RU": "Не загрузился граф — agents.plan_get (compact), затем patch. title ≤256; длинный текст — patch_text."}, "plan_revision_conflict": {"en-US": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal", "pt-BR": "Conflito CAS — agents.plan_get recarregue if_match_revision; nunca apply proposal obsoleto", "ru-RU": "CAS конфликт — agents.plan_get перечитать if_match_revision; не apply устаревший proposal"}, "planner_duplicate_children": {"en-US": "Duplicate facet children — agents.plan_get; skip re-propose or use mode=replan_subtree", "pt-BR": "Filhos facet duplicados — agents.plan_get; pule re-propose ou use mode=replan_subtree", "ru-RU": "Дубли facet children — agents.plan_get; не re-propose или mode=replan_subtree"}, "planning_blocked": {"en-US": "Planner plane blocked — agents.plan_propose mode=decompose_node or plan_process_backlog first", "pt-BR": "Plano bloqueado — agents.plan_propose mode=decompose_node ou plan_process_backlog primeiro", "ru-RU": "Планер заблокирован — сначала agents.plan_propose mode=decompose_node или plan_process_backlog"}, "planning_required": {"en-US": "Plan first — agents.plan_propose mode=create_plan or decompose_node (not execution)", "pt-BR": "Planeje primeiro — agents.plan_propose mode=create_plan ou decompose_node (não execução)", "ru-RU": "Сначала план — agents.plan_propose mode=create_plan или decompose_node (не execution)"}, "provision_required": {"en-US": "Provision — agents.ensure_agent create=false (H5) then create=true, then plan_claim", "pt-BR": "Provisione — agents.ensure_agent create=false (H5) depois create=true, então plan_claim", "ru-RU": "Провижн — agents.ensure_agent create=false (H5) затем create=true, затем plan_claim"}, "role_mismatch": {"en-US": "Handoff — agents.work_next handoff=true node_id=…; follow recovery.next_actions; do not retry same agent", "pt-BR": "Handoff — agents.work_next handoff=true node_id=…; siga recovery.next_actions; não repita o mesmo agente", "ru-RU": "Handoff — agents.work_next handoff=true node_id=…; следуйте recovery.next_actions; не повторяйте того же агента"}, "run_failed": {"en-US": "Run failed — agents.work_next then traces or plan_recovery_scan before retry", "pt-BR": "Run failed — agents.work_next, depois traces ou plan_recovery_scan antes de retry", "ru-RU": "Run failed — agents.work_next, затем traces или plan_recovery_scan перед retry"}, "run_mismatch": {"en-US": "run_id does not match agent_id — omit agent_id or fix the pair", "pt-BR": "run_id não combina com agent_id — omita agent_id ou corrija o par", "ru-RU": "run_id не совпадает с agent_id — уберите agent_id или исправьте пару"}, "run_not_found": {"en-US": "No run for run_id — verify from agents.run or traces", "pt-BR": "Sem run para run_id — verifique agents.run ou traces", "ru-RU": "Нет run для run_id — проверьте agents.run или traces"}, "service_cap_denied": {"en-US": "Widen caps (apikeys.create full_project) or OAuth reconnect; owner/admin gets L1 widen on execute project_id — auth.get_profile credential_plane", "pt-BR": "Amplie caps (apikeys.create full_project) ou reconecte OAuth; owner/admin recebe widen no execute project_id — auth.get_profile credential_plane", "ru-RU": "Расширьте caps (apikeys.create full_project) или переподключите OAuth; owner/admin получает widen на execute project_id — auth.get_profile credential_plane"}, "service_caps_required_in_prod": {"en-US": "Project key missing L1 service_caps — apikeys.create with agents_autonomous_loop on pid=1", "pt-BR": "Chave sem service_caps — apikeys.create com agents_autonomous_loop em pid=1", "ru-RU": "У project key нет service_caps — apikeys.create с agents_autonomous_loop на pid=1"}, "skill_mismatch": {"en-US": "Skill mismatch — agents.work_next handoff=true; follow recovery.next_actions", "pt-BR": "Skill mismatch — agents.work_next handoff=true; siga recovery.next_actions", "ru-RU": "Skill mismatch — agents.work_next handoff=true; следуйте recovery.next_actions"}, "specialization_mismatch": {"en-US": "Specialization mismatch — agents.work_next handoff=true; follow recovery.next_actions", "pt-BR": "Especialização incompatível — agents.work_next handoff=true; siga recovery.next_actions", "ru-RU": "Несовпадение специализации — agents.work_next handoff=true; следуйте recovery.next_actions"}, "supersede_in_progress": {"en-US": "In-progress supersede blocked — agents.plan_get, wait/retry (or force_supersede_in_progress)", "pt-BR": "Supersede in_progress bloqueado — agents.plan_get, aguarde/retry (ou force_supersede_in_progress)", "ru-RU": "Supersede in_progress заблокирован — agents.plan_get, wait/retry (или force_supersede_in_progress)"}, "terminal": {"en-US": "Terminal node — agents.work_next skip; not claimable (completed/cancelled)", "pt-BR": "Nó terminal — agents.work_next pule; não claimable (concluído/cancelado)", "ru-RU": "Терминальный узел — agents.work_next пропустить; не claimable"}, "unknown_skill_id": {"en-US": "Fix skill_ids — agents.skills_list, use rag.* catalog ids, re-run plan_propose", "pt-BR": "Corrija skill_ids — agents.skills_list, ids do catálogo rag.*, plan_propose de novo", "ru-RU": "Исправь skill_ids — agents.skills_list, id из каталога rag.*, снова plan_propose"}, "verification_failed": {"en-US": "Verification failed — agents.plan_recovery_scan → plan_propose mode=repair_plan", "pt-BR": "Verificação falhou — agents.plan_recovery_scan → plan_propose mode=repair_plan", "ru-RU": "Верификация не прошла — agents.plan_recovery_scan → plan_propose mode=repair_plan"}, "waiting_approval": {"en-US": "Waiting approval — agents.work_next wait gate; agents.plan_get inspect approval meta", "pt-BR": "Aguardando aprovação — agents.work_next aguarde; agents.plan_get inspecione meta", "ru-RU": "Ожидание approval — agents.work_next wait; agents.plan_get для meta approval"}, "waiting_for_approval": {"en-US": "Run waiting_for_approval — agents.approve_run with approval_artifact_hash", "pt-BR": "Run waiting_for_approval — agents.approve_run com approval_artifact_hash", "ru-RU": "Run waiting_for_approval — agents.approve_run с approval_artifact_hash"}, "waiting_input": {"en-US": "Waiting input — agents.work_next ask_user; no plan_claim until operator responds", "pt-BR": "Aguardando entrada — agents.work_next ask_user; sem plan_claim até resposta", "ru-RU": "Ожидание ввода — agents.work_next ask_user; без plan_claim до ответа оператора"}, "wip_full": {"en-US": "WIP cap — complete/release in_progress claims; agents.plan_get then retry plan_claim", "pt-BR": "Cap WIP — conclua/libere claims in_progress; agents.plan_get depois plan_claim", "ru-RU": "Лимит WIP — завершите/освободите in_progress; agents.plan_get затем plan_claim"}}, "when_not_to_use": "Do not infer missing_roles from validation when execution_summary is present.", "when_to_use": "After VPS backend restart, first agents.work_next may fail while MCP tools import — wait ~15s and retry once (not a plan graph bug). Bound project: agents.work_next (recipe mcp_work_loop_v1) before ca", "write_mode": null}, {"action": "agents.work_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not use for autonomous closed loop or claiming — agents.work_next instead.", "anti_patterns": ["Do not use for autonomous closed loop or claiming — agents.work_next instead.", "Do not parse next_actions[0]; read packet.next_action on work_next only."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.work_status", "related_tools": ["agents.work_next", "agents.plan_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Work Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Summary-only plan progress (state idle|waiting|blocked|actionable, plan_summary). No claim params — use agents.work_next for executable leaf + canonical next_action."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.work_status", "related_tools": ["agents.work_next", "agents.plan_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Work Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Summary-only plan progress (state idle|waiting|blocked|actionable, plan_summary). No claim params — use agents.work_next for executable leaf + canonical next_action."}, "do_not_use_when": "Do not use for autonomous closed loop or claiming — agents.work_next instead.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Summary-only plan progress (state idle|waiting|blocked|actionable, plan_summary). No claim params —…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.work_next", "agents.plan_get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.work_next", "agents.plan_get"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_work_status", "semantic_input_mode": "inherit_workflow", "summary": "Plan summary only: task counts and execution-ready leaves. The packet is small; the server still reads the plan leaf to count it. No node pick.", "title": "Agents Work Status", "wave_xix_atoms": {"WG_COLD_START_VS_ROUTE": "Cold start: no project_id → agentstack_session_setup only. Do not discovery.search until context.project_id is set. Bound project: agents.work_next first; discovery.search only when packet.next_action is absent. Status-only poll → agents.work_status (no claim params).", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_PLAN_FIRST": "Lightweight progress: agents.work_status (summary_only). Full autonomous loop: agents.work_next — follow next_action, not next_actions[0] parsing."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not use for autonomous closed loop or claiming — agents.work_next instead.", "when_to_use": "Summary-only plan progress (state idle|waiting|blocked|actionable, plan_summary). No claim params — use agents.work_next for executable leaf + canonical next_action.", "write_mode": null}, {"action": "agents.plan_reconcile_diagnostics", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_reconcile_diagnostics", "mutation_risk": "low", "related_tools": ["agents.reconcile_binding", "agents.plan_get", "agents.plan_propose", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Reconcile Diagnostics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After fleet heal or agents.reconcile_binding on home=project|self|project_self — close open diag-* nodes with finding_absent evidence; env_uuid only with home=project."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_reconcile_diagnostics", "mutation_risk": "low", "related_tools": ["agents.reconcile_binding", "agents.plan_get", "agents.plan_propose", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Reconcile Diagnostics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After fleet heal or agents.reconcile_binding on home=project|self|project_self — close open diag-* nodes with finding_absent evidence; env_uuid only with home=project."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "After fleet heal or agents.reconcile_binding on home=project|self|project_self — close open diag-* …", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_propose", "agents.plan_get", "agents.work_next"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.reconcile_binding", "agents.plan_get", "agents.plan_propose", "agents.work_next"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_reconcile_diagnostics", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Auto-complete open diagnostic plan nodes when live findings are cleared (statuses_toward_completed: typically pending→verifying→completed).", "title": "Agents Plan Reconcile Diagnostics", "wave_xix_atoms": {"MCP_DOMAIN_ERROR": "Domain denial: tools/call isError=false with structuredContent (ok=false, error_code, failure_kind=domain, recovery). Transport/internal uses isError=true (failure_kind=transport). plan_revision_conflict → agents.plan_get then retry with fresh if_match_revision.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After fleet heal or agents.reconcile_binding on home=project|self|project_self — close open diag-* nodes with finding_absent evidence; env_uuid only with home=project.", "write_mode": null}, {"action": "agents.reconcile_binding", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "mutates_when": {"repair": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.reconcile_binding", "mutates_when": {"repair": true}, "mutation_risk": "low", "recovery_blocks": {"guidance_user_row_not_found": {"next_actions": [{"action": "agents.work_next", "params": {"handoff": true}}], "reason": "guidance_user_row_not_found"}, "orchestrator_binding_stale": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "orchestrator_binding_stale"}, "work_next_enrich_failed": {"next_actions": [{"action": "agents.work_next", "params": {"detail": "compact", "handoff": true}}], "reason": "work_next_enrich_failed"}, "work_next_repeat_reconcile_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "work_next_repeat_reconcile_failed"}, "workflow_batch_bind_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_bind_failed"}, "workflow_batch_bind_skipped": {"next_actions": [{"action": "agents.work_next", "params": {"repair": true}}], "reason": "workflow_batch_bind_skipped"}, "workflow_batch_context_bind_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_context_bind_failed"}, "workflow_batch_receipt_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_receipt_failed"}, "workflow_inverse_sync_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_inverse_sync_failed"}, "workflow_receipt_context_missing": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_context_missing"}, "workflow_receipt_unbound": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_unbound"}, "workflow_state_key_stamp_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_state_key_stamp_failed"}}, "related_tools": ["agents.fleet_diagnostics", "agents.plan_get", "agents.plan_execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Reconcile Binding", "when_blocked": {"agent_daily_cap": "Agent per_day_cap hit — patch AgentSpec.energy or wait for UTC day rollover.", "batch_project_scope_leak": "A failed MCP batch step with params.project_id does not retarget later steps — only auth.switch_project may promote batch context.project_id. Re-bind context.project_id before mutations if a step used a probe pid.", "batch_semantic_anchor_conflict": "Align step NL with batch goal anchor — use one goal_text for the batch or split batches", "batch_semantic_anchor_required": "Batch includes a mutating or non-plain-read step: set options.execution_intent=direct for authorized CRUD, or options.goal, focus_node_id, or plan_execute_mode for workflow. Plain reads and validate_only (e.g. script.put) may run without goal. Use preflight.check simulate_batch_actions + simulate_batch_params (or execution_intent) to preview anchor.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dependency_failed": "Prerequisite batch step did not succeed — fix or remove dependsOn; poll verification_action before retrying dependent step", "discovery_search_recursion": "Prefer discovery.list (optional domain=) to copy exact action ids, then discovery.describe. If you use discovery.search: one concrete q= per execute, then describe — do not chain many search steps; in goal-anchored batches run search in a separate execute (batch_semantic_anchor_conflict).", "energy_denied": "Insufficient builder_energy before agents.run — energy.get_balance then payments.create intent=energy_pack; follow packet.next_action.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "guidance_user_row_not_found": "auth.get_profile then agents.work_next handoff=true", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestration_step_violation": "Action outside current workflow step — follow packet next_action / inverse_resume; do not mutate graph until step advances. For ad-hoc reads (auth.get_profile) or plan writes outside the spine, rerun the batch with options.execution_mode=plain or options.execution_intent=direct on a single allowed action. For notifications.deliver inside a playbook: run preflight.check first or use packet.next_action — not a raw deliver outside the step allow-list.", "orchestrator_agent_stale": "Bound agent_uuid no longer matches fleet — agents.reconcile_binding repair=true; agents.ensure_agent when the template row is missing; then agents.work_next handoff=true.", "orchestrator_binding_stale": "agents.reconcile_binding repair=true", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_archive_no_effect": "Archive patch matched no nodes — agents.plan_get detail=compact; confirm archive_ids / node_id scope; use agents.plan_patch with if_match_revision, not empty ops.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "work_next_enrich_failed": "agents.work_next handoff=true detail=compact", "work_next_repeat_reconcile_failed": "agents.reconcile_binding repair=true", "workflow_batch_bind_failed": "agents.reconcile_binding repair=true — guidance bind failed; check member row / session", "workflow_batch_bind_skipped": "Binding skipped (read-only batch or missing workflow_run_id) — agents.work_next handoff=true if follow-up work is expected", "workflow_batch_context_bind_failed": "agents.reconcile_binding repair=true — batch context bind failed", "workflow_batch_receipt_failed": "Step succeeded but receipt stamp failed — agents.reconcile_binding repair=true; retry read-only agents.plan_get before mutating", "workflow_inverse_sync_failed": "agents.reconcile_binding repair=true — inverse session sync failed", "workflow_receipt_context_missing": "Active workflow receipt missing workflow_run_id or step_id — agents.reconcile_binding repair=true; agents.work_next handoff=true detail=compact", "workflow_receipt_unbound": "Workflow receipt not bound to session — agents.reconcile_binding repair=true", "workflow_scope_leak": "Batch step params.project_id disagrees with MCP context.project_id — fix the batch, not the work graph: ecosystem bus uses project_id=1 on bots.bus.* while context may be a tenant pin; StackScript/generation steps carry the subject tenant in params; omit duplicate project_id on global reads or align context via auth.switch_project. Run preflight.check — do not plan_heal_leaf or repair_plan for this error.", "workflow_state_key_stamp_failed": "agents.reconcile_binding repair=true — workflow_state_key stamp failed"}, "when_to_use": "Validate/repair orchestrator agent_uuid vs fleet index. repair=true mutates binding. Pass home=project|self|project_self to reconcile diagnostic plan nodes on that leaf; env_uuid only with home=projec"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "mutates_when": {"repair": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.reconcile_binding", "mutates_when": {"repair": true}, "mutation_risk": "low", "recovery_blocks": {"guidance_user_row_not_found": {"next_actions": [{"action": "agents.work_next", "params": {"handoff": true}}], "reason": "guidance_user_row_not_found"}, "orchestrator_binding_stale": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "orchestrator_binding_stale"}, "work_next_enrich_failed": {"next_actions": [{"action": "agents.work_next", "params": {"detail": "compact", "handoff": true}}], "reason": "work_next_enrich_failed"}, "work_next_repeat_reconcile_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "work_next_repeat_reconcile_failed"}, "workflow_batch_bind_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_bind_failed"}, "workflow_batch_bind_skipped": {"next_actions": [{"action": "agents.work_next", "params": {"repair": true}}], "reason": "workflow_batch_bind_skipped"}, "workflow_batch_context_bind_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_context_bind_failed"}, "workflow_batch_receipt_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_receipt_failed"}, "workflow_inverse_sync_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_inverse_sync_failed"}, "workflow_receipt_context_missing": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_context_missing"}, "workflow_receipt_unbound": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_unbound"}, "workflow_state_key_stamp_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_state_key_stamp_failed"}}, "related_tools": ["agents.fleet_diagnostics", "agents.plan_get", "agents.plan_execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Reconcile Binding", "when_blocked": {"agent_daily_cap": "Agent per_day_cap hit — patch AgentSpec.energy or wait for UTC day rollover.", "batch_project_scope_leak": "A failed MCP batch step with params.project_id does not retarget later steps — only auth.switch_project may promote batch context.project_id. Re-bind context.project_id before mutations if a step used a probe pid.", "batch_semantic_anchor_conflict": "Align step NL with batch goal anchor — use one goal_text for the batch or split batches", "batch_semantic_anchor_required": "Batch includes a mutating or non-plain-read step: set options.execution_intent=direct for authorized CRUD, or options.goal, focus_node_id, or plan_execute_mode for workflow. Plain reads and validate_only (e.g. script.put) may run without goal. Use preflight.check simulate_batch_actions + simulate_batch_params (or execution_intent) to preview anchor.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dependency_failed": "Prerequisite batch step did not succeed — fix or remove dependsOn; poll verification_action before retrying dependent step", "discovery_search_recursion": "Prefer discovery.list (optional domain=) to copy exact action ids, then discovery.describe. If you use discovery.search: one concrete q= per execute, then describe — do not chain many search steps; in goal-anchored batches run search in a separate execute (batch_semantic_anchor_conflict).", "energy_denied": "Insufficient builder_energy before agents.run — energy.get_balance then payments.create intent=energy_pack; follow packet.next_action.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "guidance_user_row_not_found": "auth.get_profile then agents.work_next handoff=true", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestration_step_violation": "Action outside current workflow step — follow packet next_action / inverse_resume; do not mutate graph until step advances. For ad-hoc reads (auth.get_profile) or plan writes outside the spine, rerun the batch with options.execution_mode=plain or options.execution_intent=direct on a single allowed action. For notifications.deliver inside a playbook: run preflight.check first or use packet.next_action — not a raw deliver outside the step allow-list.", "orchestrator_agent_stale": "Bound agent_uuid no longer matches fleet — agents.reconcile_binding repair=true; agents.ensure_agent when the template row is missing; then agents.work_next handoff=true.", "orchestrator_binding_stale": "agents.reconcile_binding repair=true", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_archive_no_effect": "Archive patch matched no nodes — agents.plan_get detail=compact; confirm archive_ids / node_id scope; use agents.plan_patch with if_match_revision, not empty ops.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "work_next_enrich_failed": "agents.work_next handoff=true detail=compact", "work_next_repeat_reconcile_failed": "agents.reconcile_binding repair=true", "workflow_batch_bind_failed": "agents.reconcile_binding repair=true — guidance bind failed; check member row / session", "workflow_batch_bind_skipped": "Binding skipped (read-only batch or missing workflow_run_id) — agents.work_next handoff=true if follow-up work is expected", "workflow_batch_context_bind_failed": "agents.reconcile_binding repair=true — batch context bind failed", "workflow_batch_receipt_failed": "Step succeeded but receipt stamp failed — agents.reconcile_binding repair=true; retry read-only agents.plan_get before mutating", "workflow_inverse_sync_failed": "agents.reconcile_binding repair=true — inverse session sync failed", "workflow_receipt_context_missing": "Active workflow receipt missing workflow_run_id or step_id — agents.reconcile_binding repair=true; agents.work_next handoff=true detail=compact", "workflow_receipt_unbound": "Workflow receipt not bound to session — agents.reconcile_binding repair=true", "workflow_scope_leak": "Batch step params.project_id disagrees with MCP context.project_id — fix the batch, not the work graph: ecosystem bus uses project_id=1 on bots.bus.* while context may be a tenant pin; StackScript/generation steps carry the subject tenant in params; omit duplicate project_id on global reads or align context via auth.switch_project. Run preflight.check — do not plan_heal_leaf or repair_plan for this error.", "workflow_state_key_stamp_failed": "agents.reconcile_binding repair=true — workflow_state_key stamp failed"}, "when_to_use": "Validate/repair orchestrator agent_uuid vs fleet index. repair=true mutates binding. Pass home=project|self|project_self to reconcile diagnostic plan nodes on that leaf; env_uuid only with home=projec"}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_param_sensitive": true, "conditional_mutate": "repair=false — orchestrator/fleet preview only (no DNA or fleet writes); repair=true (default) may rebind or reprovision.", "effect_depends_on_params": true, "execution_class": "cheap", "generation": true, "kind": "mutate", "mutates_when": {"repair": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Validate/repair orchestrator agent_uuid vs fleet index. repair=true mutates binding. Pass home=proj…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.fleet_diagnostics", "agents.plan_get", "agents.plan_execute"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.fleet_diagnostics", "agents.plan_get", "agents.plan_execute"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_reconcile_binding", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Validate and repair project orchestrator agent_uuid vs fleet index and lineage.", "title": "Agents Reconcile Binding", "wave_xix_atoms": {"MCP_DOMAIN_ERROR": "Domain denial: tools/call isError=false with structuredContent (ok=false, error_code, failure_kind=domain, recovery). Transport/internal uses isError=true (failure_kind=transport). plan_revision_conflict → agents.plan_get then retry with fresh if_match_revision.", "WG_BIND_VS_CLAIM": "node.agent_id binding ≠ active claim lease — already_claimed requires status=in_progress with non-expired lease meta; bound agent on ready/pending is not already_claimed; retry ensure_agent idempotent_replay or plan_claim with if_match_revision.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks."}, "when_blocked": {"agent_daily_cap": "Agent per_day_cap hit — patch AgentSpec.energy or wait for UTC day rollover.", "batch_project_scope_leak": "A failed MCP batch step with params.project_id does not retarget later steps — only auth.switch_project may promote batch context.project_id. Re-bind context.project_id before mutations if a step used a probe pid.", "batch_semantic_anchor_conflict": "Align step NL with batch goal anchor — use one goal_text for the batch or split batches", "batch_semantic_anchor_required": "Batch includes a mutating or non-plain-read step: set options.execution_intent=direct for authorized CRUD, or options.goal, focus_node_id, or plan_execute_mode for workflow. Plain reads and validate_only (e.g. script.put) may run without goal. Use preflight.check simulate_batch_actions + simulate_batch_params (or execution_intent) to preview anchor.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dependency_failed": "Prerequisite batch step did not succeed — fix or remove dependsOn; poll verification_action before retrying dependent step", "discovery_search_recursion": "Prefer discovery.list (optional domain=) to copy exact action ids, then discovery.describe. If you use discovery.search: one concrete q= per execute, then describe — do not chain many search steps; in goal-anchored batches run search in a separate execute (batch_semantic_anchor_conflict).", "energy_denied": "Insufficient builder_energy before agents.run — energy.get_balance then payments.create intent=energy_pack; follow packet.next_action.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "guidance_user_row_not_found": "auth.get_profile then agents.work_next handoff=true", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestration_step_violation": "Action outside current workflow step — follow packet next_action / inverse_resume; do not mutate graph until step advances. For ad-hoc reads (auth.get_profile) or plan writes outside the spine, rerun the batch with options.execution_mode=plain or options.execution_intent=direct on a single allowed action. For notifications.deliver inside a playbook: run preflight.check first or use packet.next_action — not a raw deliver outside the step allow-list.", "orchestrator_agent_stale": "Bound agent_uuid no longer matches fleet — agents.reconcile_binding repair=true; agents.ensure_agent when the template row is missing; then agents.work_next handoff=true.", "orchestrator_binding_stale": "agents.reconcile_binding repair=true", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_archive_no_effect": "Archive patch matched no nodes — agents.plan_get detail=compact; confirm archive_ids / node_id scope; use agents.plan_patch with if_match_revision, not empty ops.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "work_next_enrich_failed": "agents.work_next handoff=true detail=compact", "work_next_repeat_reconcile_failed": "agents.reconcile_binding repair=true", "workflow_batch_bind_failed": "agents.reconcile_binding repair=true — guidance bind failed; check member row / session", "workflow_batch_bind_skipped": "Binding skipped (read-only batch or missing workflow_run_id) — agents.work_next handoff=true if follow-up work is expected", "workflow_batch_context_bind_failed": "agents.reconcile_binding repair=true — batch context bind failed", "workflow_batch_receipt_failed": "Step succeeded but receipt stamp failed — agents.reconcile_binding repair=true; retry read-only agents.plan_get before mutating", "workflow_inverse_sync_failed": "agents.reconcile_binding repair=true — inverse session sync failed", "workflow_receipt_context_missing": "Active workflow receipt missing workflow_run_id or step_id — agents.reconcile_binding repair=true; agents.work_next handoff=true detail=compact", "workflow_receipt_unbound": "Workflow receipt not bound to session — agents.reconcile_binding repair=true", "workflow_scope_leak": "Batch step params.project_id disagrees with MCP context.project_id — fix the batch, not the work graph: ecosystem bus uses project_id=1 on bots.bus.* while context may be a tenant pin; StackScript/generation steps carry the subject tenant in params; omit duplicate project_id on global reads or align context via auth.switch_project. Run preflight.check — do not plan_heal_leaf or repair_plan for this error.", "workflow_state_key_stamp_failed": "agents.reconcile_binding repair=true — workflow_state_key stamp failed"}, "when_to_use": "Validate/repair orchestrator agent_uuid vs fleet index. repair=true mutates binding. Pass home=project|self|project_self to reconcile diagnostic plan nodes on that leaf; env_uuid only with home=projec", "write_mode": null}, {"action": "agents.instruction_rules_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.instruction_rules_list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Instruction Rules List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Orchestration Studio — inspect instruction_rules before editing overlay."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.instruction_rules_list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Instruction Rules List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Orchestration Studio — inspect instruction_rules before editing overlay."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Orchestration Studio — inspect instruction_rules before editing overlay.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_instruction_rules_list", "semantic_input_mode": "inherit_workflow", "summary": "List merged platform instruction rules (fixture + ecosystem overlay).", "title": "Agents Instruction Rules List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Orchestration Studio — inspect instruction_rules before editing overlay.", "write_mode": null}, {"action": "agents.instruction_rules_upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.instruction_rules_upsert", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Instruction Rules Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Orchestration Studio — persist operator rule overlay (ecosystem project only)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.instruction_rules_upsert", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Instruction Rules Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Orchestration Studio — persist operator rule overlay (ecosystem project only)."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Orchestration Studio — persist operator rule overlay (ecosystem project only).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_instruction_rules_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Upsert one instruction rule on ecosystem project overlay (8DNA leaf).", "title": "Agents Instruction Rules Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Orchestration Studio — persist operator rule overlay (ecosystem project only).", "write_mode": null}, {"action": "agents.health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.health", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops check before agents.list when fleet_warming 503 appears."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.health", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops check before agents.list when fleet_warming 503 appears."}, "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Ops check before agents.list when fleet_warming 503 appears.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_health", "semantic_input_mode": "inherit_workflow", "summary": "Fleet ECS index health for a project (agents/bots organelle diagnostics).", "title": "Agents Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops check before agents.list when fleet_warming 503 appears.", "write_mode": null}, {"action": "agents.graph_file_put", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not set rag_ingest without an explicit RAG/knowledge goal.", "anti_patterns": ["Do not set rag_ingest without an explicit RAG/knowledge goal.", "Do not paste file bodies into plan_patch set or node prompt — use graph_file_get.", "Do not skip storage.list_files (folder + file_id from storage_roundtrip_hint) after upload."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.graph_file_put", "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Graph File Put", "when_blocked": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "upload_failed": "Storage quota, extension, or organelle upload error", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Channel file: this stores the bytes and the run attaches storage_file_id. Do not paste that body into the finish message. Manual spill (agent-authored): upload bytes to ecosystem storage, append meta."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.graph_file_put", "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Graph File Put", "when_blocked": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "upload_failed": "Storage quota, extension, or organelle upload error", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Channel file: this stores the bytes and the run attaches storage_file_id. Do not paste that body into the finish message. Manual spill (agent-authored): upload bytes to ecosystem storage, append meta."}, "do_not_use_when": "Do not set rag_ingest without an explicit RAG/knowledge goal.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "if_match_revision from plan_get; verify via storage_roundtrip_hint.", "name": "Upload with graph CAS", "request": {"params": {"content": "# Goal", "filename": "spec.md", "home": "project", "if_match_revision": 12, "node_id": "task-a", "project_id": 1}, "tool": "agents.graph_file_put"}, "response": {"data": {"revision": 13, "storage_ref": {"file_id": "abc", "folder_key": "graph__node_task-a"}, "storage_roundtrip_hint": {"file_id": "abc", "folder": "graph__node_task-a", "verify_action": "storage.list_files"}}, "success": true}}, {"description": "Pass env_uuid from generation.fork receipt; same revision discipline as agents.plan_get.", "name": "Sandbox fork (auto_generation_mode)", "request": {"params": {"content": "# Draft", "field": "prompt", "filename": "spec.md", "home": "project", "if_match_revision": 3, "node_id": "task-a", "project_id": 1}, "tool": "agents.graph_file_put"}, "response": {"data": {"revision": 4, "storage_ref": {"file_id": "abc"}}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "graph_file_mcp_errors": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "storage.read or project_admin cap missing for scope", "generation_fork_required": "auto_generation_mode on — pass env_uuid from generation.fork for home=project mutations", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "Missing required params or binary file for text edit", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "plan_revision_conflict": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal after concurrent plan_patch or graph_file_*.", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Operator session or API key required", "upload_failed": "Storage quota, extension, or organelle upload error"}, "instruction_hint": "Channel file: this stores the bytes and the run attaches storage_file_id. Do not paste that body in…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_get", "storage.list_files", "agents.graph_file_get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_graph_file_put", "semantic_input_mode": "inherit_workflow", "summary": "Upload bytes to storage and append StorageRefV1 on a plan node.", "title": "Agents Graph File Put", "wave_xix_atoms": {"WG_CAS_RETRY": "plan_revision_conflict → plan_get reload if_match_revision — never apply stale proposal after concurrent plan_patch or backlog apply.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_STORAGE_NOT_KNOWLEDGE": "File upload / document persistence → storage.* (MCP operator or REST binary upload). Do not ingest to knowledge unless the goal requests RAG/Q&A/semantic search.", "WG_VERIFY_AFTER_WRITE": "After each platform mutation, verify via canonical read on meta.verify_after_write_action (storage.list_files, crm.list_contacts, logic.dry_run, rag.search) — attach evidence, do not mark complete from agent prose alone."}, "when_blocked": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "upload_failed": "Storage quota, extension, or organelle upload error", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"plan_revision_conflict": {"en-US": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal", "pt-BR": "Conflito CAS — agents.plan_get recarregue if_match_revision; nunca apply proposal obsoleto", "ru-RU": "CAS конфликт — agents.plan_get перечитать if_match_revision; не apply устаревший proposal"}}, "when_not_to_use": "Do not set rag_ingest without an explicit RAG/knowledge goal.", "when_to_use": "Channel file: this stores the bytes and the run attaches storage_file_id. Do not paste that body into the finish message. Manual spill (agent-authored): upload bytes to ecosystem storage, append meta.", "write_mode": null}, {"action": "agents.graph_file_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not call agents.work_next to read linked files — graph_file_get returns the text window.", "anti_patterns": ["Do not call agents.work_next to read linked files — graph_file_get returns the text window.", "Do not use for meta.body_external / chunk_id nodes — plan_get detail=body hydrates work_graph/chunks.", "Do not invent storage.preview_text — human SPA preview is FileTextPreviewPane on the public path; agents use this MCP te"], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.graph_file_get", "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Graph File Get", "when_blocked": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "upload_failed": "Storage quota, extension, or organelle upload error", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read meta.storage_refs linked files only (UTF-8 window). Do not use for plan_heal_leaf chunk seals (meta.body_external / chunk_id) — use plan_get detail=body. SPA operators: Work Graph / Storage drawe"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.graph_file_get", "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Graph File Get", "when_blocked": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "upload_failed": "Storage quota, extension, or organelle upload error", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read meta.storage_refs linked files only (UTF-8 window). Do not use for plan_heal_leaf chunk seals (meta.body_external / chunk_id) — use plan_get detail=body. SPA operators: Work Graph / Storage drawe"}, "do_not_use_when": "Do not call agents.work_next to read linked files — graph_file_get returns the text window.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Pass file_id from meta.storage_refs; no work_next.", "name": "Text window for linked file", "request": {"params": {"file_id": "abc", "home": "project", "max_chars": 8000, "node_id": "task-a", "project_id": 1}, "tool": "agents.graph_file_get"}, "response": {"data": {"storage_ref": {"file_id": "abc", "folder_key": "graph__node_task-a"}, "text": {"content": "# Goal", "truncated": false}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "graph_file_mcp_errors": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "storage.read or project_admin cap missing for scope", "generation_fork_required": "auto_generation_mode on — pass env_uuid from generation.fork for home=project mutations", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "Missing required params or binary file for text edit", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "plan_revision_conflict": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal after concurrent plan_patch or graph_file_*.", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Operator session or API key required", "upload_failed": "Storage quota, extension, or organelle upload error"}, "instruction_hint": "Read meta.storage_refs linked files only (UTF-8 window). Do not use for plan_heal_leaf chunk seals …", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.graph_file_edit", "agents.graph_file_list"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_graph_file_get", "semantic_input_mode": "inherit_workflow", "summary": "Read a graph-linked file card and a text window (no work_next).", "title": "Agents Graph File Get", "wave_xix_atoms": {"WG_STORAGE_NOT_KNOWLEDGE": "File upload / document persistence → storage.* (MCP operator or REST binary upload). Do not ingest to knowledge unless the goal requests RAG/Q&A/semantic search."}, "when_blocked": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "upload_failed": "Storage quota, extension, or organelle upload error", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not call agents.work_next to read linked files — graph_file_get returns the text window.", "when_to_use": "Read meta.storage_refs linked files only (UTF-8 window). Do not use for plan_heal_leaf chunk seals (meta.body_external / chunk_id) — use plan_get detail=body. SPA operators: Work Graph / Storage drawe", "write_mode": null}, {"action": "agents.graph_file_edit", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not edit without if_match_revision; use expected_sha256 when bytes may race.", "anti_patterns": ["Do not edit without if_match_revision; use expected_sha256 when bytes may race."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.graph_file_edit", "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Graph File Edit", "when_blocked": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "upload_failed": "Storage quota, extension, or organelle upload error", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Search/replace on linked file text (same editor as hosting/KB — prompt agentstack_text_editor); optional expected_sha256 CAS on bytes. Uploads new blob, updates meta.storage_refs, deletes prior file_i"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.graph_file_edit", "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Graph File Edit", "when_blocked": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "upload_failed": "Storage quota, extension, or organelle upload error", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Search/replace on linked file text (same editor as hosting/KB — prompt agentstack_text_editor); optional expected_sha256 CAS on bytes. Uploads new blob, updates meta.storage_refs, deletes prior file_i"}, "do_not_use_when": "Do not edit without if_match_revision; use expected_sha256 when bytes may race.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "expected_sha256 from graph_file_get; verify via storage_roundtrip_hint.", "name": "Search/replace with graph CAS", "request": {"params": {"file_id": "abc", "home": "project", "if_match_revision": 12, "node_id": "task-a", "project_id": 1, "replacements": [{"find": "TODO", "replace": "DONE"}]}, "tool": "agents.graph_file_edit"}, "response": {"data": {"revision": 13, "storage_ref": {"expected_sha256": "…", "file_id": "def"}, "storage_roundtrip_hint": {"file_id": "def", "verify_action": "storage.list_files"}}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "graph_file_mcp_errors": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "storage.read or project_admin cap missing for scope", "generation_fork_required": "auto_generation_mode on — pass env_uuid from generation.fork for home=project mutations", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "Missing required params or binary file for text edit", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "plan_revision_conflict": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal after concurrent plan_patch or graph_file_*.", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Operator session or API key required", "upload_failed": "Storage quota, extension, or organelle upload error"}, "instruction_hint": "Search/replace on linked file text (same editor as hosting/KB — prompt agentstack_text_editor); opt…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_get", "agents.graph_file_get", "storage.list_files"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_graph_file_edit", "semantic_input_mode": "inherit_workflow", "summary": "Search/replace on a linked file, upload new blob, swap ref, delete old file.", "title": "Agents Graph File Edit", "wave_xix_atoms": {"WG_CAS_RETRY": "plan_revision_conflict → plan_get reload if_match_revision — never apply stale proposal after concurrent plan_patch or backlog apply.", "WG_STORAGE_NOT_KNOWLEDGE": "File upload / document persistence → storage.* (MCP operator or REST binary upload). Do not ingest to knowledge unless the goal requests RAG/Q&A/semantic search.", "WG_VERIFY_AFTER_WRITE": "After each platform mutation, verify via canonical read on meta.verify_after_write_action (storage.list_files, crm.list_contacts, logic.dry_run, rag.search) — attach evidence, do not mark complete from agent prose alone."}, "when_blocked": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "upload_failed": "Storage quota, extension, or organelle upload error", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"plan_revision_conflict": {"en-US": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal", "pt-BR": "Conflito CAS — agents.plan_get recarregue if_match_revision; nunca apply proposal obsoleto", "ru-RU": "CAS конфликт — agents.plan_get перечитать if_match_revision; не apply устаревший proposal"}}, "when_not_to_use": "Do not edit without if_match_revision; use expected_sha256 when bytes may race.", "when_to_use": "Search/replace on linked file text (same editor as hosting/KB — prompt agentstack_text_editor); optional expected_sha256 CAS on bytes. Uploads new blob, updates meta.storage_refs, deletes prior file_i", "write_mode": null}, {"action": "agents.graph_file_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not scan full plan_get bodies for refs — use graph_file_list.", "anti_patterns": ["Do not scan full plan_get bodies for refs — use graph_file_list."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.graph_file_list", "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Graph File List", "when_blocked": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "upload_failed": "Storage quota, extension, or organelle upload error", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List meta.storage_refs on a node plus storage rows bound to plan_node via list_by_entity."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.graph_file_list", "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Graph File List", "when_blocked": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "upload_failed": "Storage quota, extension, or organelle upload error", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List meta.storage_refs on a node plus storage rows bound to plan_node via list_by_entity."}, "do_not_use_when": "Do not scan full plan_get bodies for refs — use graph_file_list.", "domain": "agents", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Use after graph_file_put to complete storage_roundtrip_verified.", "name": "Refs on node + entity bindings", "request": {"params": {"home": "project", "node_id": "task-a", "project_id": 1}, "tool": "agents.graph_file_list"}, "response": {"data": {"entity_files": [{"file_id": "abc"}], "storage_refs": [{"file_id": "abc"}]}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "graph_file_mcp_errors": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "storage.read or project_admin cap missing for scope", "generation_fork_required": "auto_generation_mode on — pass env_uuid from generation.fork for home=project mutations", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "Missing required params or binary file for text edit", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "plan_revision_conflict": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal after concurrent plan_patch or graph_file_*.", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Operator session or API key required", "upload_failed": "Storage quota, extension, or organelle upload error"}, "instruction_hint": "List meta.storage_refs on a node plus storage rows bound to plan_node via list_by_entity.", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.graph_file_get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_graph_file_list", "semantic_input_mode": "inherit_workflow", "summary": "List storage_refs on a node plus storage.list_by_entity(plan_node).", "title": "Agents Graph File List", "wave_xix_atoms": {"WG_STORAGE_NOT_KNOWLEDGE": "File upload / document persistence → storage.* (MCP operator or REST binary upload). Do not ingest to knowledge unless the goal requests RAG/Q&A/semantic search."}, "when_blocked": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "upload_failed": "Storage quota, extension, or organelle upload error", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not scan full plan_get bodies for refs — use graph_file_list.", "when_to_use": "List meta.storage_refs on a node plus storage rows bound to plan_node via list_by_entity.", "write_mode": null}, {"action": "trust.check", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.erc8004.gen1"], "id": "trust.check", "related_tools": ["trust.feedback", "agents.fleet_diagnostics"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Trust Check", "when_blocked": {"invalid_parameters": "project_id and agent_id required", "not_found": "agent not found in project fleet", "trust_surface_unavailable": "trust rollup unavailable"}, "when_to_use": "Read-only trust summary before high-risk fleet or external agent handoff."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.erc8004.gen1"], "id": "trust.check", "related_tools": ["trust.feedback", "agents.fleet_diagnostics"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Trust Check", "when_blocked": {"invalid_parameters": "project_id and agent_id required", "not_found": "agent not found in project fleet", "trust_surface_unavailable": "trust rollup unavailable"}, "when_to_use": "Read-only trust summary before high-risk fleet or external agent handoff."}, "domain": "trust", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "project_id and agent_id required", "not_found": "agent not found in project fleet", "trust_surface_unavailable": "trust rollup unavailable"}, "examples": [{"name": "Fleet agent trust rollup", "request": {"params": {"agent_id": "agent-uuid-example", "project_id": 1}, "tool": "trust.check"}, "response": {"data": {"trust_surface": {"agent_id": "agent-uuid-example"}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Read-only trust summary before high-risk fleet or external agent handoff.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["trust.feedback", "agents.fleet_diagnostics"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "trust_check", "semantic_input_mode": "inherit_workflow", "summary": "Read-only agent trust surface (metrics + optional ERC-8004 reputation rollup).", "title": "Trust Check", "when_blocked": {"invalid_parameters": "project_id and agent_id required", "not_found": "agent not found in project fleet", "trust_surface_unavailable": "trust rollup unavailable"}, "when_to_use": "Read-only trust summary before high-risk fleet or external agent handoff.", "write_mode": null}, {"action": "trust.feedback", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.erc8004.gen1"], "id": "trust.feedback", "related_tools": ["trust.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Trust Feedback", "when_blocked": {"invalid_parameters": "agent_on_chain_id and score required", "service_cap_denied": "mcp_write cap required", "trust_feedback_failed": "feedback persistence failed", "unauthorized": "session required"}, "when_to_use": "Structured operator feedback into trust registry (advisory; RBAC required)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.erc8004.gen1"], "id": "trust.feedback", "related_tools": ["trust.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Trust Feedback", "when_blocked": {"invalid_parameters": "agent_on_chain_id and score required", "service_cap_denied": "mcp_write cap required", "trust_feedback_failed": "feedback persistence failed", "unauthorized": "session required"}, "when_to_use": "Structured operator feedback into trust registry (advisory; RBAC required)."}, "domain": "trust", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"invalid_parameters": "agent_on_chain_id and score required", "service_cap_denied": "mcp_write cap required", "trust_feedback_failed": "feedback persistence failed", "unauthorized": "session required"}, "examples": [{"name": "Post-run reputation feedback", "request": {"params": {"agent_on_chain_id": 42, "receipt_hash": "0xabc", "score": 85}, "tool": "trust.feedback"}, "response": {"data": {"average_score": 85.0, "feedback_count": 1}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Structured operator feedback into trust registry (advisory; RBAC required).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["trust.check"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "trust_feedback", "semantic_input_mode": "inherit_workflow", "summary": "Record L0 reputation feedback for an on-chain agent id (sybil: one row per receipt).", "title": "Trust Feedback", "when_blocked": {"invalid_parameters": "agent_on_chain_id and score required", "service_cap_denied": "mcp_write cap required", "trust_feedback_failed": "feedback persistence failed", "unauthorized": "session required"}, "when_to_use": "Structured operator feedback into trust registry (advisory; RBAC required).", "write_mode": null}, {"action": "shop.products.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.products.upsert", "related_tools": ["assets.create", "shop.enablement.status", "shop.products.list", "commerce.channel_pass.configure", "commerce.channel_pass.binding.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Products Upsert", "visitor_callable": false, "when_blocked": {"asset_not_currency": "Use asset type currency for soft-currency grants.", "asset_not_digital_item": "Grant kind digital_item needs assets.create type=digital_item (or service/nft).", "auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "channel_binding_missing": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "db_unavailable": "Postgres pool transient (deploy/recovery) — wait for GET /api/ready 200, honor retry_after_ms, same idempotency_key.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "invalid_channel_pass_period": "channel_pass grant amount must be period_days ≥ 1 — fix grants[].amount on shop.products.upsert.", "invalid_price": "Add at least one ISO price row to the SKU.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "proportional_base_sku_invalid": "Base SKU document failed validation — fix base SKU grants/prices before proportional child.", "proportional_base_sku_missing": "rules.base_sku must reference an existing catalog SKU — shop.products.list then upsert base first.", "proportional_base_sku_required": "rules.pricing=proportional needs rules.base_sku pointing to another SKU (not self).", "proportional_currency_mismatch": "Each price currency on proportional SKU must exist on base SKU prices.", "proportional_grants_required": "Proportional SKU and base SKU both need grants[] with period in amount.", "proportional_invalid_period": "Grant amount (period days) must be ≥ 1 on proportional SKU and base SKU.", "proportional_price_mismatch": "amount_minor must equal base amount_minor × (period / base_period) — no manual discount tiers; adjust period or base price.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "unknown_asset": "Create currency asset in catalog before SKU grants.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Owner: SKU in 8DNA — grants kind currency (soft pack) or digital_item (cosmetic). Catalog cosmetics: assets.create then grants asset_id. Lightweight cosmetics: grants kind=digital_item item_key=<game_"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.products.upsert", "related_tools": ["assets.create", "shop.enablement.status", "shop.products.list", "commerce.channel_pass.configure", "commerce.channel_pass.binding.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Products Upsert", "visitor_callable": false, "when_blocked": {"asset_not_currency": "Use asset type currency for soft-currency grants.", "asset_not_digital_item": "Grant kind digital_item needs assets.create type=digital_item (or service/nft).", "auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "channel_binding_missing": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "db_unavailable": "Postgres pool transient (deploy/recovery) — wait for GET /api/ready 200, honor retry_after_ms, same idempotency_key.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "invalid_channel_pass_period": "channel_pass grant amount must be period_days ≥ 1 — fix grants[].amount on shop.products.upsert.", "invalid_price": "Add at least one ISO price row to the SKU.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "proportional_base_sku_invalid": "Base SKU document failed validation — fix base SKU grants/prices before proportional child.", "proportional_base_sku_missing": "rules.base_sku must reference an existing catalog SKU — shop.products.list then upsert base first.", "proportional_base_sku_required": "rules.pricing=proportional needs rules.base_sku pointing to another SKU (not self).", "proportional_currency_mismatch": "Each price currency on proportional SKU must exist on base SKU prices.", "proportional_grants_required": "Proportional SKU and base SKU both need grants[] with period in amount.", "proportional_invalid_period": "Grant amount (period days) must be ≥ 1 on proportional SKU and base SKU.", "proportional_price_mismatch": "amount_minor must equal base amount_minor × (period / base_period) — no manual discount tiers; adjust period or base price.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "unknown_asset": "Create currency asset in catalog before SKU grants.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Owner: SKU in 8DNA — grants kind currency (soft pack) or digital_item (cosmetic). Catalog cosmetics: assets.create then grants asset_id. Lightweight cosmetics: grants kind=digital_item item_key=<game_"}, "channel_pass_sku_examples": {"base_30d": {"grants": [{"amount": 30, "asset_id": "nebula", "kind": "channel_pass"}], "prices": [{"amount_minor": 333300, "currency": "RUB"}], "project_id": "<context.project_id>", "sku_id": "nebula_30", "status": "active", "title": {"ru": "nebula — 30 дней"}}, "manual_personal": {"description": "Напишите ответственному — оплата отдельно.", "grants": [{"amount": 1, "asset_id": "nebula", "kind": "manual_request"}], "project_id": "<context.project_id>", "sku_id": "nebula_personal", "status": "active", "title": {"ru": "Персональный продукт"}}, "proportional_90d": {"grants": [{"amount": 90, "asset_id": "nebula", "kind": "channel_pass"}], "prices": [{"amount_minor": 999900, "currency": "RUB"}], "project_id": "<context.project_id>", "rules": {"base_sku": "nebula_30", "pricing": "proportional"}, "sku_id": "nebula_90", "status": "active", "title": {"ru": "nebula — 90 дней"}}}, "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"grants": [{"amount": 100, "asset_id": "asset_gold_id", "kind": "currency"}], "prices": [{"amount_minor": 99, "currency": "USD"}], "project_id": 1438, "sku_id": "coins_100", "status": "active"}, "example_params_channel_pass": {"grants": [{"amount": 30, "asset_id": "nebula", "kind": "channel_pass"}], "prices": [{"amount_minor": 333300, "currency": "RUB"}], "project_id": "<context.project_id>", "sku_id": "nebula_30", "status": "active", "title": {"ru": "nebula — 30 дней"}}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Owner: SKU in 8DNA — grants kind currency (soft pack) or digital_item (cosmetic). Catalog cosmetics…", "kind": "mcp_domain", "mutation_kind": "entity", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "preflight_hint": "Run preflight.check with action=shop.products.upsert and the same grants to catch channel_binding_missing before mutate.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["assets.create", "shop.enablement.status", "shop.products.list", "commerce.channel_pass.configure", "commerce.channel_pass.binding.get"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "shop_products_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Create or update an in-app SKU (server-priced IAP pack).", "title": "Shop Products Upsert", "when_blocked": {"asset_not_currency": "Use asset type currency for soft-currency grants.", "asset_not_digital_item": "Grant kind digital_item needs assets.create type=digital_item (or service/nft).", "auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "channel_binding_missing": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "db_unavailable": "Postgres pool transient (deploy/recovery) — wait for GET /api/ready 200, honor retry_after_ms, same idempotency_key.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "invalid_channel_pass_period": "channel_pass grant amount must be period_days ≥ 1 — fix grants[].amount on shop.products.upsert.", "invalid_price": "Add at least one ISO price row to the SKU.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "proportional_base_sku_invalid": "Base SKU document failed validation — fix base SKU grants/prices before proportional child.", "proportional_base_sku_missing": "rules.base_sku must reference an existing catalog SKU — shop.products.list then upsert base first.", "proportional_base_sku_required": "rules.pricing=proportional needs rules.base_sku pointing to another SKU (not self).", "proportional_currency_mismatch": "Each price currency on proportional SKU must exist on base SKU prices.", "proportional_grants_required": "Proportional SKU and base SKU both need grants[] with period in amount.", "proportional_invalid_period": "Grant amount (period days) must be ≥ 1 on proportional SKU and base SKU.", "proportional_price_mismatch": "amount_minor must equal base amount_minor × (period / base_period) — no manual discount tiers; adjust period or base price.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "unknown_asset": "Create currency asset in catalog before SKU grants.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_blocked_locales": {"channel_binding_missing": {"en-US": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "pt-BR": "SKU channel_pass sem leaf ecosystem.commerce.channels.{id} — commerce.channel_pass.configure, depois shop.products.upsert.", "ru-RU": "SKU channel_pass без ecosystem.commerce.channels.{id} — commerce.channel_pass.configure, затем shop.products.upsert."}, "invalid_channel_pass_period": {"en-US": "channel_pass grant amount must be period_days ≥ 1 — fix grants[].amount on shop.products.upsert.", "pt-BR": "channel_pass grant amount — period_days ≥ 1 em grants[].amount no shop.products.upsert.", "ru-RU": "channel_pass grant amount — period_days ≥ 1 в grants[].amount на shop.products.upsert."}}, "when_to_use": "Owner: SKU in 8DNA — grants kind currency (soft pack) or digital_item (cosmetic). Catalog cosmetics: assets.create then grants asset_id. Lightweight cosmetics: grants kind=digital_item item_key=<game_", "write_mode": null}, {"action": "shop.enablement.status", "agent_checklist": "1) Distinguish IAP vs AgentPay vs marketplace vs fuel. 2) auth.get_profile + context.project_id. 3)…", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "shop.enablement.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Enablement Status", "visitor_callable": true, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "bot_not_admin": "Channel bot is not administrator in the bound chat — add bot as admin with invite rights, then commerce.channel_pass.configure to refresh binding and run channel_pass_doctor.", "catalog_auth_required": "iap_public_catalog=false — guest browse blocked; sign in player or owner enables public catalog.", "channel_binding_missing": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sandbox_checkout_only": "sandbox_ok on enablement snap is test checkout only — read sandbox_bypass_honesty (cosmetic_only_when_sandbox / live_money). Live charges need sell_enabled + hosted publish.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Read sell gate + blockers before checkout; sandbox_ok when test checkout allowed."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "shop.enablement.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Enablement Status", "visitor_callable": true, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "bot_not_admin": "Channel bot is not administrator in the bound chat — add bot as admin with invite rights, then commerce.channel_pass.configure to refresh binding and run channel_pass_doctor.", "catalog_auth_required": "iap_public_catalog=false — guest browse blocked; sign in player or owner enables public catalog.", "channel_binding_missing": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sandbox_checkout_only": "sandbox_ok on enablement snap is test checkout only — read sandbox_bypass_honesty (cosmetic_only_when_sandbox / live_money). Live charges need sell_enabled + hosted publish.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Read sell gate + blockers before checkout; sandbox_ok when test checkout allowed."}, "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"project_id": 1438}, "examples": [{"name": "Sell gate before catalog/checkout", "request": {"params": {"project_id": 1444}, "tool": "shop.enablement.status"}, "response": {"data": {"blockers": [], "catalog_configured": true, "sell_enabled": true}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Read sell gate + blockers before checkout; sandbox_ok when test checkout allowed.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["shop.products.list", "shop.products.upsert", "assets.create"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "shop_enablement_status", "semantic_input_mode": "inherit_workflow", "summary": "Read-only sell gate: live checkout vs sandbox-only blockers.", "title": "Shop Enablement Status", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "bot_not_admin": "Channel bot is not administrator in the bound chat — add bot as admin with invite rights, then commerce.channel_pass.configure to refresh binding and run channel_pass_doctor.", "catalog_auth_required": "iap_public_catalog=false — guest browse blocked; sign in player or owner enables public catalog.", "channel_binding_missing": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sandbox_checkout_only": "sandbox_ok on enablement snap is test checkout only — read sandbox_bypass_honesty (cosmetic_only_when_sandbox / live_money). Live charges need sell_enabled + hosted publish.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_blocked_locales": {"bot_not_admin": {"en-US": "Channel bot is not administrator in the bound chat — add bot as admin with invite rights, then commerce.channel_pass.configure and channel_pass_doctor.", "pt-BR": "Bot não é admin do canal — permissões de convite, commerce.channel_pass.configure, channel_pass_doctor.", "ru-RU": "Бот не админ канала — выдайте права invite, commerce.channel_pass.configure, channel_pass_doctor."}, "channel_binding_missing": {"en-US": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "pt-BR": "SKU channel_pass sem leaf ecosystem.commerce.channels.{id} — commerce.channel_pass.configure, depois shop.products.upsert.", "ru-RU": "SKU channel_pass без ecosystem.commerce.channels.{id} — commerce.channel_pass.configure, затем shop.products.upsert."}, "project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Read sell gate + blockers before checkout; sandbox_ok when test checkout allowed.", "write_mode": null}, {"action": "shop.sandbox.simulate", "ai_tips": "Owner-only: sandbox checkout without live PSP — payment_method=test only (zero-PSP).", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"effect_depends_on_params": false, "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "shop.sandbox.simulate", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Sandbox Simulate", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "catalog_not_configured": "No active IAP SKUs — probe shop.enablement.status; owner path: assets.create → shop.products.upsert (status=active). Draft SKUs can be prepared while sell is off.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "idempotency_key_required": "Generate stable UUID per checkout or spend attempt.", "payment_method_unsupported": "shop.sandbox.simulate allows payment_method=test only (zero-PSP owner path).", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sandbox_checkout_requires_test_mode": "Enable sandbox_checkout_enabled in IAP DNA or IAP_TEST_CHECKOUT in dev before zero-PSP simulate.", "sandbox_disabled": "Set ecosystem.commerce.iap.sandbox_checkout_enabled or use dev APP_ENV + payment_method=test.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "sku_inactive": "Owner sets SKU status active via shop.products.upsert.", "sku_not_found": "Refresh catalog — owner shop.products.upsert in sandbox."}, "when_to_use": "Owner-only: sandbox checkout without live PSP — payment_method=test only (zero-PSP)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"effect_depends_on_params": false, "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "shop.sandbox.simulate", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Sandbox Simulate", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "catalog_not_configured": "No active IAP SKUs — probe shop.enablement.status; owner path: assets.create → shop.products.upsert (status=active). Draft SKUs can be prepared while sell is off.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "idempotency_key_required": "Generate stable UUID per checkout or spend attempt.", "payment_method_unsupported": "shop.sandbox.simulate allows payment_method=test only (zero-PSP owner path).", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sandbox_checkout_requires_test_mode": "Enable sandbox_checkout_enabled in IAP DNA or IAP_TEST_CHECKOUT in dev before zero-PSP simulate.", "sandbox_disabled": "Set ecosystem.commerce.iap.sandbox_checkout_enabled or use dev APP_ENV + payment_method=test.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "sku_inactive": "Owner sets SKU status active via shop.products.upsert.", "sku_not_found": "Refresh catalog — owner shop.products.upsert in sandbox."}, "when_to_use": "Owner-only: sandbox checkout without live PSP — payment_method=test only (zero-PSP)."}, "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"effect_depends_on_params": false, "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Owner-only: sandbox checkout without live PSP — payment_method=test only (zero-PSP).", "kind": "mcp_domain", "mutation_kind": "body", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"order_id": {"description": "string", "type": "string"}, "sandbox": {"description": "boolean", "type": "boolean"}, "status": {"description": "string", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "shop_sandbox_simulate", "semantic_input_mode": "inherit_workflow", "summary": "Simulate checkout+fulfill in sandbox mode (no PSP charge).", "title": "Shop Sandbox Simulate", "verification": ["shop.orders.get", "shop.entitlements.list"], "verify": [{"action": "shop.orders.get", "predicate": "named resource is visible"}, {"action": "shop.entitlements.list", "predicate": "named resource is visible"}], "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "catalog_not_configured": "No active IAP SKUs — probe shop.enablement.status; owner path: assets.create → shop.products.upsert (status=active). Draft SKUs can be prepared while sell is off.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "idempotency_key_required": "Generate stable UUID per checkout or spend attempt.", "payment_method_unsupported": "shop.sandbox.simulate allows payment_method=test only (zero-PSP owner path).", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sandbox_checkout_requires_test_mode": "Enable sandbox_checkout_enabled in IAP DNA or IAP_TEST_CHECKOUT in dev before zero-PSP simulate.", "sandbox_disabled": "Set ecosystem.commerce.iap.sandbox_checkout_enabled or use dev APP_ENV + payment_method=test.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "sku_inactive": "Owner sets SKU status active via shop.products.upsert.", "sku_not_found": "Refresh catalog — owner shop.products.upsert in sandbox."}, "when_blocked_locales": {"auth_required": {"en-US": "Sign in or use catalog_auth_required bypass for owner preview.", "pt-BR": "Entre ou use preview do dono com catalog_auth_required.", "ru-RU": "Войдите или используйте owner preview при catalog_auth_required."}, "catalog_not_configured": {"en-US": "No active IAP SKUs — shop.enablement.status; owner: shop.products.upsert.", "pt-BR": "Sem SKUs IAP ativos — shop.enablement.status; dono: shop.products.upsert.", "ru-RU": "Нет активных IAP SKU — shop.enablement.status; владелец: shop.products.upsert."}, "sandbox_disabled": {"en-US": "Sandbox simulate off — shop.enablement.status; owner enables sandbox or use zero-PSP test lane.", "pt-BR": "Sandbox simulate desligado — shop.enablement.status; faixa zero-PSP para QA.", "ru-RU": "Sandbox simulate выключен — shop.enablement.status; zero-PSP test lane для QA."}, "sell_disabled": {"en-US": "Live checkout off — shop.enablement.status then shop.products.upsert or enable commerce_iap.", "pt-BR": "Checkout live desligado — shop.enablement.status, depois shop.products.upsert ou commerce_iap.", "ru-RU": "Live checkout выключен — shop.enablement.status, затем shop.products.upsert или commerce_iap."}}, "when_to_use": "Owner-only: sandbox checkout without live PSP — payment_method=test only (zero-PSP).", "write_mode": null}, {"action": "shop.products.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.products.list", "related_tools": ["shop.checkout.create", "payments.list_methods", "wallets.balance"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Products List", "visitor_callable": true, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "catalog_auth_required": "iap_public_catalog=false — guest browse blocked; sign in player or owner enables public catalog.", "catalog_not_configured": "No active IAP SKUs — probe shop.enablement.status; owner path: assets.create → shop.products.upsert (status=active). Draft SKUs can be prepared while sell is off.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Visitor catalog on /s/{pid}/ — locale/currency filters; prices from DNA SKU."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.products.list", "related_tools": ["shop.checkout.create", "payments.list_methods", "wallets.balance"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Products List", "visitor_callable": true, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "catalog_auth_required": "iap_public_catalog=false — guest browse blocked; sign in player or owner enables public catalog.", "catalog_not_configured": "No active IAP SKUs — probe shop.enablement.status; owner path: assets.create → shop.products.upsert (status=active). Draft SKUs can be prepared while sell is off.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Visitor catalog on /s/{pid}/ — locale/currency filters; prices from DNA SKU."}, "do_not_use_when": "Post-deploy or audit MCP batches expecting universal success — probe shop.enablement.status blockers instead.", "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Visitor IAP catalog", "request": {"params": {"locale": "en-US", "project_id": 1444}, "tool": "shop.products.list"}, "response": {"data": {"products": [{"sku_id": "coin_pack_s"}]}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Visitor catalog on /s/{pid}/ — locale/currency filters; prices from DNA SKU.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["shop.enablement.status", "shop.products.upsert", "assets.create"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.checkout.create", "payments.list_methods", "wallets.balance"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "shop_products_list", "semantic_input_mode": "inherit_workflow", "summary": "List active IAP SKUs for visitors or all for owner.", "title": "Shop Products List", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "catalog_auth_required": "iap_public_catalog=false — guest browse blocked; sign in player or owner enables public catalog.", "catalog_not_configured": "No active IAP SKUs — probe shop.enablement.status; owner path: assets.create → shop.products.upsert (status=active). Draft SKUs can be prepared while sell is off.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_blocked_locales": {"auth_required": {"en-US": "Sign in or use catalog_auth_required bypass for owner preview.", "pt-BR": "Entre ou use preview do dono com catalog_auth_required.", "ru-RU": "Войдите или используйте owner preview при catalog_auth_required."}, "catalog_not_configured": {"en-US": "No active IAP SKUs — shop.enablement.status; owner: shop.products.upsert.", "pt-BR": "Sem SKUs IAP ativos — shop.enablement.status; dono: shop.products.upsert.", "ru-RU": "Нет активных IAP SKU — shop.enablement.status; владелец: shop.products.upsert."}, "project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}, "sell_disabled": {"en-US": "Live checkout off — shop.enablement.status then shop.products.upsert or enable commerce_iap.", "pt-BR": "Checkout live desligado — shop.enablement.status, depois shop.products.upsert ou commerce_iap.", "ru-RU": "Live checkout выключен — shop.enablement.status, затем shop.products.upsert или commerce_iap."}}, "when_not_to_use": "Post-deploy or audit MCP batches expecting universal success — probe shop.enablement.status blockers instead.", "when_to_use": "Visitor catalog on /s/{pid}/ — locale/currency filters; prices from DNA SKU.", "write_mode": null}, {"action": "shop.checkout.create", "agent_checklist": "1) Distinguish IAP vs AgentPay vs marketplace vs fuel. 2) auth.get_profile + context.project_id. 3)…", "ai_tips": "Start pay flow; amount from SKU only. Requires idempotency_key + same-origin return_url. PAY-01: fail-closed when PSP returns no checkout_url/client_secret (psp_session_missing). payments.create uses metadata.recipient_project_id=tenant pid; payer DNA stays on profile project. digital_item SKUs use intent tenant_iap (no currency_code in pay meta). channel_pass SKUs stack period_days on CP:{binding_id}; bot checkout stamps buyer_subject. After redirect with ?iap_checkout=1&iap_payment_id=, hosted visitors use GET /api/commerce/iap/checkout/resume (hosted_app cookie, credentials include) — not payments.get. Bot deep link without a cookie: GET /api/commerce/iap/checkout/public-session.", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Server-priced order; same idempotency_key+sku+return_url may return replayed=true.", "kind": "mutate", "mutates_when": "always", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.checkout.create", "related_tools": ["shop.products.list", "payments.list_methods", "shop.orders.get", "payments.get", "shop.enablement.status"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Shop Checkout Create", "visitor_callable": true, "when_blocked": {"anonymous_account": "Anonymous accounts cannot sell. Register or sign in — a free account can sell with a higher platform commission (15%); paid plans use 3%.", "auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "buyer_subject_required": "channel_pass checkout needs buyer_subject (telegram external_user_id) in order metadata when any grant kind is channel_pass — use bot /passes or stamp metadata on shop.checkout.create.", "catalog_auth_required": "iap_public_catalog=false — guest browse blocked; sign in player or owner enables public catalog.", "catalog_not_configured": "No active IAP SKUs — probe shop.enablement.status; owner path: assets.create → shop.products.upsert (status=active). Draft SKUs can be prepared while sell is off.", "client_amount_forbidden": "Omit amount/amount_minor — shop.checkout.create prices from shop.products.list SKU.", "commerce_routers_pending": "Commerce REST routers still mounting after cold start — honor retry_after_ms, poll GET /api/ready until deferred commerce is ready, then shop.checkout.create.", "currency_not_supported": "Use a currency present on the SKU price row.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "flags_divergent": "sell_enabled=true but commerce_iap_feature=false — platform flag mismatch; live PSP checkout stays blocked until flags align. Use shop.sandbox.simulate when sandbox_ok.", "forbidden_for_visitor": "Visitors: no shop.fulfill and no skip_sell_check on checkout — use shop.checkout.create with live sell gate; poll shop.orders.get.", "hosted_iap_return": "Mount Stripe from resume client_secret or assign checkout_url; strip query after terminal status. Static games: hosted-sdk-cdn iapCheckoutBoot.runIapCheckoutBootOnLoad().", "hosted_unpublished": "Hosted app /s/{project_id}/ is not published — visitors cannot complete live checkout while active SKUs exist. Exception: channel_only channel_pass (bot checkout) when enablement.channel_only_checkout_allowed is true. Owner: hosting.publish; or bot-only pass SKUs with channel_only binding.", "hosting_unavailable": "Hosting publish state could not be read — retry shop.enablement.status; ops: verify hosting service before live checkout.", "iap_order_required": "shop.checkout.create first — order_id only on currency_pack from that checkout; payments.create rejects sale intent with metadata.order_id (iap_order_required).", "idempotency_key_required": "Generate stable UUID per checkout or spend attempt.", "idempotency_mismatch": "Same idempotency_key but different return_url — use a new key or match the stored return_url.", "invalid_order": "IAP order missing price snapshot — re-checkout with new idempotency_key.", "invalid_parameters": "Fix checkout params — payment_method defaults to card; server prices from SKU. Read message for ValidationError detail.", "missing_payment_id": "PSP did not return payment_id — check AgentPay/Stripe project keys; order marked failed; retry shop.checkout.create with new idempotency_key.", "no_active_products": "SKUs exist but none are active — shop.products.upsert status=active or add a new active SKU.", "order_already_fulfilled": "Order already granted — do not replay payments.create or fulfill.", "order_amount_mismatch": "Internal payments.create after checkout must match SQL order amount_minor — never edit amount; re-run shop.checkout.create with new idempotency_key if SKU price changed.", "order_currency_mismatch": "Payment currency must match order row — use shop.checkout.create SKU price.", "order_not_found": "Use order_id from checkout response.", "order_not_payable": "Order not pending_payment — poll shop.orders.get before bind.", "order_project_mismatch": "metadata.recipient_project_id must match SQL order project_id and context.project_id.", "order_sku_mismatch": "Payment SKU metadata must match order — no client amount bypass.", "order_user_mismatch": "Payer user_id must match commerce_iap_orders.user_id — auth.get_profile.", "payment_create_failed": "AgentPay session failed — read order payment_error / payment_error_code. Checkout uses server-priced SKU + metadata.order_id bind (currency_pack or tenant_iap); payments.get may show ecosystem profile project_id — use metadata.recipient_project_id and metadata.order_id for IAP. Failed orders stay failed: retry shop.checkout.create with a new idempotency_key. Resume: GET /api/commerce/iap/checkout/resume. Else payments.list_methods + shop.enablement.status.", "payment_id_in_use": "PSP payment_id already bound — response includes bound_order_id; poll that order or start checkout with a new idempotency_key.", "preferred_method_required": "Pass payment_method card (or stripe/tochka) — omit for default card checkout.", "price_changed": "SKU price changed since order was created — new idempotency_key to re-quote server price.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "psp_not_configured": "Configure Stripe/Tochka BYOK keys + webhooks (/api/payments/webhooks/stripe/{pid}, /webhooks/tochka/{pid}) — then payments.list_methods.", "psp_session_missing": "PAY-01 fail-closed: PSP did not return checkout_url or client_secret — order marked failed. Check Stripe/Tochka keys on recipient_project_id, payments.list_methods, then shop.checkout.create with a new idempotency_key (not the same shop-order-{order_id}).", "rate_limit_exceeded": "IAP checkout/resume throttle (per user+project) — honor retry_after_ms or HTTP Retry-After, then retry shop.checkout.create. After the window, the same idempotency_key may return replayed=true without a new PSP session.", "return_url_invalid": "return_url must stay under /s/{project_id}/ on the same host.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "sku_changed": "Owner changed SKU since order row was created — use a new idempotency_key.", "sku_inactive": "Owner sets SKU status active via shop.products.upsert.", "sku_no_grants": "SKU has no grants[] — shop.products.upsert with grants: [{kind: currency, asset_id, amount}] or digital_item.", "sku_not_found": "Refresh catalog — owner shop.products.upsert in sandbox.", "unsupported_payment_method": "Checkout: payment_method card|stripe|tochka only — not wallet/crypto. See payments.list_methods before shop.checkout.create."}, "when_to_use": "Start pay flow; amount from SKU only."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Server-priced order; same idempotency_key+sku+return_url may return replayed=true.", "kind": "mutate", "mutates_when": "always", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.checkout.create", "related_tools": ["shop.products.list", "payments.list_methods", "shop.orders.get", "payments.get", "shop.enablement.status"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Shop Checkout Create", "visitor_callable": true, "when_blocked": {"anonymous_account": "Anonymous accounts cannot sell. Register or sign in — a free account can sell with a higher platform commission (15%); paid plans use 3%.", "auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "buyer_subject_required": "channel_pass checkout needs buyer_subject (telegram external_user_id) in order metadata when any grant kind is channel_pass — use bot /passes or stamp metadata on shop.checkout.create.", "catalog_auth_required": "iap_public_catalog=false — guest browse blocked; sign in player or owner enables public catalog.", "catalog_not_configured": "No active IAP SKUs — probe shop.enablement.status; owner path: assets.create → shop.products.upsert (status=active). Draft SKUs can be prepared while sell is off.", "client_amount_forbidden": "Omit amount/amount_minor — shop.checkout.create prices from shop.products.list SKU.", "commerce_routers_pending": "Commerce REST routers still mounting after cold start — honor retry_after_ms, poll GET /api/ready until deferred commerce is ready, then shop.checkout.create.", "currency_not_supported": "Use a currency present on the SKU price row.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "flags_divergent": "sell_enabled=true but commerce_iap_feature=false — platform flag mismatch; live PSP checkout stays blocked until flags align. Use shop.sandbox.simulate when sandbox_ok.", "forbidden_for_visitor": "Visitors: no shop.fulfill and no skip_sell_check on checkout — use shop.checkout.create with live sell gate; poll shop.orders.get.", "hosted_iap_return": "Mount Stripe from resume client_secret or assign checkout_url; strip query after terminal status. Static games: hosted-sdk-cdn iapCheckoutBoot.runIapCheckoutBootOnLoad().", "hosted_unpublished": "Hosted app /s/{project_id}/ is not published — visitors cannot complete live checkout while active SKUs exist. Exception: channel_only channel_pass (bot checkout) when enablement.channel_only_checkout_allowed is true. Owner: hosting.publish; or bot-only pass SKUs with channel_only binding.", "hosting_unavailable": "Hosting publish state could not be read — retry shop.enablement.status; ops: verify hosting service before live checkout.", "iap_order_required": "shop.checkout.create first — order_id only on currency_pack from that checkout; payments.create rejects sale intent with metadata.order_id (iap_order_required).", "idempotency_key_required": "Generate stable UUID per checkout or spend attempt.", "idempotency_mismatch": "Same idempotency_key but different return_url — use a new key or match the stored return_url.", "invalid_order": "IAP order missing price snapshot — re-checkout with new idempotency_key.", "invalid_parameters": "Fix checkout params — payment_method defaults to card; server prices from SKU. Read message for ValidationError detail.", "missing_payment_id": "PSP did not return payment_id — check AgentPay/Stripe project keys; order marked failed; retry shop.checkout.create with new idempotency_key.", "no_active_products": "SKUs exist but none are active — shop.products.upsert status=active or add a new active SKU.", "order_already_fulfilled": "Order already granted — do not replay payments.create or fulfill.", "order_amount_mismatch": "Internal payments.create after checkout must match SQL order amount_minor — never edit amount; re-run shop.checkout.create with new idempotency_key if SKU price changed.", "order_currency_mismatch": "Payment currency must match order row — use shop.checkout.create SKU price.", "order_not_found": "Use order_id from checkout response.", "order_not_payable": "Order not pending_payment — poll shop.orders.get before bind.", "order_project_mismatch": "metadata.recipient_project_id must match SQL order project_id and context.project_id.", "order_sku_mismatch": "Payment SKU metadata must match order — no client amount bypass.", "order_user_mismatch": "Payer user_id must match commerce_iap_orders.user_id — auth.get_profile.", "payment_create_failed": "AgentPay session failed — read order payment_error / payment_error_code. Checkout uses server-priced SKU + metadata.order_id bind (currency_pack or tenant_iap); payments.get may show ecosystem profile project_id — use metadata.recipient_project_id and metadata.order_id for IAP. Failed orders stay failed: retry shop.checkout.create with a new idempotency_key. Resume: GET /api/commerce/iap/checkout/resume. Else payments.list_methods + shop.enablement.status.", "payment_id_in_use": "PSP payment_id already bound — response includes bound_order_id; poll that order or start checkout with a new idempotency_key.", "preferred_method_required": "Pass payment_method card (or stripe/tochka) — omit for default card checkout.", "price_changed": "SKU price changed since order was created — new idempotency_key to re-quote server price.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "psp_not_configured": "Configure Stripe/Tochka BYOK keys + webhooks (/api/payments/webhooks/stripe/{pid}, /webhooks/tochka/{pid}) — then payments.list_methods.", "psp_session_missing": "PAY-01 fail-closed: PSP did not return checkout_url or client_secret — order marked failed. Check Stripe/Tochka keys on recipient_project_id, payments.list_methods, then shop.checkout.create with a new idempotency_key (not the same shop-order-{order_id}).", "rate_limit_exceeded": "IAP checkout/resume throttle (per user+project) — honor retry_after_ms or HTTP Retry-After, then retry shop.checkout.create. After the window, the same idempotency_key may return replayed=true without a new PSP session.", "return_url_invalid": "return_url must stay under /s/{project_id}/ on the same host.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "sku_changed": "Owner changed SKU since order row was created — use a new idempotency_key.", "sku_inactive": "Owner sets SKU status active via shop.products.upsert.", "sku_no_grants": "SKU has no grants[] — shop.products.upsert with grants: [{kind: currency, asset_id, amount}] or digital_item.", "sku_not_found": "Refresh catalog — owner shop.products.upsert in sandbox.", "unsupported_payment_method": "Checkout: payment_method card|stripe|tochka only — not wallet/crypto. See payments.list_methods before shop.checkout.create."}, "when_to_use": "Start pay flow; amount from SKU only."}, "do_not_use_when": "Do not use payments.create with client grant_amount for hosted SKU checkout.", "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Server-priced order; same idempotency_key+sku+return_url may return replayed=true.", "execution_class": "cheap", "kind": "mutate", "mutates_when": "always", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Server-priced order; same idempotency_key+sku+return_url may return replayed=true.", "kind": "mutate", "mutates_when": "always", "read_only_hint": false}, "examples": [{"name": "Server-priced checkout (idempotent)", "request": {"params": {"idempotency_key": "iap-demo-stable-key-1", "project_id": 1444, "return_url": "https://agentstack.tech/s/1444/game?iap_checkout=1", "sku_id": "coin_pack_s"}, "tool": "shop.checkout.create"}, "response": {"data": {"checkout_url": "https://checkout.example/session", "order_id": "<uuid>", "payment_id": "<uuid>", "replayed": false}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "hosted_resume_bff": "/api/commerce/iap/checkout/resume", "instruction_hint": "Start pay flow; amount from SKU only.", "kind": "mcp_domain", "mutation_kind": "body", "navigation": ["payments.list_methods", "shop.products.list", "shop.orders.get", "payments.get"], "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["shop.orders.get", "payments.get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bound_order_id": {"description": "string (payment_id_in_use)", "type": "string"}, "checkout_url": {"description": "string", "type": "string"}, "order_id": {"description": "string", "type": "string"}, "payment_id": {"description": "string", "type": "string"}, "replayed": {"description": "boolean", "type": "boolean"}, "retry_after_ms": {"description": "int (errors only)", "type": "integer"}, "status": {"description": "string", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "payment_method_default": "card", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "receipt_rule": "Poll shop.orders.get until fulfilled; payments.get until soft_currency_grant.status=ok. Hosted card return: GET /api/commerce/iap/checkout/resume?project_id=&payment_id= after ?iap_checkout=1 — not payments.get for visitors.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.products.list", "payments.list_methods", "shop.orders.get", "payments.get", "shop.enablement.status"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "rollback": ["shop.orders.cancel"], "safe_action": "shop_checkout_create", "semantic_input_mode": "inherit_workflow", "summary": "Start visitor checkout for a SKU (server price; no client amount).", "title": "Shop Checkout Create", "treasury_note": "Project treasury / wallet settlement is not the hosted buyer checkout rail.", "verification": ["shop.orders.get", "payments.get"], "verify": [{"action": "shop.orders.get", "predicate": "named resource is visible"}, {"action": "payments.get", "predicate": "named resource is visible"}], "when_blocked": {"anonymous_account": "Anonymous accounts cannot sell. Register or sign in — a free account can sell with a higher platform commission (15%); paid plans use 3%.", "auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "buyer_subject_required": "channel_pass checkout needs buyer_subject (telegram external_user_id) in order metadata when any grant kind is channel_pass — use bot /passes or stamp metadata on shop.checkout.create.", "catalog_auth_required": "iap_public_catalog=false — guest browse blocked; sign in player or owner enables public catalog.", "catalog_not_configured": "No active IAP SKUs — probe shop.enablement.status; owner path: assets.create → shop.products.upsert (status=active). Draft SKUs can be prepared while sell is off.", "client_amount_forbidden": "Omit amount/amount_minor — shop.checkout.create prices from shop.products.list SKU.", "commerce_routers_pending": "Commerce REST routers still mounting after cold start — honor retry_after_ms, poll GET /api/ready until deferred commerce is ready, then shop.checkout.create.", "currency_not_supported": "Use a currency present on the SKU price row.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "flags_divergent": "sell_enabled=true but commerce_iap_feature=false — platform flag mismatch; live PSP checkout stays blocked until flags align. Use shop.sandbox.simulate when sandbox_ok.", "forbidden_for_visitor": "Visitors: no shop.fulfill and no skip_sell_check on checkout — use shop.checkout.create with live sell gate; poll shop.orders.get.", "hosted_iap_return": "Mount Stripe from resume client_secret or assign checkout_url; strip query after terminal status. Static games: hosted-sdk-cdn iapCheckoutBoot.runIapCheckoutBootOnLoad().", "hosted_unpublished": "Hosted app /s/{project_id}/ is not published — visitors cannot complete live checkout while active SKUs exist. Exception: channel_only channel_pass (bot checkout) when enablement.channel_only_checkout_allowed is true. Owner: hosting.publish; or bot-only pass SKUs with channel_only binding.", "hosting_unavailable": "Hosting publish state could not be read — retry shop.enablement.status; ops: verify hosting service before live checkout.", "iap_order_required": "shop.checkout.create first — order_id only on currency_pack from that checkout; payments.create rejects sale intent with metadata.order_id (iap_order_required).", "idempotency_key_required": "Generate stable UUID per checkout or spend attempt.", "idempotency_mismatch": "Same idempotency_key but different return_url — use a new key or match the stored return_url.", "invalid_order": "IAP order missing price snapshot — re-checkout with new idempotency_key.", "invalid_parameters": "Fix checkout params — payment_method defaults to card; server prices from SKU. Read message for ValidationError detail.", "missing_payment_id": "PSP did not return payment_id — check AgentPay/Stripe project keys; order marked failed; retry shop.checkout.create with new idempotency_key.", "no_active_products": "SKUs exist but none are active — shop.products.upsert status=active or add a new active SKU.", "order_already_fulfilled": "Order already granted — do not replay payments.create or fulfill.", "order_amount_mismatch": "Internal payments.create after checkout must match SQL order amount_minor — never edit amount; re-run shop.checkout.create with new idempotency_key if SKU price changed.", "order_currency_mismatch": "Payment currency must match order row — use shop.checkout.create SKU price.", "order_not_found": "Use order_id from checkout response.", "order_not_payable": "Order not pending_payment — poll shop.orders.get before bind.", "order_project_mismatch": "metadata.recipient_project_id must match SQL order project_id and context.project_id.", "order_sku_mismatch": "Payment SKU metadata must match order — no client amount bypass.", "order_user_mismatch": "Payer user_id must match commerce_iap_orders.user_id — auth.get_profile.", "payment_create_failed": "AgentPay session failed — read order payment_error / payment_error_code. Checkout uses server-priced SKU + metadata.order_id bind (currency_pack or tenant_iap); payments.get may show ecosystem profile project_id — use metadata.recipient_project_id and metadata.order_id for IAP. Failed orders stay failed: retry shop.checkout.create with a new idempotency_key. Resume: GET /api/commerce/iap/checkout/resume. Else payments.list_methods + shop.enablement.status.", "payment_id_in_use": "PSP payment_id already bound — response includes bound_order_id; poll that order or start checkout with a new idempotency_key.", "preferred_method_required": "Pass payment_method card (or stripe/tochka) — omit for default card checkout.", "price_changed": "SKU price changed since order was created — new idempotency_key to re-quote server price.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "psp_not_configured": "Configure Stripe/Tochka BYOK keys + webhooks (/api/payments/webhooks/stripe/{pid}, /webhooks/tochka/{pid}) — then payments.list_methods.", "psp_session_missing": "PAY-01 fail-closed: PSP did not return checkout_url or client_secret — order marked failed. Check Stripe/Tochka keys on recipient_project_id, payments.list_methods, then shop.checkout.create with a new idempotency_key (not the same shop-order-{order_id}).", "rate_limit_exceeded": "IAP checkout/resume throttle (per user+project) — honor retry_after_ms or HTTP Retry-After, then retry shop.checkout.create. After the window, the same idempotency_key may return replayed=true without a new PSP session.", "return_url_invalid": "return_url must stay under /s/{project_id}/ on the same host.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "sku_changed": "Owner changed SKU since order row was created — use a new idempotency_key.", "sku_inactive": "Owner sets SKU status active via shop.products.upsert.", "sku_no_grants": "SKU has no grants[] — shop.products.upsert with grants: [{kind: currency, asset_id, amount}] or digital_item.", "sku_not_found": "Refresh catalog — owner shop.products.upsert in sandbox.", "unsupported_payment_method": "Checkout: payment_method card|stripe|tochka only — not wallet/crypto. See payments.list_methods before shop.checkout.create."}, "when_blocked_locales": {"anonymous_account": {"en-US": "Anonymous accounts cannot sell. Register a free account (15% platform fee) or a paid plan (3%).", "pt-BR": "Conta anônima não vende. Cadastre uma conta grátis (comissão 15%) ou um plano pago (3%).", "ru-RU": "Анонимный аккаунт не продаёт. Зарегистрируйте бесплатный аккаунт (комиссия 15%) или платный план (3%)."}, "auth_required": {"en-US": "Sign in or use catalog_auth_required bypass for owner preview.", "pt-BR": "Entre ou use preview do dono com catalog_auth_required.", "ru-RU": "Войдите или используйте owner preview при catalog_auth_required."}, "buyer_subject_required": {"en-US": "channel_pass checkout needs buyer_subject (telegram external_user_id) in order metadata — use bot /passes or stamp on shop.checkout.create.", "pt-BR": "buyer_subject (telegram external_user_id) no metadata — checkout pelo bot /passes.", "ru-RU": "Нужен buyer_subject (telegram external_user_id) — checkout из бота /passes."}, "catalog_not_configured": {"en-US": "No active IAP SKUs — shop.enablement.status; owner: shop.products.upsert.", "pt-BR": "Sem SKUs IAP ativos — shop.enablement.status; dono: shop.products.upsert.", "ru-RU": "Нет активных IAP SKU — shop.enablement.status; владелец: shop.products.upsert."}, "flags_divergent": {"en-US": "sell_enabled=true but commerce_iap_feature=false — align flags or use shop.sandbox.simulate.", "pt-BR": "sell_enabled=true mas commerce_iap_feature=false — alinhe flags ou shop.sandbox.simulate.", "ru-RU": "sell_enabled=true, но commerce_iap_feature=false — выровняйте флаги или shop.sandbox.simulate."}, "hosted_unpublished": {"en-US": "Hosted /s/{pid}/ not published — publish hosting before live checkout.", "pt-BR": "Hosted /s/{pid}/ não publicado — publique hosting antes do checkout live.", "ru-RU": "Hosted /s/{pid}/ не опубликован — опубликуйте hosting перед live checkout."}, "hosting_unavailable": {"en-US": "Hosting publish state unreadable — retry shop.enablement.status.", "pt-BR": "Estado de hosting ilegível — repita shop.enablement.status.", "ru-RU": "Не удалось прочитать hosting — повторите shop.enablement.status."}, "no_active_products": {"en-US": "SKUs exist but none active — shop.products.upsert status=active.", "pt-BR": "SKUs existem mas nenhum active — shop.products.upsert com status=active.", "ru-RU": "SKU есть, но нет active — shop.products.upsert со status=active."}, "payment_create_failed": {"en-US": "AgentPay session create failed — shop.enablement.status; not a fulfilled order.", "pt-BR": "Falha ao criar sessão AgentPay — shop.enablement.status; pedido não fulfilled.", "ru-RU": "Не удалось создать AgentPay session — shop.enablement.status; заказ не fulfilled."}, "price_changed": {"en-US": "SKU price drifted — re-read shop.products.list and retry checkout.", "pt-BR": "Preço do SKU mudou — shop.products.list e tente checkout de novo.", "ru-RU": "Цена SKU изменилась — shop.products.list и повторите checkout."}, "project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}, "psp_session_missing": {"en-US": "PSP returned no checkout URL — retry shop.checkout.create; ops: payments rail health.", "pt-BR": "PSP sem URL de checkout — repita shop.checkout.create; verifique payments rail.", "ru-RU": "PSP не вернул checkout URL — повторите shop.checkout.create; проверьте payments rail."}, "rate_limit_exceeded": {"en-US": "Checkout rate limit — honor retry_after then new idempotency_key if order stuck.", "pt-BR": "Rate limit no checkout — aguarde retry_after; nova idempotency_key se pedido travar.", "ru-RU": "Rate limit checkout — подождите retry_after; новый idempotency_key если заказ завис."}, "sell_disabled": {"en-US": "Live checkout off — shop.enablement.status then shop.products.upsert or enable commerce_iap.", "pt-BR": "Checkout live desligado — shop.enablement.status, depois shop.products.upsert ou commerce_iap.", "ru-RU": "Live checkout выключен — shop.enablement.status, затем shop.products.upsert или commerce_iap."}}, "when_not_to_use": "Do not use payments.create with client grant_amount for hosted SKU checkout.", "when_to_use": "Start pay flow; amount from SKU only.", "write_mode": null}, {"action": "shop.orders.get", "agent_checklist": "1) Distinguish IAP vs AgentPay vs marketplace vs fuel. 2) auth.get_profile + context.project_id. 3)…", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.orders.get", "related_tools": ["shop.checkout.create", "payments.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Orders Get", "visitor_callable": true, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "checkout_resume_auth": "Hosted IAP return: GET /api/commerce/iap/checkout/resume?project_id=&payment_id= with player Bearer/cookie after ?iap_checkout=1 — operators use payments.get, visitors do not.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "hosted_iap_return": "Mount Stripe from resume client_secret or assign checkout_url; strip query after terminal status. Static games: hosted-sdk-cdn iapCheckoutBoot.runIapCheckoutBootOnLoad().", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "order_not_found": "Use order_id from checkout response.", "payment_not_found": "Payment DNA missing for order-bound payment_id — shop.orders.reconcile_stale, then shop.checkout.create with new idempotency_key; operators poll payments.get.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "rate_limit_exceeded": "IAP checkout/resume throttle (per user+project) — honor retry_after_ms or HTTP Retry-After, then retry shop.checkout.create. After the window, the same idempotency_key may return replayed=true without a new PSP session.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Poll order status after redirect; own orders only for hosted_app."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.orders.get", "related_tools": ["shop.checkout.create", "payments.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Orders Get", "visitor_callable": true, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "checkout_resume_auth": "Hosted IAP return: GET /api/commerce/iap/checkout/resume?project_id=&payment_id= with player Bearer/cookie after ?iap_checkout=1 — operators use payments.get, visitors do not.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "hosted_iap_return": "Mount Stripe from resume client_secret or assign checkout_url; strip query after terminal status. Static games: hosted-sdk-cdn iapCheckoutBoot.runIapCheckoutBootOnLoad().", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "order_not_found": "Use order_id from checkout response.", "payment_not_found": "Payment DNA missing for order-bound payment_id — shop.orders.reconcile_stale, then shop.checkout.create with new idempotency_key; operators poll payments.get.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "rate_limit_exceeded": "IAP checkout/resume throttle (per user+project) — honor retry_after_ms or HTTP Retry-After, then retry shop.checkout.create. After the window, the same idempotency_key may return replayed=true without a new PSP session.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Poll order status after redirect; own orders only for hosted_app."}, "do_not_use_when": "Merchant attention tail — use shop.orders.list with attention_only=true; get is buyer-safe single-order poll only.", "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Poll order after ?iap_checkout=1 redirect", "request": {"params": {"order_id": "<uuid-from-checkout>", "project_id": 1444}, "tool": "shop.orders.get"}, "response": {"data": {"status": "pending_payment", "terminal": false}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "hosted_resume_bff": "/api/commerce/iap/checkout/resume", "instruction_hint": "Poll order status after redirect; own orders only for hosted_app.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["payments.get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "receipt_rule": "Poll until status=fulfilled and terminal=true, or terminal failed/cancelled. terminal=false when channel_pass_invites_pending is non-empty (including fulfilled). grant_pending: metadata.last_grant_error (invite_failed → replay shop.fulfill). Response may include channel_pass_invites_pending and channel_pass_invite_recovery for composite pass SKUs. Visitors: GET /api/commerce/iap/checkout/public-session (awaiting_fulfillment) or /checkout/resume — not payments.get.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.checkout.create", "payments.get"], "required_cap": "mcp_read", "requires_preflight": false, "response_fields": {"awaiting_fulfillment": "True when fulfilled but Telegram invites incomplete.", "channel_pass_bindings": "Binding ids on enriched row (metadata and/or grants_snapshot).", "channel_pass_invite_recovery": "Composite pass SKU operator recovery text.", "channel_pass_invites_pending": "Binding ids still missing Telegram invite.", "fulfillment_phase": "Top-level mirror of metadata.fulfillment_phase on merchant list/order rows.", "metadata.channel_pass_bindings": "Binding ids stamped at checkout (copy of grants_snapshot channel_pass legs).", "metadata.fulfillment_phase": "Merchant metadata: invites_pending | complete — denorm for attention_only SQL.", "metadata.last_grant_error": "Last grant/invite error when grant_pending or invite gap.", "recovery_hint": "Buyer-safe poll hint when terminal=false.", "status": "Order lifecycle status.", "terminal": "False when channel_pass_invites_pending is non-empty (buyer and merchant)."}, "risk_class": "read", "safe_action": "shop_orders_get", "semantic_input_mode": "inherit_workflow", "summary": "Poll IAP order status after checkout redirect.", "title": "Shop Orders Get", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "checkout_resume_auth": "Hosted IAP return: GET /api/commerce/iap/checkout/resume?project_id=&payment_id= with player Bearer/cookie after ?iap_checkout=1 — operators use payments.get, visitors do not.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "hosted_iap_return": "Mount Stripe from resume client_secret or assign checkout_url; strip query after terminal status. Static games: hosted-sdk-cdn iapCheckoutBoot.runIapCheckoutBootOnLoad().", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "order_not_found": "Use order_id from checkout response.", "payment_not_found": "Payment DNA missing for order-bound payment_id — shop.orders.reconcile_stale, then shop.checkout.create with new idempotency_key; operators poll payments.get.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "rate_limit_exceeded": "IAP checkout/resume throttle (per user+project) — honor retry_after_ms or HTTP Retry-After, then retry shop.checkout.create. After the window, the same idempotency_key may return replayed=true without a new PSP session.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_blocked_locales": {"auth_required": {"en-US": "Sign in or use catalog_auth_required bypass for owner preview.", "pt-BR": "Entre ou use preview do dono com catalog_auth_required.", "ru-RU": "Войдите или используйте owner preview при catalog_auth_required."}, "project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}, "rate_limit_exceeded": {"en-US": "Checkout rate limit — honor retry_after then new idempotency_key if order stuck.", "pt-BR": "Rate limit no checkout — aguarde retry_after; nova idempotency_key se pedido travar.", "ru-RU": "Rate limit checkout — подождите retry_after; новый idempotency_key если заказ завис."}}, "when_not_to_use": "Merchant attention tail — use shop.orders.list with attention_only=true; get is buyer-safe single-order poll only.", "when_to_use": "Poll order status after redirect; own orders only for hosted_app.", "write_mode": null}, {"action": "shop.orders.reconcile_stale", "ai_tips": "Operator PAY-01: fail stale pending_payment without PSP URL/secret (buyer-owned order or project owner). Not on hosted /s/ allowlist — buyers use shop.orders.cancel. After payment_not_found on resume, shop.checkout.create with a new idempotency_key. Poll payments.get (L1 operator) for soft_currency_grant.status=ok; visitors poll shop.orders.get only.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "shop.orders.reconcile_stale", "mutation_risk": "low", "related_tools": ["shop.orders.get", "shop.checkout.create", "payments.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Orders Reconcile Stale", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "order_not_found": "Use order_id from checkout response.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Operator PAY-01: fail stale pending_payment without PSP URL/secret (buyer-owned order or project owner)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "shop.orders.reconcile_stale", "mutation_risk": "low", "related_tools": ["shop.orders.get", "shop.checkout.create", "payments.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Orders Reconcile Stale", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "order_not_found": "Use order_id from checkout response.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Operator PAY-01: fail stale pending_payment without PSP URL/secret (buyer-owned order or project owner)."}, "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Operator PAY-01: fail stale pending_payment without PSP URL/secret (buyer-owned order or project ow…", "kind": "mcp_domain", "mutation_kind": "body", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"order_id": {"description": "string", "type": "string"}, "recovery_hint": {"description": "string", "type": "string"}, "status": {"description": "string", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.orders.get", "shop.checkout.create", "payments.get"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "shop_orders_reconcile_stale", "semantic_input_mode": "inherit_workflow", "summary": "Fail stale pending_payment orders without a PSP checkout session (PAY-01).", "title": "Shop Orders Reconcile Stale", "verification": ["shop.orders.get"], "verify": [{"action": "shop.orders.get", "predicate": "named resource is visible"}], "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "order_not_found": "Use order_id from checkout response.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_blocked_locales": {"auth_required": {"en-US": "Sign in or use catalog_auth_required bypass for owner preview.", "pt-BR": "Entre ou use preview do dono com catalog_auth_required.", "ru-RU": "Войдите или используйте owner preview при catalog_auth_required."}, "project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Operator PAY-01: fail stale pending_payment without PSP URL/secret (buyer-owned order or project owner).", "write_mode": null}, {"action": "shop.orders.cancel", "ai_tips": "Buyer abandons pending_payment with no PSP URL — then shop.checkout.create with new idempotency_key.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "shop.orders.cancel", "related_tools": ["shop.orders.get", "shop.checkout.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Orders Cancel", "visitor_callable": true, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "order_not_cancelable": "Buyer cancel allowed for pending_payment, created, or failed only — paid/fulfilled/grant_pending need shop.refund (owner) or support; poll shop.orders.get.", "order_not_found": "Use order_id from checkout response.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Abandon stuck checkout — new idempotency_key on shop.checkout.create."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "shop.orders.cancel", "related_tools": ["shop.orders.get", "shop.checkout.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Orders Cancel", "visitor_callable": true, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "order_not_cancelable": "Buyer cancel allowed for pending_payment, created, or failed only — paid/fulfilled/grant_pending need shop.refund (owner) or support; poll shop.orders.get.", "order_not_found": "Use order_id from checkout response.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Abandon stuck checkout — new idempotency_key on shop.checkout.create."}, "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Abandon stuck checkout — new idempotency_key on shop.checkout.create.", "kind": "mcp_domain", "mutation_kind": "body", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"order_id": {"description": "string", "type": "string"}, "status": {"description": "canceled", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.orders.get", "shop.checkout.create"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "shop_orders_cancel", "semantic_input_mode": "inherit_workflow", "summary": "Cancel stuck pending_payment IAP order (buyer-owned).", "title": "Shop Orders Cancel", "verification": ["shop.orders.get"], "verify": [{"action": "shop.orders.get", "predicate": "named resource is visible"}], "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "order_not_cancelable": "Buyer cancel allowed for pending_payment, created, or failed only — paid/fulfilled/grant_pending need shop.refund (owner) or support; poll shop.orders.get.", "order_not_found": "Use order_id from checkout response.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_blocked_locales": {"auth_required": {"en-US": "Sign in or use catalog_auth_required bypass for owner preview.", "pt-BR": "Entre ou use preview do dono com catalog_auth_required.", "ru-RU": "Войдите или используйте owner preview при catalog_auth_required."}, "project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Abandon stuck checkout — new idempotency_key on shop.checkout.create.", "write_mode": null}, {"action": "shop.orders.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.orders.list", "related_tools": ["shop.orders.get", "shop.checkout.create", "shop.fulfill", "commerce.channel_pass.sweep"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Orders List", "visitor_callable": true, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "forbidden": "Own buyer scope; attention_only without project_admin or cross-user user_id is forbidden.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Visitor purchase history (hosted, scoped user_id) — rows include terminal, channel_pass_invites_pending, recovery_hint (buyer-safe)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.orders.list", "related_tools": ["shop.orders.get", "shop.checkout.create", "shop.fulfill", "commerce.channel_pass.sweep"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Orders List", "visitor_callable": true, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "forbidden": "Own buyer scope; attention_only without project_admin or cross-user user_id is forbidden.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Visitor purchase history (hosted, scoped user_id) — rows include terminal, channel_pass_invites_pending, recovery_hint (buyer-safe)."}, "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"limit": 50, "project_id": "<context.project_id>"}, "example_params_attention_only": {"attention_only": true, "limit": 20, "project_id": "<context.project_id>"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Visitor purchase history (hosted, scoped user_id) — rows include terminal, channel_pass_invites_pen…", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["shop.orders.get", "shop.fulfill"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "receipt_rule": "Merchant attention_only surfaces invite gaps — replay shop.fulfill; on-call sweep via commerce.channel_pass.sweep or scheduler.create_task.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.orders.get", "shop.checkout.create", "shop.fulfill", "commerce.channel_pass.sweep"], "required_cap": "mcp_read", "requires_preflight": false, "response_fields": {"attention_only": "Request param: when true, project_admin may omit user_id to list grant_pending/paid/created plus fulfillment_phase=invites_pending and fulfilled channel_pass invite gaps project-wide.", "channel_pass_bindings": "Binding ids on enriched row (metadata and/or grants_snapshot).", "channel_pass_invites_pending": "Binding ids still missing Telegram invite.", "fulfillment_phase": "Top-level mirror of metadata.fulfillment_phase on merchant list/order rows.", "metadata.channel_pass_bindings": "Binding ids stamped at checkout (copy of grants_snapshot channel_pass legs).", "metadata.fulfillment_phase": "Merchant metadata: invites_pending | complete — denorm for attention_only SQL.", "metadata.last_grant_error": "Merchant-only last grant/invite error code when present.", "orders": "Array of enriched IAP order rows (buyer or merchant surface).", "terminal": "False when channel_pass_invites_pending is non-empty (buyer and merchant)."}, "risk_class": "read", "safe_action": "shop_orders_list", "semantic_input_mode": "inherit_workflow", "summary": "Visitor purchase history (hosted, scoped user_id) — rows include terminal, channel_pass_invites_pending, recovery_hint (buyer-safe). Merchant support tail: attention_only=true (project_admin, omit use", "title": "Shop Orders List", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "forbidden": "Own buyer scope; attention_only without project_admin or cross-user user_id is forbidden.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_blocked_locales": {"auth_required": {"en-US": "Sign in or use catalog_auth_required bypass for owner preview.", "pt-BR": "Entre ou use preview do dono com catalog_auth_required.", "ru-RU": "Войдите или используйте owner preview при catalog_auth_required."}, "project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Visitor purchase history (hosted, scoped user_id) — rows include terminal, channel_pass_invites_pending, recovery_hint (buyer-safe).", "write_mode": null}, {"action": "shop.sinks.upsert", "ai_tips": "Owner: configure spend sinks (cost vectors) for wallets.spend.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.sinks.upsert", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Sinks Upsert", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "invalid_debit": "Ledger debit vector invalid for sink — owner shop.sinks.upsert.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "unknown_asset": "Create currency asset in catalog before SKU grants."}, "when_to_use": "Owner: configure spend sinks (cost vectors) for wallets.spend."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.sinks.upsert", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Sinks Upsert", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "invalid_debit": "Ledger debit vector invalid for sink — owner shop.sinks.upsert.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "unknown_asset": "Create currency asset in catalog before SKU grants."}, "when_to_use": "Owner: configure spend sinks (cost vectors) for wallets.spend."}, "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Owner: configure spend sinks (cost vectors) for wallets.spend.", "kind": "mcp_domain", "mutation_kind": "body", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "shop_sinks_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Owner: configure spend sinks (cost vectors) for wallets.spend.", "title": "Shop Sinks Upsert", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "invalid_debit": "Ledger debit vector invalid for sink — owner shop.sinks.upsert.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "unknown_asset": "Create currency asset in catalog before SKU grants."}, "when_blocked_locales": {"project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Owner: configure spend sinks (cost vectors) for wallets.spend.", "write_mode": null}, {"action": "shop.fulfill", "ai_tips": "Internal only — webhook worker after PSP success; never visitor-callable. grant_pending retry: order_id only when payment_id is on the order row. Each delivered invite appends binding_id via order_store.append_channel_pass_invite_sent (idempotent). While channel_pass_invites_pending is non-empty, finalize stays grant_pending (message channel_pass_invites_pending). Every channel_pass grant gets its own invite (metadata.channel_pass_invites_sent). Composite extras use ledger ref {order_id}:cp:{leg}.", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.fulfill", "related_tools": ["shop.orders.get", "commerce.channel_pass.status", "commerce.channel_pass.configure", "commerce.channel_pass.binding.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Fulfill", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "bonus_grant_failed": "Base grant ok; bonus pending — replay internal fulfill or poll shop.orders.get.", "bot_not_admin": "Channel bot is not administrator in the bound chat — add bot as admin with invite rights, then commerce.channel_pass.configure to refresh binding and run channel_pass_doctor.", "bot_not_found": "Bot runtime missing for channel binding — verify bot_id on ecosystem.commerce.channels.{binding_id}.", "buyer_subject_required": "channel_pass checkout needs buyer_subject (telegram external_user_id) in order metadata when any grant kind is channel_pass — use bot /passes or stamp metadata on shop.checkout.create.", "channel_binding_missing": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "entitlement_grant_failed": "Entitlement grant failed after ledger/inventory step — for channel_pass replay shop.fulfill after buyer_subject + channel binding; for digital_item fix SKU grants/assets then replay.", "forbidden_for_visitor": "Visitors: no shop.fulfill and no skip_sell_check on checkout — use shop.checkout.create with live sell gate; poll shop.orders.get.", "fulfill_claim_lost": "Concurrent fulfill lost claim — safe idempotent retry shop.fulfill.", "grant_failed": "Paid order grant_pending — replay shop.fulfill (worker) or poll shop.orders.get.", "invalid_grant": "SKU grants snapshot invalid — fix grants on shop.products.upsert.", "invalid_grants_snapshot": "SKU grants snapshot on order row is invalid — owner fixes SKU DNA.", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "invalid_order_status": "Order not in pending/paid state for fulfill — poll shop.orders.get.", "inventory_grant_failed": "digital_item inventory grant failed — verify asset_id then retry fulfill.", "invite_failed": "Grant succeeded but Telegram invite/outbound failed or pending bindings remain — order may be grant_pending; retry shop.fulfill; verify bot admin on channel. shop.fulfill may return message channel_pass_invites_pending with pending_bindings — each binding must appear in metadata.channel_pass_invites_sent before terminal=true on shop.orders.get.", "invite_stamp_failed": "Telegram invite was sent but order metadata stamp failed — replay shop.fulfill; do not charge again. Check DB row metadata.channel_pass_invites_sent.", "order_amount_mismatch": "Internal payments.create after checkout must match SQL order amount_minor — never edit amount; re-run shop.checkout.create with new idempotency_key if SKU price changed.", "order_currency_mismatch": "Payment currency must match order row — use shop.checkout.create SKU price.", "order_not_found": "Use order_id from checkout response.", "order_not_fulfillable": "Order refunded, canceled, or chargeback — do not replay fulfill.", "order_sku_mismatch": "Payment SKU metadata must match order — no client amount bypass.", "order_user_mismatch": "Payer user_id must match commerce_iap_orders.user_id — auth.get_profile.", "outbound_failed": "Telegram invite link created but bot outbound failed — check bot queue and replay shop.fulfill.", "payment_id_in_use": "PSP payment_id already bound — response includes bound_order_id; poll that order or start checkout with a new idempotency_key.", "payment_id_mismatch": "Fulfill must use the payment_id bound at checkout/PSP.", "payment_id_required": "Pending order needs PSP payment_id from webhook before shop.fulfill.", "payment_not_completed": "Poll payments.get until wallet_credit=ok before shop.fulfill.", "payment_order_mismatch": "payments.create metadata.order_id must match checkout order_id.", "payment_verify_failed": "Retry after PSP webhook; check payment_id on order row.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "provider_not_supported": "Channel pass checkout requires telegram buyer_subject — use bot /passes flow.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Internal only — webhook worker after PSP success; never visitor-callable."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.fulfill", "related_tools": ["shop.orders.get", "commerce.channel_pass.status", "commerce.channel_pass.configure", "commerce.channel_pass.binding.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Fulfill", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "bonus_grant_failed": "Base grant ok; bonus pending — replay internal fulfill or poll shop.orders.get.", "bot_not_admin": "Channel bot is not administrator in the bound chat — add bot as admin with invite rights, then commerce.channel_pass.configure to refresh binding and run channel_pass_doctor.", "bot_not_found": "Bot runtime missing for channel binding — verify bot_id on ecosystem.commerce.channels.{binding_id}.", "buyer_subject_required": "channel_pass checkout needs buyer_subject (telegram external_user_id) in order metadata when any grant kind is channel_pass — use bot /passes or stamp metadata on shop.checkout.create.", "channel_binding_missing": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "entitlement_grant_failed": "Entitlement grant failed after ledger/inventory step — for channel_pass replay shop.fulfill after buyer_subject + channel binding; for digital_item fix SKU grants/assets then replay.", "forbidden_for_visitor": "Visitors: no shop.fulfill and no skip_sell_check on checkout — use shop.checkout.create with live sell gate; poll shop.orders.get.", "fulfill_claim_lost": "Concurrent fulfill lost claim — safe idempotent retry shop.fulfill.", "grant_failed": "Paid order grant_pending — replay shop.fulfill (worker) or poll shop.orders.get.", "invalid_grant": "SKU grants snapshot invalid — fix grants on shop.products.upsert.", "invalid_grants_snapshot": "SKU grants snapshot on order row is invalid — owner fixes SKU DNA.", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "invalid_order_status": "Order not in pending/paid state for fulfill — poll shop.orders.get.", "inventory_grant_failed": "digital_item inventory grant failed — verify asset_id then retry fulfill.", "invite_failed": "Grant succeeded but Telegram invite/outbound failed or pending bindings remain — order may be grant_pending; retry shop.fulfill; verify bot admin on channel. shop.fulfill may return message channel_pass_invites_pending with pending_bindings — each binding must appear in metadata.channel_pass_invites_sent before terminal=true on shop.orders.get.", "invite_stamp_failed": "Telegram invite was sent but order metadata stamp failed — replay shop.fulfill; do not charge again. Check DB row metadata.channel_pass_invites_sent.", "order_amount_mismatch": "Internal payments.create after checkout must match SQL order amount_minor — never edit amount; re-run shop.checkout.create with new idempotency_key if SKU price changed.", "order_currency_mismatch": "Payment currency must match order row — use shop.checkout.create SKU price.", "order_not_found": "Use order_id from checkout response.", "order_not_fulfillable": "Order refunded, canceled, or chargeback — do not replay fulfill.", "order_sku_mismatch": "Payment SKU metadata must match order — no client amount bypass.", "order_user_mismatch": "Payer user_id must match commerce_iap_orders.user_id — auth.get_profile.", "outbound_failed": "Telegram invite link created but bot outbound failed — check bot queue and replay shop.fulfill.", "payment_id_in_use": "PSP payment_id already bound — response includes bound_order_id; poll that order or start checkout with a new idempotency_key.", "payment_id_mismatch": "Fulfill must use the payment_id bound at checkout/PSP.", "payment_id_required": "Pending order needs PSP payment_id from webhook before shop.fulfill.", "payment_not_completed": "Poll payments.get until wallet_credit=ok before shop.fulfill.", "payment_order_mismatch": "payments.create metadata.order_id must match checkout order_id.", "payment_verify_failed": "Retry after PSP webhook; check payment_id on order row.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "provider_not_supported": "Channel pass checkout requires telegram buyer_subject — use bot /passes flow.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Internal only — webhook worker after PSP success; never visitor-callable."}, "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Internal only — webhook worker after PSP success; never visitor-callable.", "kind": "mcp_domain", "mutation_kind": "body", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["shop.orders.get", "commerce.channel_pass.status", "commerce.channel_pass.configure"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "receipt_rule": "Internal webhook worker only. Invites append metadata.channel_pass_invites_sent via append_channel_pass_invite_sent; replay until channel_pass_invites_pending is empty. bot_not_admin: grant bot channel admin, commerce.channel_pass.configure, then replay.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.orders.get", "commerce.channel_pass.status", "commerce.channel_pass.configure", "commerce.channel_pass.binding.get"], "required_cap": "service_internal", "requires_preflight": false, "response_fields": {"channel_pass_bindings": "Binding ids on enriched row (metadata and/or grants_snapshot).", "channel_pass_invites_pending": "Binding ids still missing Telegram invite.", "error": "Grant or delivery code (buyer_subject_required, outbound_failed, invite_failed, invite_stamp_failed, bot_not_admin, bot_not_found, channel_binding_missing, …).", "message": "Human hint such as channel_pass_invites_pending.", "metadata.channel_pass_bindings": "Binding ids stamped at checkout (copy of grants_snapshot channel_pass legs).", "metadata.fulfillment_phase": "Merchant metadata: invites_pending | complete — denorm for attention_only SQL.", "pending_bindings": "Binding ids still missing Telegram invite (channel_pass).", "recoverable": "True when order is grant_pending and shop.fulfill may be retried."}, "risk_class": "low_write", "safe_action": "shop_fulfill", "semantic_input_mode": "inherit_workflow", "summary": "System: fulfill paid order (idempotent).", "title": "Shop Fulfill", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "bonus_grant_failed": "Base grant ok; bonus pending — replay internal fulfill or poll shop.orders.get.", "bot_not_admin": "Channel bot is not administrator in the bound chat — add bot as admin with invite rights, then commerce.channel_pass.configure to refresh binding and run channel_pass_doctor.", "bot_not_found": "Bot runtime missing for channel binding — verify bot_id on ecosystem.commerce.channels.{binding_id}.", "buyer_subject_required": "channel_pass checkout needs buyer_subject (telegram external_user_id) in order metadata when any grant kind is channel_pass — use bot /passes or stamp metadata on shop.checkout.create.", "channel_binding_missing": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "entitlement_grant_failed": "Entitlement grant failed after ledger/inventory step — for channel_pass replay shop.fulfill after buyer_subject + channel binding; for digital_item fix SKU grants/assets then replay.", "forbidden_for_visitor": "Visitors: no shop.fulfill and no skip_sell_check on checkout — use shop.checkout.create with live sell gate; poll shop.orders.get.", "fulfill_claim_lost": "Concurrent fulfill lost claim — safe idempotent retry shop.fulfill.", "grant_failed": "Paid order grant_pending — replay shop.fulfill (worker) or poll shop.orders.get.", "invalid_grant": "SKU grants snapshot invalid — fix grants on shop.products.upsert.", "invalid_grants_snapshot": "SKU grants snapshot on order row is invalid — owner fixes SKU DNA.", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "invalid_order_status": "Order not in pending/paid state for fulfill — poll shop.orders.get.", "inventory_grant_failed": "digital_item inventory grant failed — verify asset_id then retry fulfill.", "invite_failed": "Grant succeeded but Telegram invite/outbound failed or pending bindings remain — order may be grant_pending; retry shop.fulfill; verify bot admin on channel. shop.fulfill may return message channel_pass_invites_pending with pending_bindings — each binding must appear in metadata.channel_pass_invites_sent before terminal=true on shop.orders.get.", "invite_stamp_failed": "Telegram invite was sent but order metadata stamp failed — replay shop.fulfill; do not charge again. Check DB row metadata.channel_pass_invites_sent.", "order_amount_mismatch": "Internal payments.create after checkout must match SQL order amount_minor — never edit amount; re-run shop.checkout.create with new idempotency_key if SKU price changed.", "order_currency_mismatch": "Payment currency must match order row — use shop.checkout.create SKU price.", "order_not_found": "Use order_id from checkout response.", "order_not_fulfillable": "Order refunded, canceled, or chargeback — do not replay fulfill.", "order_sku_mismatch": "Payment SKU metadata must match order — no client amount bypass.", "order_user_mismatch": "Payer user_id must match commerce_iap_orders.user_id — auth.get_profile.", "outbound_failed": "Telegram invite link created but bot outbound failed — check bot queue and replay shop.fulfill.", "payment_id_in_use": "PSP payment_id already bound — response includes bound_order_id; poll that order or start checkout with a new idempotency_key.", "payment_id_mismatch": "Fulfill must use the payment_id bound at checkout/PSP.", "payment_id_required": "Pending order needs PSP payment_id from webhook before shop.fulfill.", "payment_not_completed": "Poll payments.get until wallet_credit=ok before shop.fulfill.", "payment_order_mismatch": "payments.create metadata.order_id must match checkout order_id.", "payment_verify_failed": "Retry after PSP webhook; check payment_id on order row.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "provider_not_supported": "Channel pass checkout requires telegram buyer_subject — use bot /passes flow.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_blocked_locales": {"bot_not_admin": {"en-US": "Channel bot is not administrator in the bound chat — add bot as admin with invite rights, then commerce.channel_pass.configure and channel_pass_doctor.", "pt-BR": "Bot não é admin do canal — permissões de convite, commerce.channel_pass.configure, channel_pass_doctor.", "ru-RU": "Бот не админ канала — выдайте права invite, commerce.channel_pass.configure, channel_pass_doctor."}, "bot_not_found": {"en-US": "Bot runtime missing for channel binding — verify bot_id on ecosystem.commerce.channels.{binding_id}.", "pt-BR": "Sem runtime para bot_id no leaf do canal — commerce.channel_pass.status.", "ru-RU": "Нет runtime для bot_id на leaf channel — commerce.channel_pass.status."}, "buyer_subject_required": {"en-US": "channel_pass checkout needs buyer_subject (telegram external_user_id) in order metadata — use bot /passes or stamp on shop.checkout.create.", "pt-BR": "buyer_subject (telegram external_user_id) no metadata — checkout pelo bot /passes.", "ru-RU": "Нужен buyer_subject (telegram external_user_id) — checkout из бота /passes."}, "channel_binding_missing": {"en-US": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "pt-BR": "SKU channel_pass sem leaf ecosystem.commerce.channels.{id} — commerce.channel_pass.configure, depois shop.products.upsert.", "ru-RU": "SKU channel_pass без ecosystem.commerce.channels.{id} — commerce.channel_pass.configure, затем shop.products.upsert."}, "invite_failed": {"en-US": "Grant succeeded but Telegram invite/outbound failed or pending bindings remain — retry shop.fulfill; verify bot admin on channel.", "pt-BR": "Grant ok, invite/outbound pendente — shop.fulfill; bot precisa ser admin do canal.", "ru-RU": "Грант прошёл, invite/outbound не завершён — shop.fulfill; бот должен быть админом канала."}, "invite_stamp_failed": {"en-US": "Telegram invite was sent but order metadata stamp failed — replay shop.fulfill; do not charge again. Check metadata.channel_pass_invites_sent.", "pt-BR": "Convite enviado, mas metadados do pedido falharam — repita shop.fulfill sem nova cobrança.", "ru-RU": "Invite отправлен, но метаданные заказа не обновились — повторите shop.fulfill без повторной оплаты."}, "outbound_failed": {"en-US": "Telegram invite link created but bot outbound failed — check bot queue and replay shop.fulfill.", "pt-BR": "Link criado, outbound do bot falhou — fila do bot e shop.fulfill.", "ru-RU": "Ссылка создана, outbound бота не дошёл — проверьте очередь и shop.fulfill."}, "provider_not_supported": {"en-US": "Channel access requires Telegram buyer_subject — open pay link from the bot.", "pt-BR": "Acesso ao canal via Telegram — abra o pay link pelo bot.", "ru-RU": "Доступ к каналу через Telegram — откройте pay link из бота."}}, "when_to_use": "Internal only — webhook worker after PSP success; never visitor-callable.", "write_mode": null}, {"action": "shop.refund", "ai_tips": "Owner refund fulfilled/paid/grant_pending with optional clawback (default true). Composite channel_pass SKUs shorten access first; response includes clawback map and channel_pass_legs when applicable. Not visitor-callable.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.refund", "related_tools": ["shop.orders.get", "shop.orders.list", "commerce.channel_pass.status", "shop.reports.summary"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Refund", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "channel_pass_refund_failed": "Entitlement shorten or Telegram revoke failed mid-refund — poll shop.orders.get; retry shop.refund idempotently if status is not terminal. Partial multi-binding refunds expose legs_applied in service response.", "clawback_failed": "Inspect unrecovered_amount in refund response payload.", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "order_not_found": "Use order_id from checkout response.", "order_not_refundable": "Refund fulfilled, paid, or grant_pending orders — not pending_payment/canceled.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "refund_failed": "Refund clawback or status transition failed — inspect error payload.", "refund_in_progress": "Refund may be resuming after a crash — retry shop.refund (idempotent per-asset ledger).", "revoke_failed": "Telegram ban/revoke failed after entitlement expired on refund — verify bot admin; retry shop.refund (idempotent). Response may include partial_refund and legs.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "wallet_service_unavailable": "Wallet ops offline — retry refund or support."}, "when_to_use": "Owner refund fulfilled/paid/grant_pending with optional clawback (default true)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.refund", "related_tools": ["shop.orders.get", "shop.orders.list", "commerce.channel_pass.status", "shop.reports.summary"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Refund", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "channel_pass_refund_failed": "Entitlement shorten or Telegram revoke failed mid-refund — poll shop.orders.get; retry shop.refund idempotently if status is not terminal. Partial multi-binding refunds expose legs_applied in service response.", "clawback_failed": "Inspect unrecovered_amount in refund response payload.", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "order_not_found": "Use order_id from checkout response.", "order_not_refundable": "Refund fulfilled, paid, or grant_pending orders — not pending_payment/canceled.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "refund_failed": "Refund clawback or status transition failed — inspect error payload.", "refund_in_progress": "Refund may be resuming after a crash — retry shop.refund (idempotent per-asset ledger).", "revoke_failed": "Telegram ban/revoke failed after entitlement expired on refund — verify bot admin; retry shop.refund (idempotent). Response may include partial_refund and legs.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "wallet_service_unavailable": "Wallet ops offline — retry refund or support."}, "when_to_use": "Owner refund fulfilled/paid/grant_pending with optional clawback (default true)."}, "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Owner refund fulfilled/paid/grant_pending with optional clawback (default true).", "kind": "mcp_domain", "mutation_kind": "body", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["shop.orders.get", "shop.orders.list"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"channel_pass": {"additionalProperties": true, "description": "object", "type": "object"}, "channel_pass_bindings": {"description": "string[] binding ids on channel_pass SKUs", "type": "string"}, "channel_pass_legs": {"description": "array", "items": {"type": "string"}, "type": "array"}, "clawback": {"additionalProperties": true, "description": "object", "type": "object"}, "legs_applied": {"description": "integer", "type": "integer"}, "metadata.channel_pass_bindings": {"description": "string[] copied at checkout", "type": "string"}, "metadata.fulfillment_phase": {"description": "invites_pending | complete in order metadata", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "order_id": {"description": "string", "type": "string"}, "partial_refund": {"description": "boolean", "type": "boolean"}, "replayed": {"description": "boolean", "type": "boolean"}, "status": {"description": "string", "type": "string"}, "success": {"description": "boolean", "type": "boolean"}, "unrecovered_amount": {"description": "int", "type": "integer"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.orders.get", "shop.orders.list", "commerce.channel_pass.status", "shop.reports.summary"], "required_cap": "project_admin", "requires_preflight": true, "response_fields": {"channel_pass": "Last channel_pass leg summary when order had pass grants.", "channel_pass_bindings": "Binding ids on enriched row (metadata and/or grants_snapshot).", "channel_pass_legs": "Per-binding refund legs on composite pass SKUs.", "clawback": "Per-asset amounts clawed from wallet (currency legs only).", "legs_applied": "Count of CP legs shortened before a mid-loop failure.", "metadata.channel_pass_bindings": "Binding ids stamped at checkout (copy of grants_snapshot channel_pass legs).", "metadata.fulfillment_phase": "Merchant metadata: invites_pending | complete — denorm for attention_only SQL.", "partial_refund": "True when a multi-binding pass refund failed mid-loop.", "replayed": "True when order was already refunded/chargeback.", "unrecovered_amount": "Shortfall when wallet balance < ledger owed."}, "risk_class": "financial", "rollback": [], "safe_action": "shop_refund", "semantic_input_mode": "inherit_workflow", "summary": "Owner refund fulfilled/paid/grant_pending with optional clawback (default true). Composite channel_pass SKUs shorten access first; response includes clawback map and channel_pass_legs when applicable.", "title": "Shop Refund", "verification": ["shop.orders.get", "payments.get"], "verify": [{"action": "shop.orders.get", "predicate": "named resource is visible"}, {"action": "payments.get", "predicate": "named resource is visible"}], "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "channel_pass_refund_failed": "Entitlement shorten or Telegram revoke failed mid-refund — poll shop.orders.get; retry shop.refund idempotently if status is not terminal. Partial multi-binding refunds expose legs_applied in service response.", "clawback_failed": "Inspect unrecovered_amount in refund response payload.", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "order_not_found": "Use order_id from checkout response.", "order_not_refundable": "Refund fulfilled, paid, or grant_pending orders — not pending_payment/canceled.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "refund_failed": "Refund clawback or status transition failed — inspect error payload.", "refund_in_progress": "Refund may be resuming after a crash — retry shop.refund (idempotent per-asset ledger).", "revoke_failed": "Telegram ban/revoke failed after entitlement expired on refund — verify bot admin; retry shop.refund (idempotent). Response may include partial_refund and legs.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "wallet_service_unavailable": "Wallet ops offline — retry refund or support."}, "when_blocked_locales": {"project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Owner refund fulfilled/paid/grant_pending with optional clawback (default true).", "write_mode": null}, {"action": "shop.reports.summary", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.reports.summary", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Reports Summary", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "commerce_iap_schema_missing": "Platform Postgres missing migrate_036 — run python database/platform_db_init.py or redeploy with platform_upgrade.sql.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Owner: gross/refunds rollup from commerce_iap_orders."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.reports.summary", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Reports Summary", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "commerce_iap_schema_missing": "Platform Postgres missing migrate_036 — run python database/platform_db_init.py or redeploy with platform_upgrade.sql.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Owner: gross/refunds rollup from commerce_iap_orders."}, "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Owner: gross/refunds rollup from commerce_iap_orders.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "shop_reports_summary", "semantic_input_mode": "inherit_workflow", "summary": "Owner: gross/refunds rollup from commerce_iap_orders.", "title": "Shop Reports Summary", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "commerce_iap_schema_missing": "Platform Postgres missing migrate_036 — run python database/platform_db_init.py or redeploy with platform_upgrade.sql.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_blocked_locales": {"project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Owner: gross/refunds rollup from commerce_iap_orders.", "write_mode": null}, {"action": "shop.webhooks.subscribe", "ai_tips": "Owner: HMAC outbound shop.order.* events to your backend.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.webhooks.subscribe", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Webhooks Subscribe", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "unsafe_webhook_url": "Use public HTTPS callback; private/metadata hosts blocked."}, "when_to_use": "Owner: HMAC outbound shop.order.* events to your backend."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.webhooks.subscribe", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Webhooks Subscribe", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "unsafe_webhook_url": "Use public HTTPS callback; private/metadata hosts blocked."}, "when_to_use": "Owner: HMAC outbound shop.order.* events to your backend."}, "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Owner: HMAC outbound shop.order.* events to your backend.", "kind": "mcp_domain", "mutation_kind": "body", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "shop_webhooks_subscribe", "semantic_input_mode": "inherit_workflow", "summary": "Owner: HMAC outbound shop.order.* events to your backend.", "title": "Shop Webhooks Subscribe", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "unsafe_webhook_url": "Use public HTTPS callback; private/metadata hosts blocked."}, "when_blocked_locales": {"project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Owner: HMAC outbound shop.order.* events to your backend.", "write_mode": null}, {"action": "shop.audit.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "shop.audit.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Audit List", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Support review of checkout/refund events — not buyer-facing."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "shop.audit.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Audit List", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Support review of checkout/refund events — not buyer-facing."}, "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Support review of checkout/refund events — not buyer-facing.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "shop_audit_list", "semantic_input_mode": "inherit_workflow", "summary": "Owner: recent IAP audit_log events (products upsert, checkout, cancel, refund) from DNA leaf ecosystem.commerce.iap.audit_log.", "title": "Shop Audit List", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_blocked_locales": {"auth_required": {"en-US": "Sign in or use catalog_auth_required bypass for owner preview.", "pt-BR": "Entre ou use preview do dono com catalog_auth_required.", "ru-RU": "Войдите или используйте owner preview при catalog_auth_required."}, "project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Support review of checkout/refund events — not buyer-facing.", "write_mode": null}, {"action": "shop.entitlements.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.entitlements.list", "related_tools": ["shop.orders.get", "shop.checkout.create", "wallets.balance", "rest.commerce.iap.entitlements"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Entitlements List", "visitor_callable": true, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "include_sandbox_ignored_on_hosted": "hosted_app and GET /api/commerce/iap/entitlements are live-only — include_sandbox=true is ignored (success, not an error). Sandbox grants after shop.sandbox.simulate: operator MCP shop.entitlements.list with include_sandbox=true (project_admin session).", "project_id_required": "Hosted BFF and MCP require project_id on order poll and entitlements.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Buyer entitlements after checkout."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.entitlements.list", "related_tools": ["shop.orders.get", "shop.checkout.create", "wallets.balance", "rest.commerce.iap.entitlements"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Entitlements List", "visitor_callable": true, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "include_sandbox_ignored_on_hosted": "hosted_app and GET /api/commerce/iap/entitlements are live-only — include_sandbox=true is ignored (success, not an error). Sandbox grants after shop.sandbox.simulate: operator MCP shop.entitlements.list with include_sandbox=true (project_admin session).", "project_id_required": "Hosted BFF and MCP require project_id on order poll and entitlements.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Buyer entitlements after checkout."}, "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Buyer entitlements after checkout.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.orders.get", "shop.checkout.create", "wallets.balance", "rest.commerce.iap.entitlements"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "shop_entitlements_list", "semantic_input_mode": "inherit_workflow", "summary": "List buyer entitlements for hosted IAP (REST parity).", "title": "Shop Entitlements List", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "include_sandbox_ignored_on_hosted": "hosted_app and GET /api/commerce/iap/entitlements are live-only — include_sandbox=true is ignored (success, not an error). Sandbox grants after shop.sandbox.simulate: operator MCP shop.entitlements.list with include_sandbox=true (project_admin session).", "project_id_required": "Hosted BFF and MCP require project_id on order poll and entitlements.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_blocked_locales": {"auth_required": {"en-US": "Sign in or use catalog_auth_required bypass for owner preview.", "pt-BR": "Entre ou use preview do dono com catalog_auth_required.", "ru-RU": "Войдите или используйте owner preview при catalog_auth_required."}, "project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Buyer entitlements after checkout.", "write_mode": null}, {"action": "shop.embed.snippet", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.shop.gen1"], "id": "shop.embed.snippet", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Shop Embed Snippet", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Agent needs copy-paste HTML aligned with /commerce/lite gallery — not a new widget."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.shop.gen1"], "id": "shop.embed.snippet", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Shop Embed Snippet", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Agent needs copy-paste HTML aligned with /commerce/lite gallery — not a new widget."}, "domain": "shop", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Agent needs copy-paste HTML aligned with /commerce/lite gallery — not a new widget.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "shop_embed_snippet", "semantic_input_mode": "inherit_workflow", "summary": "HTML embed snippet from commerce-surface-snippets fixture for agents.", "title": "Shop Embed Snippet", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_blocked_locales": {}, "when_to_use": "Agent needs copy-paste HTML aligned with /commerce/lite gallery — not a new widget.", "write_mode": null}, {"action": "wallets.balance", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.balance", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Balance", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Player soft-currency balances (commerce_iap ledger), not AgentPay wallets.list. Hosted: prefer GET /api/commerce/iap/balances or sdk getBalances."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.balance", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Balance", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Player soft-currency balances (commerce_iap ledger), not AgentPay wallets.list. Hosted: prefer GET /api/commerce/iap/balances or sdk getBalances."}, "domain": "wallets", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Player soft-currency balances (commerce_iap ledger), not AgentPay wallets.list. Hosted: prefer GET …", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "wallets_balance", "semantic_input_mode": "inherit_workflow", "summary": "Player soft-currency balances (commerce_iap ledger), not AgentPay wallets.list. Hosted: prefer GET /api/commerce/iap/balances or sdk getBalances.", "title": "Wallets Balance", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"auth_required": {"en-US": "Sign in or use catalog_auth_required bypass for owner preview.", "pt-BR": "Entre ou use preview do dono com catalog_auth_required.", "ru-RU": "Войдите или используйте owner preview при catalog_auth_required."}, "project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Player soft-currency balances (commerce_iap ledger), not AgentPay wallets.list. Hosted: prefer GET /api/commerce/iap/balances or sdk getBalances.", "write_mode": null}, {"action": "wallets.ledger.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.ledger.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Ledger List", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "forbidden_cross_user": "Hosted session: omit user_id — ledger uses the signed-in player only.", "forbidden_operator_user_id": "Omit user_id to read your own IAP ledger on MCP, or add project_admin to service_caps to read another player's ledger.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append-only IAP ledger entries for the signed-in player. Hosted: GET /api/commerce/iap/ledger or sdk listIapLedger."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.ledger.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Ledger List", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "forbidden_cross_user": "Hosted session: omit user_id — ledger uses the signed-in player only.", "forbidden_operator_user_id": "Omit user_id to read your own IAP ledger on MCP, or add project_admin to service_caps to read another player's ledger.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append-only IAP ledger entries for the signed-in player. Hosted: GET /api/commerce/iap/ledger or sdk listIapLedger."}, "domain": "wallets", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Append-only IAP ledger entries for the signed-in player. Hosted: GET /api/commerce/iap/ledger or sd…", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "wallets_ledger_list", "semantic_input_mode": "inherit_workflow", "summary": "Append-only IAP ledger entries for the signed-in player. Hosted: GET /api/commerce/iap/ledger or sdk listIapLedger.", "title": "Wallets Ledger List", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "forbidden_cross_user": "Hosted session: omit user_id — ledger uses the signed-in player only.", "forbidden_operator_user_id": "Omit user_id to read your own IAP ledger on MCP, or add project_admin to service_caps to read another player's ledger.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"auth_required": {"en-US": "Sign in or use catalog_auth_required bypass for owner preview.", "pt-BR": "Entre ou use preview do dono com catalog_auth_required.", "ru-RU": "Войдите или используйте owner preview при catalog_auth_required."}, "project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Append-only IAP ledger entries for the signed-in player. Hosted: GET /api/commerce/iap/ledger or sdk listIapLedger.", "write_mode": null}, {"action": "wallets.spend", "ai_tips": "Spend at configured sink; idempotency_key required. Hosted: POST /api/commerce/iap/spend or sdk spendAtIapSink.", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.spend", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Spend", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "idempotency_key_required": "Generate stable UUID per checkout or spend attempt.", "insufficient_funds": "Player balance too low for sink cost.", "invalid_debit": "Ledger debit vector invalid for sink — owner shop.sinks.upsert.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "sink_mismatch": "Idempotency key was already used for a different sink_id — use a new key.", "sink_not_found": "Owner defines sink via shop.sinks.upsert.", "spend_partial_state": "Prior spend left partial debits — ops reconcile before retry.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_sync_failed": "Ledger debited; wallet sync failed — retry or ops reconcile (compensating entry).", "wallet_withdraw_failed": "Transient ledger error — retry spend with same idempotency_key."}, "when_to_use": "Spend at configured sink; idempotency_key required. Hosted: POST /api/commerce/iap/spend or sdk spendAtIapSink."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.spend", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Spend", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "idempotency_key_required": "Generate stable UUID per checkout or spend attempt.", "insufficient_funds": "Player balance too low for sink cost.", "invalid_debit": "Ledger debit vector invalid for sink — owner shop.sinks.upsert.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "sink_mismatch": "Idempotency key was already used for a different sink_id — use a new key.", "sink_not_found": "Owner defines sink via shop.sinks.upsert.", "spend_partial_state": "Prior spend left partial debits — ops reconcile before retry.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_sync_failed": "Ledger debited; wallet sync failed — retry or ops reconcile (compensating entry).", "wallet_withdraw_failed": "Transient ledger error — retry spend with same idempotency_key."}, "when_to_use": "Spend at configured sink; idempotency_key required. Hosted: POST /api/commerce/iap/spend or sdk spendAtIapSink."}, "domain": "wallets", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Spend at configured sink; idempotency_key required. Hosted: POST /api/commerce/iap/spend or sdk spe…", "kind": "mcp_domain", "mutation_kind": "body", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"balances": {"description": "array", "items": {"type": "string"}, "type": "array"}, "success": {"description": "boolean", "type": "boolean"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "rollback": [], "safe_action": "wallets_spend", "semantic_input_mode": "inherit_workflow", "summary": "Spend at configured sink; idempotency_key required. Hosted: POST /api/commerce/iap/spend or sdk spendAtIapSink.", "title": "Wallets Spend", "verification": ["wallets.balance", "wallets.ledger.list"], "verify": [{"action": "wallets.balance", "predicate": "named resource is visible"}, {"action": "wallets.ledger.list", "predicate": "named resource is visible"}], "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "idempotency_key_required": "Generate stable UUID per checkout or spend attempt.", "insufficient_funds": "Player balance too low for sink cost.", "invalid_debit": "Ledger debit vector invalid for sink — owner shop.sinks.upsert.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "sink_mismatch": "Idempotency key was already used for a different sink_id — use a new key.", "sink_not_found": "Owner defines sink via shop.sinks.upsert.", "spend_partial_state": "Prior spend left partial debits — ops reconcile before retry.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_sync_failed": "Ledger debited; wallet sync failed — retry or ops reconcile (compensating entry).", "wallet_withdraw_failed": "Transient ledger error — retry spend with same idempotency_key."}, "when_blocked_locales": {"auth_required": {"en-US": "Sign in or use catalog_auth_required bypass for owner preview.", "pt-BR": "Entre ou use preview do dono com catalog_auth_required.", "ru-RU": "Войдите или используйте owner preview при catalog_auth_required."}, "project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Spend at configured sink; idempotency_key required. Hosted: POST /api/commerce/iap/spend or sdk spendAtIapSink.", "write_mode": null}, {"action": "wallets.list", "aliases": ["wallets.get"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.list", "related_tools": ["wallets.create", "payments.get_balance", "wallets.deposit", "wallets.transfer"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Wallets List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "wallets.list — project_id, currency, and wallet_id params required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_service_unavailable": "Backoff then retry; agentstack_diagnose if it persists"}, "when_to_use": "Enumerate wallets before deposit, transfer, or balance check."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.list", "related_tools": ["wallets.create", "payments.get_balance", "wallets.deposit", "wallets.transfer"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Wallets List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "wallets.list — project_id, currency, and wallet_id params required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_service_unavailable": "Backoff then retry; agentstack_diagnose if it persists"}, "when_to_use": "Enumerate wallets before deposit, transfer, or balance check."}, "domain": "wallets", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Enumerate wallets before deposit, transfer, or balance check.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "string", "type": "string"}, "success": {"description": "bool", "type": "boolean"}, "total": {"description": "int", "type": "integer"}, "wallets": {"description": "array", "items": {"type": "string"}, "type": "array"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["wallets.create", "payments.get_balance", "wallets.deposit", "wallets.transfer"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "wallets_list", "semantic_input_mode": "inherit_workflow", "summary": "List wallets for a project (and optionally user).", "title": "Wallets List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "wallets.list — project_id, currency, and wallet_id params required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_service_unavailable": "Backoff then retry; agentstack_diagnose if it persists"}, "when_to_use": "Enumerate wallets before deposit, transfer, or balance check.", "write_mode": null}, {"action": "wallets.create", "aliases": ["wallets.create_wallet", "wallets.ensure", "wallets.update_wallet"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.create", "mutation_risk": "low", "related_tools": ["wallets.list", "wallets.deposit", "payments.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "wallets.list — project_id, currency, and wallet_id params required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_service_unavailable": "Backoff then retry; agentstack_diagnose if it persists"}, "when_to_use": "Provision a wallet before deposit or transfer. A personal USD/USDT wallet is project 1. A tenant project wallet is custom currency only. Real money does not sit on tenant data.money."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.create", "mutation_risk": "low", "related_tools": ["wallets.list", "wallets.deposit", "payments.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "wallets.list — project_id, currency, and wallet_id params required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_service_unavailable": "Backoff then retry; agentstack_diagnose if it persists"}, "when_to_use": "Provision a wallet before deposit or transfer. A personal USD/USDT wallet is project 1. A tenant project wallet is custom currency only. Real money does not sit on tenant data.money."}, "domain": "wallets", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Provision a wallet before deposit or transfer. A personal USD/USDT wallet is project 1. A tenant pr…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["wallets.list", "wallets.deposit", "payments.get_balance"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "wallets_create", "semantic_input_mode": "inherit_workflow", "summary": "Create a wallet for a project or user.", "title": "Wallets Create", "tool_chains": ["project_bootstrap", "economy_setup", "economy_setup"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "wallets.list — project_id, currency, and wallet_id params required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_service_unavailable": "Backoff then retry; agentstack_diagnose if it persists"}, "when_to_use": "Provision a wallet before deposit or transfer. A personal USD/USDT wallet is project 1. A tenant project wallet is custom currency only. Real money does not sit on tenant data.money.", "write_mode": null}, {"action": "wallets.deposit", "aliases": ["wallets.top_up"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.deposit", "mutation_risk": "low", "related_tools": ["wallets.list", "payments.get_balance", "wallets.transfer"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Deposit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden_for_visitor": "Hosted visitor cookie — use shop.checkout.create, not wallets.deposit", "idempotency_key_required": "Pass idempotency_key on every wallets.deposit (replay-safe)", "invalid_amount": "amount must be positive — wallets.list for balance first", "invalid_parameters": "wallets.list — project_id, currency, and wallet_id params required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_not_found": "wallets.list — wallet_id before deposit; wallets.create if none", "wallet_service_unavailable": "Backoff then retry; agentstack_diagnose if it persists"}, "when_to_use": "Credit a wallet. Virtual balances stay on the project. USD and USDT credit a personal wallet on project 1, or the project treasury wallet (data.ecosystem.money, origin treasury). They never land on te"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.deposit", "mutation_risk": "low", "related_tools": ["wallets.list", "payments.get_balance", "wallets.transfer"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Deposit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden_for_visitor": "Hosted visitor cookie — use shop.checkout.create, not wallets.deposit", "idempotency_key_required": "Pass idempotency_key on every wallets.deposit (replay-safe)", "invalid_amount": "amount must be positive — wallets.list for balance first", "invalid_parameters": "wallets.list — project_id, currency, and wallet_id params required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_not_found": "wallets.list — wallet_id before deposit; wallets.create if none", "wallet_service_unavailable": "Backoff then retry; agentstack_diagnose if it persists"}, "when_to_use": "Credit a wallet. Virtual balances stay on the project. USD and USDT credit a personal wallet on project 1, or the project treasury wallet (data.ecosystem.money, origin treasury). They never land on te"}, "domain": "wallets", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Credit a wallet. Virtual balances stay on the project. USD and USDT credit a personal wallet on pro…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["wallets.list", "payments.get_balance", "wallets.transfer"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "safe_action": "wallets_deposit", "semantic_input_mode": "inherit_workflow", "summary": "Deposit funds to a wallet.", "title": "Wallets Deposit", "tool_chains": ["project_bootstrap", "economy_setup"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden_for_visitor": "Hosted visitor cookie — use shop.checkout.create, not wallets.deposit", "idempotency_key_required": "Pass idempotency_key on every wallets.deposit (replay-safe)", "invalid_amount": "amount must be positive — wallets.list for balance first", "invalid_parameters": "wallets.list — project_id, currency, and wallet_id params required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_not_found": "wallets.list — wallet_id before deposit; wallets.create if none", "wallet_service_unavailable": "Backoff then retry; agentstack_diagnose if it persists"}, "when_to_use": "Credit a wallet. Virtual balances stay on the project. USD and USDT credit a personal wallet on project 1, or the project treasury wallet (data.ecosystem.money, origin treasury). They never land on te", "write_mode": null}, {"action": "wallets.transfer", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.transfer", "mutation_risk": "low", "related_tools": ["wallets.list", "payments.get_balance", "payments.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Transfer", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "wallets.list — project_id, currency, and wallet_id params required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_service_unavailable": "Backoff then retry; agentstack_diagnose if it persists"}, "when_to_use": "Move a balance between two wallets. Virtual currency stays on the project. USD and USDT move only on project 1, or between treasury wallets on the same project. A tenant to_wallet_id for those codes m"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.transfer", "mutation_risk": "low", "related_tools": ["wallets.list", "payments.get_balance", "payments.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Transfer", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "wallets.list — project_id, currency, and wallet_id params required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_service_unavailable": "Backoff then retry; agentstack_diagnose if it persists"}, "when_to_use": "Move a balance between two wallets. Virtual currency stays on the project. USD and USDT move only on project 1, or between treasury wallets on the same project. A tenant to_wallet_id for those codes m"}, "domain": "wallets", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Move a balance between two wallets. Virtual currency stays on the project. USD and USDT move only o…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["wallets.list", "payments.get_balance", "payments.create"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "safe_action": "wallets_transfer", "semantic_input_mode": "inherit_workflow", "summary": "Transfer funds between wallets (same project).", "title": "Wallets Transfer", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "wallets.list — project_id, currency, and wallet_id params required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_service_unavailable": "Backoff then retry; agentstack_diagnose if it persists"}, "when_to_use": "Move a balance between two wallets. Virtual currency stays on the project. USD and USDT move only on project 1, or between treasury wallets on the same project. A tenant to_wallet_id for those codes m", "write_mode": null}, {"action": "commerce.channel_pass.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.channel_pass.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "commerce.channel_pass.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Channel Pass Status", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Read stacked channel-pass expiry for a telegram subject."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.channel_pass.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "commerce.channel_pass.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Channel Pass Status", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Read stacked channel-pass expiry for a telegram subject."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1", "core.commerce.channel_pass.gen1"], "instruction_hint": "Read stacked channel-pass expiry for a telegram subject.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["commerce.channel_pass.configure", "shop.products.upsert", "shop.enablement.status"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_channel_pass_status", "semantic_input_mode": "inherit_workflow", "summary": "Read channel pass entitlement for a buyer subject.", "title": "Commerce Channel Pass Status", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_blocked_locales": {"project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Read stacked channel-pass expiry for a telegram subject.", "write_mode": null}, {"action": "commerce.channel_pass.binding.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.channel_pass.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "commerce.channel_pass.binding.get", "related_tools": ["commerce.channel_pass.configure", "shop.products.upsert", "scheduler.create_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Channel Pass Binding Get", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "channel_binding_missing": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Read-only verify one channel binding leaf after configure — prefer over projects.get_data when you only need chat_id/bot_id/channel_only."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.channel_pass.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "commerce.channel_pass.binding.get", "related_tools": ["commerce.channel_pass.configure", "shop.products.upsert", "scheduler.create_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Channel Pass Binding Get", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "channel_binding_missing": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Read-only verify one channel binding leaf after configure — prefer over projects.get_data when you only need chat_id/bot_id/channel_only."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"binding_id": "library", "project_id": "<context.project_id>"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1", "core.commerce.channel_pass.gen1"], "instruction_hint": "Read-only verify one channel binding leaf after configure — prefer over projects.get_data when you …", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["commerce.channel_pass.configure", "commerce.channel_pass.sweep", "shop.products.upsert", "scheduler.create_task"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.channel_pass.configure", "shop.products.upsert", "scheduler.create_task"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_channel_pass_binding_get", "semantic_input_mode": "inherit_workflow", "summary": "Read one ecosystem.commerce.channels.{binding_id} leaf (no full project blob).", "title": "Commerce Channel Pass Binding Get", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "channel_binding_missing": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_blocked_locales": {"channel_binding_missing": {"en-US": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "pt-BR": "SKU channel_pass sem leaf ecosystem.commerce.channels.{id} — commerce.channel_pass.configure, depois shop.products.upsert.", "ru-RU": "SKU channel_pass без ecosystem.commerce.channels.{id} — commerce.channel_pass.configure, затем shop.products.upsert."}, "project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Read-only verify one channel binding leaf after configure — prefer over projects.get_data when you only need chat_id/bot_id/channel_only.", "write_mode": null}, {"action": "commerce.channel_pass.sweep", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.channel_pass.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "commerce.channel_pass.sweep", "related_tools": ["scheduler.create_task", "commerce.channel_pass.configure", "commerce.channel_pass.status", "shop.orders.list", "shop.fulfill"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Channel Pass Sweep", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Owner on-demand wake_index sweep: expiry notices + Telegram revoke."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.channel_pass.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "commerce.channel_pass.sweep", "related_tools": ["scheduler.create_task", "commerce.channel_pass.configure", "commerce.channel_pass.status", "shop.orders.list", "shop.fulfill"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Channel Pass Sweep", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Owner on-demand wake_index sweep: expiry notices + Telegram revoke."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1", "core.commerce.channel_pass.gen1"], "instruction_hint": "Owner on-demand wake_index sweep: expiry notices + Telegram revoke.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["scheduler.create_task", "commerce.channel_pass.configure", "commerce.channel_pass.status"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["scheduler.create_task", "commerce.channel_pass.configure", "commerce.channel_pass.status", "shop.orders.list", "shop.fulfill"], "required_cap": "project_admin", "requires_preflight": false, "returns": {"processed": "int — rows revoked or notices sent", "revoke_failed": "int optional — Telegram ban failures", "wake_save_failed": "bool optional — wake_index DNA write failed"}, "risk_class": "read", "safe_action": "commerce_channel_pass_sweep", "scheduler_create_task_example": {"cron": "15 * * * *", "enabled": true, "name": "channel_pass_sweep", "payload": {"action": "commerce.channel_pass.sweep", "project_id": "<context.project_id>"}}, "semantic_input_mode": "inherit_workflow", "summary": "Process channel_pass wake_index: expiry notices and Telegram revoke for lapsed access.", "title": "Commerce Channel Pass Sweep", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_blocked_locales": {"project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Owner on-demand wake_index sweep: expiry notices + Telegram revoke.", "write_mode": null}, {"action": "commerce.channel_pass.configure", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.channel_pass.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "commerce.channel_pass.configure", "related_tools": ["commerce.channel_pass.binding.get", "commerce.channel_pass.sweep", "shop.products.upsert", "scheduler.create_task", "shop.enablement.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Channel Pass Configure", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Owner: bind one Telegram channel the project bot can invite into and later remove from."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.channel_pass.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "commerce.channel_pass.configure", "related_tools": ["commerce.channel_pass.binding.get", "commerce.channel_pass.sweep", "shop.products.upsert", "scheduler.create_task", "shop.enablement.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Channel Pass Configure", "visitor_callable": false, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Owner: bind one Telegram channel the project bot can invite into and later remove from."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"binding_id": "library", "bot_id": "<bot uuid>", "channel_only": true, "chat_id": "-100123", "menu_intro": "Choose a period. Access stacks when you pay again.", "notify_before_days": [3, 1]}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1", "core.commerce.channel_pass.gen1"], "instruction_hint": "Owner: bind one Telegram channel the project bot can invite into and later remove from.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["shop.products.upsert", "scheduler.create_task", "shop.enablement.status"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.channel_pass.binding.get", "commerce.channel_pass.sweep", "shop.products.upsert", "scheduler.create_task", "shop.enablement.status"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_channel_pass_configure", "scheduler_create_task_example": {"cron": "15 * * * *", "enabled": true, "name": "channel_pass_sweep", "payload": {"action": "commerce.channel_pass.sweep", "project_id": "<context.project_id>"}}, "semantic_input_mode": "inherit_workflow", "summary": "Bind a Telegram channel for paid access: invite link after pay, ban when the pass expires.", "title": "Commerce Channel Pass Configure", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_blocked_locales": {"project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_to_use": "Owner: bind one Telegram channel the project bot can invite into and later remove from.", "write_mode": null}, {"action": "commerce.ai.generate_products", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "heavy_llm", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.ai.generate_products", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Ai Generate Products", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id + prompt constraints from assets.list", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rate_limited": "Backoff — tier limits via buffs.get_effective_limits", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run catalog SKUs before assets.create — not a store publish."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "heavy_llm", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.ai.generate_products", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Ai Generate Products", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id + prompt constraints from assets.list", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rate_limited": "Backoff — tier limits via buffs.get_effective_limits", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run catalog SKUs before assets.create — not a store publish."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "heavy", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Dry-run catalog SKUs before assets.create — not a store publish.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_ai_generate_products", "semantic_input_mode": "inherit_workflow", "summary": "Dry-run AI product generation — returns wizard answer dicts only. Mirrors POST /api/commerce/ai/generate-products.", "title": "Commerce Ai Generate Products", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id + prompt constraints from assets.list", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rate_limited": "Backoff — tier limits via buffs.get_effective_limits", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run catalog SKUs before assets.create — not a store publish.", "write_mode": null}, {"action": "commerce.ai.magic_fill", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "heavy_llm", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.ai.magic_fill", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Ai Magic Fill", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Plan tier — buffs.get_effective_limits", "invalid_parameters": "asset id or draft row from assets.create", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Parse listing copy into assets wizard answers — pair with assets.create."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "heavy_llm", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.ai.magic_fill", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Ai Magic Fill", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Plan tier — buffs.get_effective_limits", "invalid_parameters": "asset id or draft row from assets.create", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Parse listing copy into assets wizard answers — pair with assets.create."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "heavy", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Parse listing copy into assets wizard answers — pair with assets.create.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_ai_magic_fill", "semantic_input_mode": "inherit_workflow", "summary": "Parse text into product wizard answers. Mirrors POST /api/commerce/ai/magic-fill.", "title": "Commerce Ai Magic Fill", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Plan tier — buffs.get_effective_limits", "invalid_parameters": "asset id or draft row from assets.create", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Parse listing copy into assets wizard answers — pair with assets.create.", "write_mode": null}, {"action": "commerce.coupon.list", "aliases": ["commerce.list_coupons"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.coupon.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Coupon List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List project-scoped promo codes from 8DNA commerce.coupon_registry. Mirrors GET /api/commerce/merchant/coupons."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.coupon.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Coupon List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List project-scoped promo codes from 8DNA commerce.coupon_registry. Mirrors GET /api/commerce/merchant/coupons."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "List project-scoped promo codes from 8DNA commerce.coupon_registry. Mirrors GET /api/commerce/merch…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_coupon_list", "semantic_input_mode": "inherit_workflow", "summary": "List project-scoped promo codes from 8DNA commerce.coupon_registry. Mirrors GET /api/commerce/merchant/coupons.", "title": "Commerce Coupon List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List project-scoped promo codes from 8DNA commerce.coupon_registry. Mirrors GET /api/commerce/merchant/coupons.", "write_mode": null}, {"action": "commerce.coupon.create", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.coupon.create", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Coupon Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create discount coupon for checkout — not Stripe SDK."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.coupon.create", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Coupon Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create discount coupon for checkout — not Stripe SDK."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Create discount coupon for checkout — not Stripe SDK.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commerce_coupon_create", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a shop promo code (percent or fixed USDT off). Optional listing_uuids scopes the code to specific listings. Mirrors POST /api/commerce/merchant/coupons.", "title": "Commerce Coupon Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create discount coupon for checkout — not Stripe SDK.", "write_mode": null}, {"action": "commerce.coupon.update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.coupon.update", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Coupon Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update a project promo code. Mirrors PUT /api/commerce/merchant/coupons/{code}."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.coupon.update", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Coupon Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update a project promo code. Mirrors PUT /api/commerce/merchant/coupons/{code}."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Update a project promo code. Mirrors PUT /api/commerce/merchant/coupons/{code}.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commerce_coupon_update", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Update a project promo code. Mirrors PUT /api/commerce/merchant/coupons/{code}.", "title": "Commerce Coupon Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update a project promo code. Mirrors PUT /api/commerce/merchant/coupons/{code}.", "write_mode": null}, {"action": "commerce.coupon.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.coupon.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Coupon Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete a project promo code. Mirrors DELETE /api/commerce/merchant/coupons/{code}."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.coupon.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Coupon Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete a project promo code. Mirrors DELETE /api/commerce/merchant/coupons/{code}."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Delete a project promo code. Mirrors DELETE /api/commerce/merchant/coupons/{code}.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": true, "risk_class": "destructive", "safe_action": "commerce_coupon_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete a project promo code. Mirrors DELETE /api/commerce/merchant/coupons/{code}.", "title": "Commerce Coupon Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete a project promo code. Mirrors DELETE /api/commerce/merchant/coupons/{code}.", "write_mode": null}, {"action": "commerce.participant.grant_holding", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.participant.grant_holding", "mutation_risk": "low", "related_tools": ["assets.list", "buffs.grant_tenant_subscription", "commerce.sell.activate"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Participant Grant Holding", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — operator session required", "grant_failed": "assets.list — confirm asset_id; buffs path for subscription SKUs", "insufficient_permissions": "require_tenant_project_write — project admin on tenant PID", "invalid_project": "Bind context.project_id or pass project_id (>1 tenant PID)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Tenant operator grants digital goods / inventory to a buyer or member user."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.participant.grant_holding", "mutation_risk": "low", "related_tools": ["assets.list", "buffs.grant_tenant_subscription", "commerce.sell.activate"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Participant Grant Holding", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — operator session required", "grant_failed": "assets.list — confirm asset_id; buffs path for subscription SKUs", "insufficient_permissions": "require_tenant_project_write — project admin on tenant PID", "invalid_project": "Bind context.project_id or pass project_id (>1 tenant PID)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Tenant operator grants digital goods / inventory to a buyer or member user."}, "doc_audience": "operator", "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Tenant operator grants digital goods / inventory to a buyer or member user.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["assets.list", "buffs.grant_tenant_subscription", "commerce.sell.activate"], "required_cap": "assets_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commerce_participant_grant_holding", "semantic_input_mode": "inherit_workflow", "summary": "Grant catalog asset holdings to an end user in your tenant project.", "title": "Commerce Participant Grant Holding", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — operator session required", "grant_failed": "assets.list — confirm asset_id; buffs path for subscription SKUs", "insufficient_permissions": "require_tenant_project_write — project admin on tenant PID", "invalid_project": "Bind context.project_id or pass project_id (>1 tenant PID)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Tenant operator grants digital goods / inventory to a buyer or member user.", "write_mode": null}, {"action": "commerce.refund.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.refund.status", "related_tools": ["payments.get", "commerce.refund.psp_refund", "commerce.refund.manual_complete", "commerce.refund.manual_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Refund Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem_owner_required for manual refund plane", "invalid_parameters": "buyer_project_id, buyer_user_id, order_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "commerce.refund.status with buyer_project_id, buyer_user_id, order_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After commerce order refund request. Wallet rail finishes in refund_compensation. Fiat rail: payments.get until wallet_credit=ok, then commerce.refund.psp_refund or payments.refund, then commerce.refu"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.refund.status", "related_tools": ["payments.get", "commerce.refund.psp_refund", "commerce.refund.manual_complete", "commerce.refund.manual_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Refund Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem_owner_required for manual refund plane", "invalid_parameters": "buyer_project_id, buyer_user_id, order_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "commerce.refund.status with buyer_project_id, buyer_user_id, order_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After commerce order refund request. Wallet rail finishes in refund_compensation. Fiat rail: payments.get until wallet_credit=ok, then commerce.refund.psp_refund or payments.refund, then commerce.refu"}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "After commerce order refund request. Wallet rail finishes in refund_compensation. Fiat rail: paymen…", "kind": "mcp_domain", "mutation_kind": "none", "navigation": ["commerce.refund.status", "payments.get", "commerce.refund.psp_refund", "payments.refund", "commerce.refund.manual_complete"], "next_actions": ["payments.get", "commerce.refund.psp_refund"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "receipt_rule": "Fiat rail: payments.get until wallet_credit=ok before PSP refund; then manual_complete with external_refund_id.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["payments.get", "commerce.refund.psp_refund", "commerce.refund.manual_complete", "commerce.refund.manual_list"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "safe_action": "commerce_refund_status", "semantic_input_mode": "inherit_workflow", "summary": "Poll refund request + compensation for an order. Mirrors GET /api/commerce/orders/{order_id}/refund-request.", "title": "Commerce Refund Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem_owner_required for manual refund plane", "invalid_parameters": "buyer_project_id, buyer_user_id, order_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "commerce.refund.status with buyer_project_id, buyer_user_id, order_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After commerce order refund request. Wallet rail finishes in refund_compensation. Fiat rail: payments.get until wallet_credit=ok, then commerce.refund.psp_refund or payments.refund, then commerce.refu", "write_mode": null}, {"action": "commerce.refund.manual_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.refund.manual_list", "related_tools": ["commerce.refund.status", "commerce.refund.manual_complete"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Refund Manual List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Finances / ecosystem owner session — not tenant buyer", "forbidden": "auth.get_profile then ecosystem admin role", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem admin: list refund_requested orders awaiting manual compensation for a buyer commerce slice. Mirrors GET /api/admin/commerce/manual-refunds."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.refund.manual_list", "related_tools": ["commerce.refund.status", "commerce.refund.manual_complete"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Refund Manual List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Finances / ecosystem owner session — not tenant buyer", "forbidden": "auth.get_profile then ecosystem admin role", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem admin: list refund_requested orders awaiting manual compensation for a buyer commerce slice. Mirrors GET /api/admin/commerce/manual-refunds."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Ecosystem admin: list refund_requested orders awaiting manual compensation for a buyer commerce sli…", "kind": "mcp_domain", "mutation_kind": "none", "navigation": ["commerce.refund.status", "payments.get", "commerce.refund.psp_refund", "payments.refund", "commerce.refund.manual_complete"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "receipt_rule": "Fiat rail: payments.get until wallet_credit=ok before PSP refund; then manual_complete with external_refund_id.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.refund.status", "commerce.refund.manual_complete"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "safe_action": "commerce_refund_manual_list", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem admin: list refund_requested orders awaiting manual compensation for a buyer commerce slice. Mirrors GET /api/admin/commerce/manual-refunds.", "title": "Commerce Refund Manual List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Finances / ecosystem owner session — not tenant buyer", "forbidden": "auth.get_profile then ecosystem admin role", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem admin: list refund_requested orders awaiting manual compensation for a buyer commerce slice. Mirrors GET /api/admin/commerce/manual-refunds.", "write_mode": null}, {"action": "commerce.refund.psp_refund", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.refund.psp_refund", "related_tools": ["commerce.refund.status", "payments.get", "payments.refund", "commerce.refund.manual_complete"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Refund Psp Refund", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Finances / ecosystem owner — seller claw + PSP", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_payment_id": "Order metadata.payment_id missing — payments.get from checkout receipt", "order_not_found": "commerce.refund.status — verify buyer_project_id, buyer_user_id, order_id", "rail_not_fiat": "Wallet rail auto-compensates — no PSP step", "refund_exceeds_capture": "Partial amount must be ≤ captured major units", "refund_in_progress": "Retry with same idempotency_key or poll payments.get", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After commerce.refund.status shows payments_fiat + payment_id. Requires payments.get wallet_credit=ok. Then commerce.refund.manual_complete with external_refund_id."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.refund.psp_refund", "related_tools": ["commerce.refund.status", "payments.get", "payments.refund", "commerce.refund.manual_complete"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Refund Psp Refund", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Finances / ecosystem owner — seller claw + PSP", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_payment_id": "Order metadata.payment_id missing — payments.get from checkout receipt", "order_not_found": "commerce.refund.status — verify buyer_project_id, buyer_user_id, order_id", "rail_not_fiat": "Wallet rail auto-compensates — no PSP step", "refund_exceeds_capture": "Partial amount must be ≤ captured major units", "refund_in_progress": "Retry with same idempotency_key or poll payments.get", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After commerce.refund.status shows payments_fiat + payment_id. Requires payments.get wallet_credit=ok. Then commerce.refund.manual_complete with external_refund_id."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "After commerce.refund.status shows payments_fiat + payment_id. Requires payments.get wallet_credit=…", "kind": "mcp_domain", "mutation_kind": "none", "navigation": ["commerce.refund.status", "payments.get", "commerce.refund.psp_refund", "payments.refund", "commerce.refund.manual_complete"], "next_actions": ["commerce.refund.manual_complete"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "receipt_rule": "Fiat rail: payments.get until wallet_credit=ok before PSP refund; then manual_complete with external_refund_id.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.refund.status", "payments.get", "payments.refund", "commerce.refund.manual_complete"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "safe_action": "commerce_refund_psp_refund", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem admin: run payments.refund for order.metadata.payment_id on payments_fiat rail (seller claw + Stripe/Tochka). Call before commerce.refund.manual_complete.", "title": "Commerce Refund Psp Refund", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Finances / ecosystem owner — seller claw + PSP", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_payment_id": "Order metadata.payment_id missing — payments.get from checkout receipt", "order_not_found": "commerce.refund.status — verify buyer_project_id, buyer_user_id, order_id", "rail_not_fiat": "Wallet rail auto-compensates — no PSP step", "refund_exceeds_capture": "Partial amount must be ≤ captured major units", "refund_in_progress": "Retry with same idempotency_key or poll payments.get", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After commerce.refund.status shows payments_fiat + payment_id. Requires payments.get wallet_credit=ok. Then commerce.refund.manual_complete with external_refund_id.", "write_mode": null}, {"action": "commerce.refund.manual_complete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.refund.manual_complete", "related_tools": ["commerce.refund.status", "commerce.refund.psp_refund", "payments.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Refund Manual Complete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Same as manual_list — operator refund completion", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "commerce.refund.manual_list row id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After fiat money moved: commerce.refund.psp_refund or external PSP, then pass external_refund_id."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.refund.manual_complete", "related_tools": ["commerce.refund.status", "commerce.refund.psp_refund", "payments.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Refund Manual Complete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Same as manual_list — operator refund completion", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "commerce.refund.manual_list row id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After fiat money moved: commerce.refund.psp_refund or external PSP, then pass external_refund_id."}, "do_not_use_when": "After PSP/claw — not before commerce.refund.psp_refund or external PSP refund.", "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "After fiat money moved: commerce.refund.psp_refund or external PSP, then pass external_refund_id.", "kind": "mcp_domain", "mutation_kind": "none", "navigation": ["commerce.refund.status", "payments.get", "commerce.refund.psp_refund", "payments.refund", "commerce.refund.manual_complete"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"revoked_entitlements": {"description": "array", "items": {"type": "string"}, "type": "array"}, "status": {"description": "string", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "receipt_rule": "Fiat rail: payments.get until wallet_credit=ok before PSP refund; then manual_complete with external_refund_id.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.refund.status", "commerce.refund.psp_refund", "payments.get"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "rollback": [], "safe_action": "commerce_refund_manual_complete", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem admin: mark fiat/manual refund compensated — revoke entitlements, set order refunded. Mirrors POST /api/admin/commerce/manual-refunds/complete.", "title": "Commerce Refund Manual Complete", "verification": ["commerce.refund.status", "commerce.refund.manual_list"], "verify": [{"action": "commerce.refund.status", "predicate": "named resource is visible"}, {"action": "commerce.refund.manual_list", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Same as manual_list — operator refund completion", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "commerce.refund.manual_list row id", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "After PSP/claw — not before commerce.refund.psp_refund or external PSP refund.", "when_to_use": "After fiat money moved: commerce.refund.psp_refund or external PSP, then pass external_refund_id.", "write_mode": null}, {"action": "commerce.storefront.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.commerce.gen1"], "id": "commerce.storefront.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project read + commerce caps", "invalid_parameters": "project_id required — catalog before seed_apply", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Browse ECS listings before commerce.sell.activate or buyer checkout."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.commerce.gen1"], "id": "commerce.storefront.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project read + commerce caps", "invalid_parameters": "project_id required — catalog before seed_apply", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Browse ECS listings before commerce.sell.activate or buyer checkout."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Browse ECS listings before commerce.sell.activate or buyer checkout.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_storefront_list", "semantic_input_mode": "inherit_workflow", "summary": "List storefront listings via StorefrontReadFacade (ECS organelle). Mirrors GET /api/commerce/storefront/listings. Guest global marketplace: scope=global, type=auction, sort=ending. Filters: status=act", "title": "Commerce Storefront List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project read + commerce caps", "invalid_parameters": "project_id required — catalog before seed_apply", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Browse ECS listings before commerce.sell.activate or buyer checkout.", "write_mode": null}, {"action": "commerce.storefront.health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.commerce.gen1"], "id": "commerce.storefront.health", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Storefront index + ECS organelle health (admin diagnostics slice)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.commerce.gen1"], "id": "commerce.storefront.health", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Storefront index + ECS organelle health (admin diagnostics slice)."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Storefront index + ECS organelle health (admin diagnostics slice).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_storefront_health", "semantic_input_mode": "inherit_workflow", "summary": "Storefront index + ECS organelle health (admin diagnostics slice).", "title": "Commerce Storefront Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Storefront index + ECS organelle health (admin diagnostics slice).", "write_mode": null}, {"action": "commerce.reconcile", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.reconcile", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner — finances PID plane", "invalid_parameters": "date range + project scope", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops escrow reconciliation (ecosystem owner)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.reconcile", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner — finances PID plane", "invalid_parameters": "date range + project scope", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops escrow reconciliation (ecosystem owner)."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Ops escrow reconciliation (ecosystem owner).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": true, "risk_class": "destructive", "safe_action": "commerce_reconcile", "semantic_input_mode": "inherit_workflow", "summary": "Ops: find marketplace deals stuck after confirm without transfer. Example: {\"dry_run\": true, \"project_id\": 1}", "title": "Commerce Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner — finances PID plane", "invalid_parameters": "date range + project scope", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops escrow reconciliation (ecosystem owner).", "write_mode": null}, {"action": "commerce.checkout.session", "ai_tips": "Start marketplace checkout. Does not confirm or move money. Wallet confirm is finance.pay.execute. Card confirm is payments.create, then poll payments.get until wallet_credit=ok (personal wallet on project 1 or treasury).", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.checkout.session", "mutation_risk": "low", "related_tools": ["finance.pay.execute", "payments.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Checkout Session", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; finance.pay.execute confirms wallet rail after session create", "idempotency_mismatch": "Same idempotency_key with different listing — use a new key per listing", "invalid_parameters": "listing_uuid required; buyer_project_id defaults to context.project_id", "invalid_price": "Listing price ≤ 0 — seller must fix asset/listing price before checkout", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "listing_not_active": "Seller delisted SKU — pick another listing_uuid from storefront browse", "listing_not_found": "assets.list or storefront index — listing_uuid must be live marketplace row", "marketplace_unavailable": "Marketplace index offline — retry; agentstack_diagnose if persistent", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Buyer checkout — not commerce.sell.activate; widen payments cap on API key", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "showcase_guest_checkout_disabled": "auth.login — showcase seller blocks anonymous marketplace checkout", "unauthorized": "auth.get_profile — marketplace checkout requires signed-in buyer", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Start marketplace checkout. Does not confirm or move money. Wallet confirm is finance.pay.execute. Card confirm is payments.create, then poll payments.get until wallet_credit=ok (personal wallet on pr"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.checkout.session", "mutation_risk": "low", "related_tools": ["finance.pay.execute", "payments.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Checkout Session", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; finance.pay.execute confirms wallet rail after session create", "idempotency_mismatch": "Same idempotency_key with different listing — use a new key per listing", "invalid_parameters": "listing_uuid required; buyer_project_id defaults to context.project_id", "invalid_price": "Listing price ≤ 0 — seller must fix asset/listing price before checkout", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "listing_not_active": "Seller delisted SKU — pick another listing_uuid from storefront browse", "listing_not_found": "assets.list or storefront index — listing_uuid must be live marketplace row", "marketplace_unavailable": "Marketplace index offline — retry; agentstack_diagnose if persistent", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Buyer checkout — not commerce.sell.activate; widen payments cap on API key", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "showcase_guest_checkout_disabled": "auth.login — showcase seller blocks anonymous marketplace checkout", "unauthorized": "auth.get_profile — marketplace checkout requires signed-in buyer", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Start marketplace checkout. Does not confirm or move money. Wallet confirm is finance.pay.execute. Card confirm is payments.create, then poll payments.get until wallet_credit=ok (personal wallet on pr"}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Start marketplace checkout. Does not confirm or move money. Wallet confirm is finance.pay.execute. …", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["finance.pay.execute", "payments.create"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commerce_checkout_session", "semantic_input_mode": "inherit_workflow", "summary": "Create a marketplace checkout session. Real money is not moved here. Confirm a wallet quote with finance.pay.execute. Card capture uses payments.create. Credits land on L0 project 1 or L2 treasury, ne", "title": "Commerce Checkout Session", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; finance.pay.execute confirms wallet rail after session create", "idempotency_mismatch": "Same idempotency_key with different listing — use a new key per listing", "invalid_parameters": "listing_uuid required; buyer_project_id defaults to context.project_id", "invalid_price": "Listing price ≤ 0 — seller must fix asset/listing price before checkout", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "listing_not_active": "Seller delisted SKU — pick another listing_uuid from storefront browse", "listing_not_found": "assets.list or storefront index — listing_uuid must be live marketplace row", "marketplace_unavailable": "Marketplace index offline — retry; agentstack_diagnose if persistent", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Buyer checkout — not commerce.sell.activate; widen payments cap on API key", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "showcase_guest_checkout_disabled": "auth.login — showcase seller blocks anonymous marketplace checkout", "unauthorized": "auth.get_profile — marketplace checkout requires signed-in buyer", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Start marketplace checkout. Does not confirm or move money. Wallet confirm is finance.pay.execute. Card confirm is payments.create, then poll payments.get until wallet_credit=ok (personal wallet on pr", "write_mode": null}, {"action": "commerce.sell.activate", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.sell.gen1"], "id": "commerce.sell.activate", "mutation_risk": "high", "related_tools": ["commerce.storefront.seed_apply", "payments.create", "assets.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Commerce Sell Activate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Tenant operator — commerce.sell.activate vs buffs.grant; buyers use commerce.checkout.session", "idempotency_mismatch": "Same idempotency_key with a different product set or publish flag — mint a new key", "invalid_parameters": "SKU / activation payload from storefront list", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Project write + commerce cap — not buyer marketplace checkout session", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "First shop: earnings wallet, product seed, public storefront, optional /s/ publish. user_id is required. Later products use commerce.storefront.seed_plan, not a second activate."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.sell.gen1"], "id": "commerce.sell.activate", "mutation_risk": "high", "related_tools": ["commerce.storefront.seed_apply", "payments.create", "assets.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Commerce Sell Activate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Tenant operator — commerce.sell.activate vs buffs.grant; buyers use commerce.checkout.session", "idempotency_mismatch": "Same idempotency_key with a different product set or publish flag — mint a new key", "invalid_parameters": "SKU / activation payload from storefront list", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Project write + commerce cap — not buyer marketplace checkout session", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "First shop: earnings wallet, product seed, public storefront, optional /s/ publish. user_id is required. Later products use commerce.storefront.seed_plan, not a second activate."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "First shop: earnings wallet, product seed, public storefront, optional /s/ publish. user_id is requ…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"activation": {"additionalProperties": true, "description": "object", "type": "object"}, "success": {"description": "bool", "type": "boolean"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Paid tenant SKU: webhook/C24 auto-grant — not buffs.apply_buff after payments.create.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.storefront.seed_apply", "payments.create", "assets.create"], "required_cap": "payments|project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "commerce_sell_activate", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "One-shot seller activation: earnings wallet, product seed, public policy, storefront index upsert, optional hosted vitrine. Mirrors POST /api/commerce/sell/activate.", "title": "Commerce Sell Activate", "tool_chains": ["payment_to_subscription", "trial_to_paid_tier"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Tenant operator — commerce.sell.activate vs buffs.grant; buyers use commerce.checkout.session", "idempotency_mismatch": "Same idempotency_key with a different product set or publish flag — mint a new key", "invalid_parameters": "SKU / activation payload from storefront list", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Project write + commerce cap — not buyer marketplace checkout session", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "First shop: earnings wallet, product seed, public storefront, optional /s/ publish. user_id is required. Later products use commerce.storefront.seed_plan, not a second activate.", "write_mode": null}, {"action": "commerce.storefront.seed_plan", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.seed_plan", "related_tools": ["commerce.storefront.seed_apply", "commerce.storefront.seed_undo"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Seed Plan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Preview assets and listings before seed_apply. Pass specs[] and/or pack_id. seed_apply takes the returned plan, not pack_id."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.seed_plan", "related_tools": ["commerce.storefront.seed_apply", "commerce.storefront.seed_undo"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Seed Plan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Preview assets and listings before seed_apply. Pass specs[] and/or pack_id. seed_apply takes the returned plan, not pack_id."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Preview assets and listings before seed_apply. Pass specs[] and/or pack_id. seed_apply takes the re…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.storefront.seed_apply", "commerce.storefront.seed_undo"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_storefront_seed_plan", "semantic_input_mode": "inherit_workflow", "summary": "Dry-run Storefront Studio seed — compose asset/listing drafts and guidance hints. Mirrors POST /api/commerce/storefront/seed/plan.", "title": "Commerce Storefront Seed Plan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Preview assets and listings before seed_apply. Pass specs[] and/or pack_id. seed_apply takes the returned plan, not pack_id.", "write_mode": null}, {"action": "commerce.storefront.seed_apply", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.seed_apply", "mutation_risk": "low", "related_tools": ["commerce.storefront.hosted_publish", "commerce.storefront.hosted_manifest"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Seed Apply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Write the plan from seed_plan: asset upsert, listing, storefront index. Pass params.plan from the previous step. Undo with seed_undo and run_id."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.seed_apply", "mutation_risk": "low", "related_tools": ["commerce.storefront.hosted_publish", "commerce.storefront.hosted_manifest"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Seed Apply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Write the plan from seed_plan: asset upsert, listing, storefront index. Pass params.plan from the previous step. Undo with seed_undo and run_id."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Write the plan from seed_plan: asset upsert, listing, storefront index. Pass params.plan from the p…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.storefront.hosted_publish", "commerce.storefront.hosted_manifest"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commerce_storefront_seed_apply", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Apply a Storefront Studio seed plan (asset upsert → listing → index). Mirrors POST /api/commerce/storefront/seed/apply.", "title": "Commerce Storefront Seed Apply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Write the plan from seed_plan: asset upsert, listing, storefront index. Pass params.plan from the previous step. Undo with seed_undo and run_id.", "write_mode": null}, {"action": "commerce.storefront.seed_undo", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.seed_undo", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Seed Undo", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Undo a prior seed run — cancel listings and remove from storefront index. Mirrors POST /api/commerce/storefront/seed/undo."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.seed_undo", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Seed Undo", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Undo a prior seed run — cancel listings and remove from storefront index. Mirrors POST /api/commerce/storefront/seed/undo."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Undo a prior seed run — cancel listings and remove from storefront index. Mirrors POST /api/commerc…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commerce_storefront_seed_undo", "semantic_input_mode": "inherit_workflow", "summary": "Undo a prior seed run — cancel listings and remove from storefront index. Mirrors POST /api/commerce/storefront/seed/undo.", "title": "Commerce Storefront Seed Undo", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Undo a prior seed run — cancel listings and remove from storefront index. Mirrors POST /api/commerce/storefront/seed/undo.", "write_mode": null}, {"action": "commerce.storefront.seed_ingest", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.seed_ingest", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Seed Ingest", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Parse bulk source (csv/json/ai_batch/magic/clone) into ProductSpec rows. Mirrors POST /api/commerce/storefront/seed/ingest."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.seed_ingest", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Seed Ingest", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Parse bulk source (csv/json/ai_batch/magic/clone) into ProductSpec rows. Mirrors POST /api/commerce/storefront/seed/ingest."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Parse bulk source (csv/json/ai_batch/magic/clone) into ProductSpec rows. Mirrors POST /api/commerce…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commerce_storefront_seed_ingest", "semantic_input_mode": "inherit_workflow", "summary": "Parse bulk source (csv/json/ai_batch/magic/clone) into ProductSpec rows. Mirrors POST /api/commerce/storefront/seed/ingest.", "title": "Commerce Storefront Seed Ingest", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Parse bulk source (csv/json/ai_batch/magic/clone) into ProductSpec rows. Mirrors POST /api/commerce/storefront/seed/ingest.", "write_mode": null}, {"action": "commerce.storefront.one_click_fill", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.one_click_fill", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront One Click Fill", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Catalog assets exist but have no active listing. Creates listings only — does not invent new products."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.one_click_fill", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront One Click Fill", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Catalog assets exist but have no active listing. Creates listings only — does not invent new products."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Catalog assets exist but have no active listing. Creates listings only — does not invent new produc…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commerce_storefront_one_click_fill", "semantic_input_mode": "inherit_workflow", "summary": "Create listings for eligible catalog assets without active listings. Mirrors POST /api/commerce/storefront/seed/one-click-fill.", "title": "Commerce Storefront One Click Fill", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Catalog assets exist but have no active listing. Creates listings only — does not invent new products.", "write_mode": null}, {"action": "commerce.storefront.hosted_manifest", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.hosted_manifest", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Hosted Manifest", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read hosted vitrine manifest (bucket, hosted_dirty, merchandising). Mirrors GET /api/commerce/storefront/hosted/manifest."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.hosted_manifest", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Hosted Manifest", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read hosted vitrine manifest (bucket, hosted_dirty, merchandising). Mirrors GET /api/commerce/storefront/hosted/manifest."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Read hosted vitrine manifest (bucket, hosted_dirty, merchandising). Mirrors GET /api/commerce/store…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_storefront_hosted_manifest", "semantic_input_mode": "inherit_workflow", "summary": "Read hosted vitrine manifest (bucket, hosted_dirty, merchandising). Mirrors GET /api/commerce/storefront/hosted/manifest.", "title": "Commerce Storefront Hosted Manifest", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read hosted vitrine manifest (bucket, hosted_dirty, merchandising). Mirrors GET /api/commerce/storefront/hosted/manifest.", "write_mode": null}, {"action": "commerce.storefront.hosted_publish", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.hosted_publish", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Hosted Publish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "user_id + project_id — build dist before publish", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "publish_failed": "commerce.storefront.health — bucket + hosted manifest", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Publish hosted /s/ vitrine from storefront index."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.hosted_publish", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Hosted Publish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "user_id + project_id — build dist before publish", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "publish_failed": "commerce.storefront.health — bucket + hosted manifest", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Publish hosted /s/ vitrine from storefront index."}, "domain": "commerce", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Publish hosted /s/ vitrine from storefront index.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": true, "risk_class": "production_publish", "safe_action": "commerce_storefront_hosted_publish", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Publish hosted vitrine static bundle + tenant boot JSON when dist is on server. Mirrors POST /api/commerce/storefront/hosted/publish.", "title": "Commerce Storefront Hosted Publish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "user_id + project_id — build dist before publish", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "publish_failed": "commerce.storefront.health — bucket + hosted manifest", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Publish hosted /s/ vitrine from storefront index.", "write_mode": null}, {"action": "platform.fleet.get_operator_preset", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.platform.gen1"], "id": "platform.fleet.get_operator_preset", "related_tools": ["platform.fleet.set_operator_preset", "platform.fleet.apply_operator_preset"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Platform Fleet Get Operator Preset", "when_to_use": "Admin Fleet tools tab — read platform preset before apply."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.platform.gen1"], "id": "platform.fleet.get_operator_preset", "related_tools": ["platform.fleet.set_operator_preset", "platform.fleet.apply_operator_preset"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Platform Fleet Get Operator Preset", "when_to_use": "Admin Fleet tools tab — read platform preset before apply."}, "domain": "platform", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Admin Fleet tools tab — read platform preset before apply.", "mutation_kind": "none", "related_tools": ["platform.fleet.set_operator_preset", "platform.fleet.apply_operator_preset"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "platform_fleet_get_operator_preset", "semantic_input_mode": "inherit_workflow", "summary": "Load ecosystem operator MCP tool policy preset (ecosystem admin).", "title": "Platform Fleet Get Operator Preset", "when_to_use": "Admin Fleet tools tab — read platform preset before apply.", "write_mode": null}, {"action": "platform.fleet.set_operator_preset", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.platform.gen1"], "id": "platform.fleet.set_operator_preset", "related_tools": ["platform.fleet.get_operator_preset"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Platform Fleet Set Operator Preset", "when_to_use": "Admin updates forbidden/approval lists for all orchestrators."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.platform.gen1"], "id": "platform.fleet.set_operator_preset", "related_tools": ["platform.fleet.get_operator_preset"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Platform Fleet Set Operator Preset", "when_to_use": "Admin updates forbidden/approval lists for all orchestrators."}, "domain": "platform", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Admin updates forbidden/approval lists for all orchestrators.", "mutation_kind": "entity", "related_tools": ["platform.fleet.get_operator_preset"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "platform_fleet_set_operator_preset", "semantic_input_mode": "inherit_workflow", "summary": "Save ecosystem operator MCP tool policy preset.", "title": "Platform Fleet Set Operator Preset", "when_to_use": "Admin updates forbidden/approval lists for all orchestrators.", "write_mode": null}, {"action": "platform.fleet.apply_operator_preset", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.platform.gen1"], "id": "platform.fleet.apply_operator_preset", "related_tools": ["platform.fleet.get_operator_preset"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Platform Fleet Apply Operator Preset", "when_to_use": "Roll out native-tool * policy to existing orchestrators."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.platform.gen1"], "id": "platform.fleet.apply_operator_preset", "related_tools": ["platform.fleet.get_operator_preset"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Platform Fleet Apply Operator Preset", "when_to_use": "Roll out native-tool * policy to existing orchestrators."}, "domain": "platform", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Roll out native-tool * policy to existing orchestrators.", "mutation_kind": "entity", "related_tools": ["platform.fleet.get_operator_preset"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "platform_fleet_apply_operator_preset", "semantic_input_mode": "inherit_workflow", "summary": "Apply ecosystem operator preset to project orchestrator agent policies.", "title": "Platform Fleet Apply Operator Preset", "when_to_use": "Roll out native-tool * policy to existing orchestrators.", "write_mode": null}, {"action": "bots.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.list", "related_tools": ["bots.get", "bots.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "bots_run capability required", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover fleet rows before get/run. Read projection on the response — summary is not full spec. home=project (default) | self | project_self — env_uuid only when home=project. owner=user lists persona"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.list", "related_tools": ["bots.get", "bots.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "bots_run capability required", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover fleet rows before get/run. Read projection on the response — summary is not full spec. home=project (default) | self | project_self — env_uuid only when home=project. owner=user lists persona"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Discover fleet rows before get/run. Read projection on the response — summary is not full spec. hom…", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.get", "bots.create"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_list", "semantic_input_mode": "inherit_workflow", "summary": "Default projection=summary rows are uuid, title, deployment_state, and record_status. projection=full is bot_spec.", "title": "Bots List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "bots_run capability required", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover fleet rows before get/run. Read projection on the response — summary is not full spec. home=project (default) | self | project_self — env_uuid only when home=project. owner=user lists persona", "write_mode": null}, {"action": "bots.templates", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.templates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List built-in bot templates before bots.create."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.templates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List built-in bot templates before bots.create."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "List built-in bot templates before bots.create.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_templates", "semantic_input_mode": "inherit_workflow", "summary": "List built-in bot templates before bots.create.", "title": "Bots Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List built-in bot templates before bots.create.", "write_mode": null}, {"action": "bots.waba_templates", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.waba_templates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Waba Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List WhatsApp Business API templates (builtins + optional Graph sync)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.waba_templates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Waba Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List WhatsApp Business API templates (builtins + optional Graph sync)."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "List WhatsApp Business API templates (builtins + optional Graph sync).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_waba_templates", "semantic_input_mode": "inherit_workflow", "summary": "List WhatsApp Business API templates (builtins + optional Graph sync).", "title": "Bots Waba Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List WhatsApp Business API templates (builtins + optional Graph sync).", "write_mode": null}, {"action": "bots.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.get", "related_tools": ["bots.list", "bots.update", "bots.simulate", "bots.acl.list", "bots.acl.get_mode"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Get", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load full agent_spec for edit or run. home=project | self | project_self — env_uuid only when home=project (sandbox overlay). owner=user for personal rows. Omit env for production read."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.get", "related_tools": ["bots.list", "bots.update", "bots.simulate", "bots.acl.list", "bots.acl.get_mode"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Get", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load full agent_spec for edit or run. home=project | self | project_self — env_uuid only when home=project (sandbox overlay). owner=user for personal rows. Omit env for production read."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Load full agent_spec for edit or run. home=project | self | project_self — env_uuid only when home=…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bot": {"description": "Serialized fleet row (card / spec envelope)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "bot_spec": {"description": "Full spec when projection=full", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "cleanup_action": {"description": "Suggested fleet cleanup when present", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "instruction_slice": {"description": "channels_count and next_actions hints", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "lifecycle": {"description": "deployment_state and record_status summary", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "projection": {"description": "summary | full", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.list", "bots.update", "bots.simulate", "bots.acl.list", "bots.acl.get_mode"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_get", "semantic_input_mode": "inherit_workflow", "summary": "Load full agent_spec for edit or run. home=project | self | project_self — env_uuid only when home=project (sandbox overlay). owner=user for personal rows. Omit env for production read.", "title": "Bots Get", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load full agent_spec for edit or run. home=project | self | project_self — env_uuid only when home=project (sandbox overlay). owner=user for personal rows. Omit env for production read.", "write_mode": null}, {"action": "bots.create", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not treat echo brain_mode as AI success — set brain via bots.set_brain.", "anti_patterns": ["Do not treat echo brain_mode as AI success — set brain via bots.set_brain.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.create", "mutation_risk": "low", "related_tools": ["bots.attach_channel", "bots.set_brain", "bots.go_live"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be created under an open sandbox head without diff-child bootstrap (AA-10b). Fork generation env or clear head; then use scoped create overlay.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create a draft bot row (Telegram / WhatsApp / Instagram channel). Fleet shell on business head project_id; pass env_uuid on sandbox fleet steps after generation.fork. Use client_bot_key (tenant-assist"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.create", "mutation_risk": "low", "related_tools": ["bots.attach_channel", "bots.set_brain", "bots.go_live"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be created under an open sandbox head without diff-child bootstrap (AA-10b). Fork generation env or clear head; then use scoped create overlay.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create a draft bot row (Telegram / WhatsApp / Instagram channel). Fleet shell on business head project_id; pass env_uuid on sandbox fleet steps after generation.fork. Use client_bot_key (tenant-assist"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Create a draft bot row (Telegram / WhatsApp / Instagram channel). Fleet shell on business head proj…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bot": {"description": "Serialized fleet row after create", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "brain_mode": {"description": "Echo vs agent/logic/hybrid echo from request", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "transport_only": {"description": "True when brain_mode is echo", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.attach_channel", "bots.set_brain", "bots.go_live"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["bots.archive", "generation.realign_to_prod"], "safe_action": "bots_create", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a draft bot row (Telegram / WhatsApp / Instagram channel). Fleet shell on business head project_id; pass env_uuid on sandbox fleet steps after generation.fork. Use client_bot_key (tenant-assist", "title": "Bots Create", "verification": ["bots.get", "bots.list"], "verify": [{"action": "bots.get", "predicate": "named resource is visible"}, {"action": "bots.list", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be created under an open sandbox head without diff-child bootstrap (AA-10b). Fork generation env or clear head; then use scoped create overlay.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Create a draft bot row (Telegram / WhatsApp / Instagram channel). Fleet shell on business head project_id; pass env_uuid on sandbox fleet steps after generation.fork. Use client_bot_key (tenant-assist", "write_mode": null}, {"action": "bots.attach_channel", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.attach_channel", "mutation_risk": "low", "related_tools": ["bots.go_live", "bots.simulate", "bots.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Attach Channel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bind channel credentials after bots.create or wire_unity_telegram. When bots.health shows multiple Telegram channels, re-call attach on the live connection_uuid to prune dead rows before bots.go_live."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.attach_channel", "mutation_risk": "low", "related_tools": ["bots.go_live", "bots.simulate", "bots.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Attach Channel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bind channel credentials after bots.create or wire_unity_telegram. When bots.health shows multiple Telegram channels, re-call attach on the live connection_uuid to prune dead rows before bots.go_live."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Bind channel credentials after bots.create or wire_unity_telegram. When bots.health shows multiple …", "kind": "mcp_domain", "mutation_kind": "entity", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.go_live", "bots.simulate", "bots.health"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_attach_channel", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Attach a project messaging connection (telegram, max, whatsapp, …) to a bot fleet row. Idempotent: re-attach same connection_uuid prunes stale Telegram channels without tokens.", "title": "Bots Attach Channel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Bind channel credentials after bots.create or wire_unity_telegram. When bots.health shows multiple Telegram channels, re-call attach on the live connection_uuid to prune dead rows before bots.go_live.", "write_mode": null}, {"action": "bots.go_live", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.go_live", "mutation_risk": "low", "related_tools": ["bots.simulate", "bots.health", "bots.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Go Live", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Activate bot after channel attach + brain config."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.go_live", "mutation_risk": "low", "related_tools": ["bots.simulate", "bots.health", "bots.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Go Live", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Activate bot after channel attach + brain config."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Activate bot after channel attach + brain config.", "kind": "mcp_domain", "mutation_kind": "entity", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"activation": {"description": "Webhook registration result when activate_webhook", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "activation_error": {"description": "Non-fatal webhook error string when present", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "bot": {"description": "Fleet row after lifecycle=live", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.simulate", "bots.health", "bots.get"], "required_cap": "bots_admin", "requires_preflight": true, "risk_class": "production_publish", "rollback": ["bots.pause", "generation.realign_to_prod"], "safe_action": "bots_go_live", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Activate bot webhooks and set lifecycle live (Telegram / MAX / WhatsApp channels).", "title": "Bots Go Live", "verification": ["bots.health", "bots.get"], "verify": [{"action": "bots.health", "predicate": "named resource is visible"}, {"action": "bots.get", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Activate bot after channel attach + brain config.", "write_mode": null}, {"action": "bots.health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "bots_atoms": ["BOTS_INBOUND_MEDIA_ENV"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.health", "related_tools": ["bots.get", "bots.simulate", "bots.go_live", "bots.attach_channel"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Health", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Channel health and channel_capabilities (media, buttons, session_window_hours) before staff_reply, broadcast, or commerce_offer attachments. media=false channels still accept files via storage.upload "}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.health", "related_tools": ["bots.get", "bots.simulate", "bots.go_live", "bots.attach_channel"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Health", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Channel health and channel_capabilities (media, buttons, session_window_hours) before staff_reply, broadcast, or commerce_offer attachments. media=false channels still accept files via storage.upload "}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Channel health and channel_capabilities (media, buttons, session_window_hours) before staff_reply, …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.get", "bots.simulate", "bots.go_live", "bots.attach_channel"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_health", "semantic_input_mode": "inherit_workflow", "summary": "Channel health and channel_capabilities (media, buttons, session_window_hours) before staff_reply, broadcast, or commerce_offer attachments. media=false channels still accept files via storage.upload ", "title": "Bots Health", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Channel health and channel_capabilities (media, buttons, session_window_hours) before staff_reply, broadcast, or commerce_offer attachments. media=false channels still accept files via storage.upload", "write_mode": null}, {"action": "bots.reset_message_quota", "ai_tips": "Live bots ACK webhooks but never reply; health.quota.blocked is true. Action id is bots.reset_message_quota — there is no bots.reset_quota.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not call bots.reset_quota — the action id is bots.reset_message_quota.", "anti_patterns": ["Do not call bots.reset_quota — the action id is bots.reset_message_quota."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.reset_message_quota", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Reset Message Quota", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "insufficient_permissions": "bots_admin cap required for quota reset.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Live bots ACK webhooks but never reply; health.quota.blocked is true. Action id is bots.reset_message_quota — there is no bots.reset_quota."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.reset_message_quota", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Reset Message Quota", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "insufficient_permissions": "bots_admin cap required for quota reset.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Live bots ACK webhooks but never reply; health.quota.blocked is true. Action id is bots.reset_message_quota — there is no bots.reset_quota."}, "doc_audience": "operator", "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Live bots ACK webhooks but never reply; health.quota.blocked is true. Action id is bots.reset_messa…", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_reset_message_quota", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Zero project ``ecosystem.bot_usage`` and the NeuroCache hot counter for the current UTC month. Use when a poisoned cache mutes live Telegram.", "title": "Bots Reset Message Quota", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "insufficient_permissions": "bots_admin cap required for quota reset.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Live bots ACK webhooks but never reply; health.quota.blocked is true. Action id is bots.reset_message_quota — there is no bots.reset_quota.", "write_mode": null}, {"action": "bots.dlq_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.dlq_list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Dlq List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Operator session with bots read on project.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List bot queue DLQ items before replay. Queue plane is production runtime — not sandbox 8DNA slice; home/env_uuid on fleet DNA tools do not apply here."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.dlq_list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Dlq List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Operator session with bots read on project.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List bot queue DLQ items before replay. Queue plane is production runtime — not sandbox 8DNA slice; home/env_uuid on fleet DNA tools do not apply here."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "List bot queue DLQ items before replay. Queue plane is production runtime — not sandbox 8DNA slice;…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_dlq_list", "semantic_input_mode": "inherit_workflow", "summary": "List bot queue DLQ items before replay. Queue plane is production runtime — not sandbox 8DNA slice; home/env_uuid on fleet DNA tools do not apply here.", "title": "Bots Dlq List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Operator session with bots read on project.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List bot queue DLQ items before replay. Queue plane is production runtime — not sandbox 8DNA slice; home/env_uuid on fleet DNA tools do not apply here.", "write_mode": null}, {"action": "bots.dlq_replay", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.dlq_replay", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Dlq Replay", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "dlq_id or message_id required for replay.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Replay one DLQ item after fixing root cause."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.dlq_replay", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Dlq Replay", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "dlq_id or message_id required for replay.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Replay one DLQ item after fixing root cause."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Replay one DLQ item after fixing root cause.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_dlq_replay", "semantic_input_mode": "inherit_workflow", "summary": "Replay one DLQ item after fixing root cause.", "title": "Bots Dlq Replay", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "dlq_id or message_id required for replay.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Replay one DLQ item after fixing root cause.", "write_mode": null}, {"action": "bots.dlq_archive", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.dlq_archive", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Dlq Archive", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dlq_archive_failed": "DLQ archive rejected — inspect data payload from repository", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id or project_id", "reason_required": "Pass reason_contains (substring of last_error)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cancel DLQ rows whose last_error contains a substring (orchestrator_failed). Does not replay. Queue plane is production runtime."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.dlq_archive", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Dlq Archive", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dlq_archive_failed": "DLQ archive rejected — inspect data payload from repository", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id or project_id", "reason_required": "Pass reason_contains (substring of last_error)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cancel DLQ rows whose last_error contains a substring (orchestrator_failed). Does not replay. Queue plane is production runtime."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Cancel DLQ rows whose last_error contains a substring (orchestrator_failed). Does not replay. Queue…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_dlq_archive", "semantic_input_mode": "inherit_workflow", "summary": "Cancel DLQ rows by last_error substring. Does not replay them.", "title": "Bots Dlq Archive", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dlq_archive_failed": "DLQ archive rejected — inspect data payload from repository", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id or project_id", "reason_required": "Pass reason_contains (substring of last_error)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cancel DLQ rows whose last_error contains a substring (orchestrator_failed). Does not replay. Queue plane is production runtime.", "write_mode": null}, {"action": "bots.simulate", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not pack multiple bots.simulate in one sync execute.", "Do not treat echo brain_mode as production AI success.", "Do not expect command_matched for NL fabula download asks — mentor pipeline only.", "MCP transport success≠checklist pass — refused, awaiting_agent, ok:false need human read.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "bots_atoms": ["BOTS_SIMULATE_HEAVY", "BOTS_MENTOR_EPISODIC_SKIP", "BOTS_FABULA_NAV_QA", "BOTS_INBOUND_MEDIA_ENV", "BOTS_REPLY_MAILBOX", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "heavy_llm", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "heavy", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.simulate", "recovery_blocks": {"orchestrator_binding_stale": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "orchestrator_binding_stale"}}, "related_tools": ["bots.conversations", "bots.get", "bots.set_brain", "knowledge.playground"], "semantic_input_mode": "per_step_nl", "source": "handler", "title": "Bots Simulate", "when_blocked": {"agent_killed": "Restore agent lifecycle before simulate", "agent_not_found": "bots.set_brain + live agent row — MCP success≠checklist pass", "agents_killswitch": "Clear agents global killswitch (admin fleet) before simulate", "attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "awaiting_agent": "Poll agents run or use sync simulate — not a successful checklist turn", "batch_semantic_anchor_conflict": "Split MCP batch or align semantic anchor with preflight.check.", "bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "channel_kind_required": "Pass channel or attach_channel before simulate.", "channel_media_unsupported": "Channel cannot send attachment shape; check bots.health media caps.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "corpus_empty": "Ingest KB before mentor simulate — not an RBAC error", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "orchestrator_binding_stale": "Re-bind brain to current orchestrator agent_uuid", "personal_agent_run_denied": "Personal agent runs require owner principal — use operator session", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_file_not_found": "storage_file_id missing on disk — re-upload to bots__outbound.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run one bot turn (heavy_llm). Optional attachments[] simulate inbound user media (same envelope schema as provider turns). Outbound files for staff_reply/broadcast: storage.upload folder bots__out"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "heavy_llm", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "heavy", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.simulate", "recovery_blocks": {"orchestrator_binding_stale": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "orchestrator_binding_stale"}}, "related_tools": ["bots.conversations", "bots.get", "bots.set_brain", "knowledge.playground"], "semantic_input_mode": "per_step_nl", "source": "handler", "title": "Bots Simulate", "when_blocked": {"agent_killed": "Restore agent lifecycle before simulate", "agent_not_found": "bots.set_brain + live agent row — MCP success≠checklist pass", "agents_killswitch": "Clear agents global killswitch (admin fleet) before simulate", "attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "awaiting_agent": "Poll agents run or use sync simulate — not a successful checklist turn", "batch_semantic_anchor_conflict": "Split MCP batch or align semantic anchor with preflight.check.", "bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "channel_kind_required": "Pass channel or attach_channel before simulate.", "channel_media_unsupported": "Channel cannot send attachment shape; check bots.health media caps.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "corpus_empty": "Ingest KB before mentor simulate — not an RBAC error", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "orchestrator_binding_stale": "Re-bind brain to current orchestrator agent_uuid", "personal_agent_run_denied": "Personal agent runs require owner principal — use operator session", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_file_not_found": "storage_file_id missing on disk — re-upload to bots__outbound.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run one bot turn (heavy_llm). Optional attachments[] simulate inbound user media (same envelope schema as provider turns). Outbound files for staff_reply/broadcast: storage.upload folder bots__out"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "conditional_mutate": "action=capabilities | mode=capabilities = read-only probe (no LLM). REST ai_stream ~180s per call; one heavy_llm per sync MCP batch. RAG CPU runs off the event loop; LLM still holds the request. Prefer options.async=true + discovery.job_status when the host is busy.", "effect_depends_on_params": true, "execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "effect_kind": "read", "examples": [{"name": "Capabilities preflight (no LLM)", "request": {"params": {"action": "capabilities", "project_id": 1}, "tool": "bots.simulate"}, "response": {"data": {"mode": "capabilities"}, "success": true}}, {"name": "1444 free fabula named nav (helper bot)", "request": {"params": {"bot_id": "a1f4c56a-5d66-40e0-8de8-68cba1d520a6", "external_user_id": "fabula-baseline-a11", "principal_user_id": 1, "project_id": 1444, "text": "Где скачать Фабулу Любви к себе?"}, "tool": "bots.simulate"}, "response": {"data": {"reply": "…lesson/view?id=345047850#a11…", "synthesis_path": "registry_named_exact"}, "success": true}}], "execution_class": "heavy", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Dry-run one bot turn (heavy_llm). Optional attachments[] simulate inbound user media (same envelope…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": [{"action": "discovery.job_status", "note": "Poll until completed or failed; do not re-run simulate to check status.", "params": {"job_id": "<job_id from async execute receipt>"}}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent_output": {"description": "Structured agent output when present", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "awaiting_agent": {"description": "True when brain enqueued async agent run instead of inline reply", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "buttons": {"description": "Inline keyboard buttons when command/agreement plane matched", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "citations": {"description": "RAG citation snippets", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "command_matched": {"description": "Slash/command handler matched", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "correlation_id": {"description": "Trace correlation id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "detail": {"description": "Exception detail when simulate ok=false (operator/debug)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "error": {"description": "Error code or message when ok=false", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "exc_type": {"description": "Exception class name on simulate failure", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "model": {"description": "LLM model id used", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "ok": {"description": "Simulate succeeded", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "rag": {"description": "RAG debug blob", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "rag_refusal": {"description": "RAG abstain reason when applicable", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "rag_snippets": {"description": "Alias for citation list", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "refused": {"description": "Policy refusal flag", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "replied": {"description": "Bot produced outbound text", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "reply": {"description": "Primary reply text", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "safety": {"description": "Safety classifier outcome", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "safety_blocked": {"description": "True when safety refused send", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "skipped": {"description": "Non-error skip reason (e.g. album_part, duplicate)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "synthesis_path": {"description": "Plan/router branch (e.g. registry_named_exact for free fabula #aN nav)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "text": {"description": "Alias of reply", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "turn_trace": {"description": "Mentor turn trace blob when returned on simulate payload", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "bots.list projection=summary for fleet pick; bots.get for bot_spec. bots.simulate is one heavy LLM step per sync execute — use wait=false or options.async=true. Patch triggers with write_mode=merge; full menu publish uses replace.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.conversations", "bots.get", "bots.set_brain", "knowledge.playground"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_simulate", "semantic_input_mode": "per_step_nl", "summary": "Dry-run one bot brain turn without outbound. Heavy LLM: at most one per sync agentstack.execute (60s batch; 180s if this is the only heavy step). action=capabilities returns schema hints without LLM. ", "title": "Bots Simulate", "when_blocked": {"agent_killed": "Restore agent lifecycle before simulate", "agent_not_found": "bots.set_brain + live agent row — MCP success≠checklist pass", "agents_killswitch": "Clear agents global killswitch (admin fleet) before simulate", "attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "awaiting_agent": "Poll agents run or use sync simulate — not a successful checklist turn", "batch_semantic_anchor_conflict": "Split MCP batch or align semantic anchor with preflight.check.", "bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "channel_kind_required": "Pass channel or attach_channel before simulate.", "channel_media_unsupported": "Channel cannot send attachment shape; check bots.health media caps.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "corpus_empty": "Ingest KB before mentor simulate — not an RBAC error", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "orchestrator_binding_stale": "Re-bind brain to current orchestrator agent_uuid", "personal_agent_run_denied": "Personal agent runs require owner principal — use operator session", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_file_not_found": "storage_file_id missing on disk — re-upload to bots__outbound.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run one bot turn (heavy_llm). Optional attachments[] simulate inbound user media (same envelope schema as provider turns). Outbound files for staff_reply/broadcast: storage.upload folder bots__out", "write_mode": null}, {"action": "bots.conversations", "aliases": ["bots.conversations.messages"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["For agent mailboxes prefer bots.bus.inbox with handle= — clearer MCP intent.", "Do not read cross-agent pending without reply_for=<their slug> + reply_for_scope=history.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.conversations", "related_tools": ["bots.bus.inbox", "bots.bus.reply", "bots.bus.ask", "bots.bus.ack", "bots.bus.webhook.connect", "bots.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Conversations", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List bot threads for Studio inbox / handoff. reply_for=<agent_id|agentstack> is mailbox owner; reply_for_scope=pending (default) = unanswered inbound to owner; history = any thread that ever targeted "}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.conversations", "related_tools": ["bots.bus.inbox", "bots.bus.reply", "bots.bus.ask", "bots.bus.ack", "bots.bus.webhook.connect", "bots.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Conversations", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List bot threads for Studio inbox / handoff. reply_for=<agent_id|agentstack> is mailbox owner; reply_for_scope=pending (default) = unanswered inbound to owner; history = any thread that ever targeted "}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "List bot threads for Studio inbox / handoff. reply_for=<agent_id|agentstack> is mailbox owner; repl…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["Audit one thread: conversation_id=<cid> include_messages=true messages_limit=80", "Poll pending: reply_for=<your source_agent_id> reply_for_scope=pending — use bots.bus.inbox", "Cross-agent: reply_for=<other slug> reply_for_scope=history include_messages=true", "Download: GET .../bots/{bot_id}/media?storage_file_id= from attachment", "Agent MCP ladder: recipe mcp_bot_reply_mailbox_v1 · prompt agentstack_bot_message_bus"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.inbox", "bots.bus.reply", "bots.bus.ask", "bots.bus.ack", "bots.bus.webhook.connect", "bots.health"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_conversations", "semantic_input_mode": "inherit_workflow", "summary": "List bot conversations with handoff/needs_reply enrichment. include_messages returns the session turns the store already keeps (at most 200).", "title": "Bots Conversations", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List bot threads for Studio inbox / handoff. reply_for=<agent_id|agentstack> is mailbox owner; reply_for_scope=pending (default) = unanswered inbound to owner; history = any thread that ever targeted", "write_mode": null}, {"action": "bots.set_handoff", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.set_handoff", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Set Handoff", "when_blocked": {"bot_not_found": "bots.list / bots.get for a fleet bot_id on this project.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id — bots.conversations then retry.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_staff_user": "Operator session must carry user_id (reconnect MCP).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Toggle handoff_active for a conversation; pair with bots.conversations to pick conversation_id."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.set_handoff", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Set Handoff", "when_blocked": {"bot_not_found": "bots.list / bots.get for a fleet bot_id on this project.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id — bots.conversations then retry.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_staff_user": "Operator session must carry user_id (reconnect MCP).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Toggle handoff_active for a conversation; pair with bots.conversations to pick conversation_id."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Toggle handoff_active for a conversation; pair with bots.conversations to pick conversation_id.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_set_handoff", "semantic_input_mode": "inherit_workflow", "summary": "Toggle handoff_active for a conversation; pair with bots.conversations to pick conversation_id.", "title": "Bots Set Handoff", "when_blocked": {"bot_not_found": "bots.list / bots.get for a fleet bot_id on this project.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id — bots.conversations then retry.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_staff_user": "Operator session must carry user_id (reconnect MCP).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Toggle handoff_active for a conversation; pair with bots.conversations to pick conversation_id.", "write_mode": null}, {"action": "bots.staff_reply", "aliases": ["bots.bus.staff_reply", "bots.mailbox.reply"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not paste the file body into text — Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-upload to bots__outbound). MCP storage.upload does not take bytes. Do not paste the file body into text.", "anti_patterns": ["Do not paste the file body into text — Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scop", "Do not expect provider_message_id on MCP sync response — trust outbound_job_id; use bots.bus.inbox pending or worker/DLQ", "Use require_handoff: true only when handoff must be active; default require_handoff is false.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.staff_reply", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.set_handoff", "bots.conversations", "bots.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Staff Reply", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "comms_not_manager_live": "Outbound queued but order_routing_live is false — bots.order_manager_bootstrap apply with sandbox env_uuid.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "bots.bus.inbox / bots.conversations for a live conversation_id.", "empty_body": "Provide text and/or attachments[].", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Multi-handle key — pass source_agent_id from bots.bus.whoami.", "handoff_not_active": "set_handoff active=true first, or pass require_handoff=false.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "not_manager_live": "A successful staff_reply does not set order_routing_live. Manager config is bots.order_manager_bootstrap (dry_run then apply with env_uuid).", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass source_agent_id this key owns, or bind one handle via bots.bus.handle.set.", "source_agent_unbound": "bots.bus.handle.set with this key first.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-uploa"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.staff_reply", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.set_handoff", "bots.conversations", "bots.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Staff Reply", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "comms_not_manager_live": "Outbound queued but order_routing_live is false — bots.order_manager_bootstrap apply with sandbox env_uuid.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "bots.bus.inbox / bots.conversations for a live conversation_id.", "empty_body": "Provide text and/or attachments[].", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Multi-handle key — pass source_agent_id from bots.bus.whoami.", "handoff_not_active": "set_handoff active=true first, or pass require_handoff=false.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "not_manager_live": "A successful staff_reply does not set order_routing_live. Manager config is bots.order_manager_bootstrap (dry_run then apply with env_uuid).", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass source_agent_id this key owns, or bind one handle via bots.bus.handle.set.", "source_agent_unbound": "bots.bus.handle.set with this key first.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-uploa"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Logical agent sender with quote-reply", "request": {"params": {"bot_id": "<from bots.list>", "conversation_id": "<from bots.conversations>", "reply_to_provider_message_id": "<turn.provider_message_id>", "source_agent_id": "cursor-ops", "source_kind": "agent", "text": "Support: ticket closed — see summary below."}, "tool": "bots.staff_reply"}}], "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {k…", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["Success proof is outbound_job_id — do not hydrate bots.conversations for delivery", "Mailbox turns: bots.bus.inbox handle=<slug> reply_for_scope=pending", "bots.dlq_list when outbound worker fails"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["storage.upload", "bots.set_handoff", "bots.conversations", "bots.health"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_staff_reply", "semantic_input_mode": "inherit_workflow", "summary": "Enqueue staff/agent outbound to bots.outbound worker. MCP success is outbound_job_id only; use bots.conversations include_messages for provider_message_id and quote-reply index.", "title": "Bots Staff Reply", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "comms_not_manager_live": "Outbound queued but order_routing_live is false — bots.order_manager_bootstrap apply with sandbox env_uuid.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "bots.bus.inbox / bots.conversations for a live conversation_id.", "empty_body": "Provide text and/or attachments[].", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Multi-handle key — pass source_agent_id from bots.bus.whoami.", "handoff_not_active": "set_handoff active=true first, or pass require_handoff=false.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "not_manager_live": "A successful staff_reply does not set order_routing_live. Manager config is bots.order_manager_bootstrap (dry_run then apply with env_uuid).", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass source_agent_id this key owns, or bind one handle via bots.bus.handle.set.", "source_agent_unbound": "bots.bus.handle.set with this key first.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-uploa", "write_mode": null}, {"action": "bots.update", "ai_tips": "Always pass write_mode with commands. One /start object is merge, not replace. Studio Publish sends the full list with write_mode=replace. Empty commands=[] is blocked (commands_empty_blocked). A known phrase in reply_text: commands[].replacements [{find, replace}] (same editor as App Studio). agreement.replacements edits agreement.body. After bots.get, do not paste truncated reply_text or agreement.body — use allow_shrink only for a deliberate shorter string. See GET /mcp/actions write_modes and prompt agentstack_write_modes.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Sending commands: [{/start}] intending to edit welcome — that used to wipe the whole menu.", "anti_patterns": ["Sending commands: [{/start}] intending to edit welcome — that used to wipe the whole menu.", "Omitting write_mode on a full snapshot you meant as delete-missing (use write_mode=replace).", "Using path_updates and a partial commands list in the same call without write_mode.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "bots_atoms": ["BOTS_PATCH_SPEC"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.channel_identity.gen1"], "id": "bots.update", "mutation_risk": "low", "related_tools": ["bots.commands.upsert", "bots.get", "bots.ensure_mentor_commands"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Update", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "commands_empty_blocked": "Use write_mode=delete with explicit triggers, not an empty list", "content_shrink_blocked": "Truncated reply_text or agreement.body — use commands[].replacements or allow_shrink=true", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "unified_diff did not apply on a string leaf in path_updates.", "replacement_not_found": "Substring not in reply_text — bots.get and retry search_replace", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head. Scoped diff-child writes only under an open head.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "Unknown write_mode.", "write_mode_unsupported": "append/prepend are not valid for commands."}, "when_to_use": "Change bot name, brain, commands, or agreement. Patch identity.auth_modes (email one-time code and/or web_link site bind). Grant does not register users — /login in DM first. For one slash command pre"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.channel_identity.gen1"], "id": "bots.update", "mutation_risk": "low", "related_tools": ["bots.commands.upsert", "bots.get", "bots.ensure_mentor_commands"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Update", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "commands_empty_blocked": "Use write_mode=delete with explicit triggers, not an empty list", "content_shrink_blocked": "Truncated reply_text or agreement.body — use commands[].replacements or allow_shrink=true", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "unified_diff did not apply on a string leaf in path_updates.", "replacement_not_found": "Substring not in reply_text — bots.get and retry search_replace", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head. Scoped diff-child writes only under an open head.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "Unknown write_mode.", "write_mode_unsupported": "append/prepend are not valid for commands."}, "when_to_use": "Change bot name, brain, commands, or agreement. Patch identity.auth_modes (email one-time code and/or web_link site bind). Grant does not register users — /login in DM first. For one slash command pre"}, "collection_key": "trigger", "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Change bot name, brain, commands, or agreement. Patch identity.auth_modes (email one-time code and/…", "kind": "mcp_domain", "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "bots.list projection=summary for fleet pick; bots.get for bot_spec. bots.simulate is one heavy LLM step per sync execute — use wait=false or options.async=true. Patch triggers with write_mode=merge; full menu publish uses replace.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.commands.upsert", "bots.get", "bots.ensure_mentor_commands"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_update", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Partial bot_spec update (commands, brain, name, …) — same as REST PUT. commands is a keyed list: pass write_mode (merge|replace|delete). A short commands array without write_mode merges by trigger and", "title": "Bots Update", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "commands_empty_blocked": "Use write_mode=delete with explicit triggers, not an empty list", "content_shrink_blocked": "Truncated reply_text or agreement.body — use commands[].replacements or allow_shrink=true", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "unified_diff did not apply on a string leaf in path_updates.", "replacement_not_found": "Substring not in reply_text — bots.get and retry search_replace", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head. Scoped diff-child writes only under an open head.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "Unknown write_mode.", "write_mode_unsupported": "append/prepend are not valid for commands."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Change bot name, brain, commands, or agreement. Patch identity.auth_modes (email one-time code and/or web_link site bind). Grant does not register users — /login in DM first. For one slash command pre", "write_mode": ["merge", "patch", "upsert", "replace", "write", "delete"], "write_mode_note": "Pass write_mode with commands. Prefer bots.commands.upsert for one command."}, {"action": "bots.commands.upsert", "ai_tips": "Pass commands as an array of full command objects (trigger + reply_text + buttons). Existing commands with other triggers stay. To remove a command use bots.update write_mode=delete with those triggers.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Using bots.update with a 1-item commands array (legacy wipe).", "anti_patterns": ["Using bots.update with a 1-item commands array (legacy wipe).", "Sending an empty commands list.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "bots_atoms": ["BOTS_PATCH_SPEC"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.commands.upsert", "mutation_risk": "low", "related_tools": ["bots.update", "bots.get", "bots.ensure_mentor_commands"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Commands Upsert", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "commands_empty_blocked": "Refusing to wipe the menu.", "commands_required": "commands must be a non-empty array.", "content_shrink_blocked": "Pass allow_shrink=true only after a deliberate shorter reply", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "replacement_not_found": "replacements.find missing from that command reply_text", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head. Scoped diff-child writes only under an open head.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Edit or add slash commands without sending the full menu snapshot. Bind generation_env_uuid (or rely on MCP sandbox head). Post-mutate: three sync executes: generation.diff_vs_prod → generation.gates "}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.commands.upsert", "mutation_risk": "low", "related_tools": ["bots.update", "bots.get", "bots.ensure_mentor_commands"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Commands Upsert", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "commands_empty_blocked": "Refusing to wipe the menu.", "commands_required": "commands must be a non-empty array.", "content_shrink_blocked": "Pass allow_shrink=true only after a deliberate shorter reply", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "replacement_not_found": "replacements.find missing from that command reply_text", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head. Scoped diff-child writes only under an open head.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Edit or add slash commands without sending the full menu snapshot. Bind generation_env_uuid (or rely on MCP sandbox head). Post-mutate: three sync executes: generation.diff_vs_prod → generation.gates "}, "collection_key": "trigger", "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Edit or add slash commands without sending the full menu snapshot. Bind generation_env_uuid (or rel…", "kind": "mcp_domain", "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "bots.list projection=summary for fleet pick; bots.get for bot_spec. bots.simulate is one heavy LLM step per sync execute — use wait=false or options.async=true. Patch triggers with write_mode=merge; full menu publish uses replace.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.update", "bots.get", "bots.ensure_mentor_commands"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_commands_upsert", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Merge one or more bot commands by trigger. Never replaces the command list. Use this instead of bots.update when editing /start, /help, or a single handler.", "title": "Bots Commands Upsert", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "commands_empty_blocked": "Refusing to wipe the menu.", "commands_required": "commands must be a non-empty array.", "content_shrink_blocked": "Pass allow_shrink=true only after a deliberate shorter reply", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "replacement_not_found": "replacements.find missing from that command reply_text", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head. Scoped diff-child writes only under an open head.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Edit or add slash commands without sending the full menu snapshot. Bind generation_env_uuid (or rely on MCP sandbox head). Post-mutate: three sync executes: generation.diff_vs_prod → generation.gates", "write_mode": null, "write_mode_note": "Always merge-by-trigger; never replaces the menu."}, {"action": "bots.ensure_mentor_commands", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Running unity_apply_mentor_copy_1444.py when MCP heal is available.", "anti_patterns": ["Running unity_apply_mentor_copy_1444.py when MCP heal is available.", "Healing only one channel bot when fleet has TG + MAX mentors.", "Skipping generation.promote after sandbox mutations.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.ensure_mentor_commands", "mutation_risk": "low", "related_tools": ["bots.get", "bots.commands.upsert", "bots.update", "generation.diff_vs_prod", "generation.promote", "knowledge.playground"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Ensure Mentor Commands", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Tenant mentor menu drift, missing /start nav buttons, or post-deploy TG/MAX parity fail. Prefer over local ops scripts when MCP is available. UF_BOTS_HEAL / mcp_tenant_bots_heal_verify: idempotent men"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.ensure_mentor_commands", "mutation_risk": "low", "related_tools": ["bots.get", "bots.commands.upsert", "bots.update", "generation.diff_vs_prod", "generation.promote", "knowledge.playground"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Ensure Mentor Commands", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Tenant mentor menu drift, missing /start nav buttons, or post-deploy TG/MAX parity fail. Prefer over local ops scripts when MCP is available. UF_BOTS_HEAL / mcp_tenant_bots_heal_verify: idempotent men"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Tenant mentor menu drift, missing /start nav buttons, or post-deploy TG/MAX parity fail. Prefer ove…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.get", "bots.commands.upsert", "bots.update", "generation.diff_vs_prod", "generation.promote", "knowledge.playground"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_ensure_mentor_commands", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Heal mentor /start+/menu+/operator commands + inline buttons (idempotent).", "title": "Bots Ensure Mentor Commands", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Tenant mentor menu drift, missing /start nav buttons, or post-deploy TG/MAX parity fail. Prefer over local ops scripts when MCP is available. UF_BOTS_HEAL / mcp_tenant_bots_heal_verify: idempotent men", "write_mode": null}, {"action": "bots.pause", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.pause", "mutation_risk": "low", "related_tools": ["bots.go_live", "bots.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Pause", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pause bot and optionally deactivate webhook."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.pause", "mutation_risk": "low", "related_tools": ["bots.go_live", "bots.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Pause", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pause bot and optionally deactivate webhook."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Pause bot and optionally deactivate webhook.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.go_live", "bots.get"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_pause", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Pause bot and optionally deactivate webhook.", "title": "Bots Pause", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Pause bot and optionally deactivate webhook.", "write_mode": null}, {"action": "bots.archive", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.archive", "mutation_risk": "low", "related_tools": ["bots.get", "bots.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Archive", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be deleted/archived under an open sandbox head. Use diff-child tombstone (AA-11b) or clear generation env.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Archive a bot after go-live rollback or cleanup."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.archive", "mutation_risk": "low", "related_tools": ["bots.get", "bots.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Archive", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be deleted/archived under an open sandbox head. Use diff-child tombstone (AA-11b) or clear generation env.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Archive a bot after go-live rollback or cleanup."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Archive a bot after go-live rollback or cleanup.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.get", "bots.list"], "required_cap": "bots_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "bots_archive", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Archive a bot after go-live rollback or cleanup.", "title": "Bots Archive", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be deleted/archived under an open sandbox head. Use diff-child tombstone (AA-11b) or clear generation env.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Archive a bot after go-live rollback or cleanup.", "write_mode": null}, {"action": "bots.set_brain", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.set_brain", "mutation_risk": "low", "related_tools": ["bots.get", "bots.simulate", "bots.go_live"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Set Brain", "when_blocked": {"content_shrink_blocked": "Use replacements or allow_shrink for a shorter fallback line", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "mode_required": "mode is required.", "replacement_not_found": "find string not in stored fallback_text", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Wire Fleet agent or knowledge brain to the bot. Change one phrase in fallback_text with replacements, not a full paste."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.set_brain", "mutation_risk": "low", "related_tools": ["bots.get", "bots.simulate", "bots.go_live"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Set Brain", "when_blocked": {"content_shrink_blocked": "Use replacements or allow_shrink for a shorter fallback line", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "mode_required": "mode is required.", "replacement_not_found": "find string not in stored fallback_text", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Wire Fleet agent or knowledge brain to the bot. Change one phrase in fallback_text with replacements, not a full paste."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Wire Fleet agent or knowledge brain to the bot. Change one phrase in fallback_text with replacement…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bot": {"description": "Fleet row after brain binding update", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.get", "bots.simulate", "bots.go_live"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["bots.update", "generation.realign_to_prod"], "safe_action": "bots_set_brain", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Wire Fleet agent or knowledge brain to the bot. Change one phrase in fallback_text with replacements, not a full paste.", "title": "Bots Set Brain", "verification": ["bots.get", "bots.simulate"], "verify": [{"action": "bots.get", "predicate": "named resource is visible"}, {"action": "bots.simulate", "predicate": "named resource is visible"}], "when_blocked": {"content_shrink_blocked": "Use replacements or allow_shrink for a shorter fallback line", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "mode_required": "mode is required.", "replacement_not_found": "find string not in stored fallback_text", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Wire Fleet agent or knowledge brain to the bot. Change one phrase in fallback_text with replacements, not a full paste.", "write_mode": null}, {"action": "bots.broadcast", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not inline media bytes; same attachments envelope as bots.staff_reply.", "anti_patterns": ["Do not inline media bytes; same attachments envelope as bots.staff_reply.", "Do not assume all subscribers — dry_run may show inbox_truncated at max_recipients.", "Do not sync_fanout large lists — use default async fanout_job_id (>50 recipients).", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.broadcast", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.list", "bots.health", "bots.broadcast_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Broadcast", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_active": "Bot must be live or ready — bots.go_live or bots.pause off.", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id for this bot.", "empty_body": "Provide text and/or attachments[] after storage.upload.", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handoff_not_active": "Enable handoff or pass clear_handoff with staff reply.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Filtered mass outbound; same attachment envelope as bots.staff_reply (storage.upload → attachments[], no inline bytes; .md and archives as document). SMS and other no-media channels deliver files as l"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.broadcast", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.list", "bots.health", "bots.broadcast_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Broadcast", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_active": "Bot must be live or ready — bots.go_live or bots.pause off.", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id for this bot.", "empty_body": "Provide text and/or attachments[] after storage.upload.", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handoff_not_active": "Enable handoff or pass clear_handoff with staff reply.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Filtered mass outbound; same attachment envelope as bots.staff_reply (storage.upload → attachments[], no inline bytes; .md and archives as document). SMS and other no-media channels deliver files as l"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Filtered mass outbound; same attachment envelope as bots.staff_reply (storage.upload → attachments[…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["storage.upload", "bots.list", "bots.health", "bots.broadcast_status"], "required_cap": "bots_admin", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "bots_broadcast", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Filtered mass outbound; same attachment envelope as bots.staff_reply (storage.upload → attachments[], no inline bytes; .md and archives as document). SMS and other no-media channels deliver files as l", "title": "Bots Broadcast", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_active": "Bot must be live or ready — bots.go_live or bots.pause off.", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id for this bot.", "empty_body": "Provide text and/or attachments[] after storage.upload.", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handoff_not_active": "Enable handoff or pass clear_handoff with staff reply.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Filtered mass outbound; same attachment envelope as bots.staff_reply (storage.upload → attachments[], no inline bytes; .md and archives as document). SMS and other no-media channels deliver files as l", "write_mode": null}, {"action": "bots.broadcast_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Read-only — does not enqueue sends or mutate 8DNA.", "Prefer fanout_job_id from bots.broadcast async response; plan_key alone works when job id expired.", "Default include_queues=false — pass include_queues=true only for SLO depth + dlq_count."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": true, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.broadcast_status", "related_tools": ["bots.broadcast", "bots.health", "bots.dlq_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Broadcast Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "fanout_job_id_or_plan_key_required": "Pass fanout_job_id from bots.broadcast async response or plan_key from the same payload.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only async broadcast progress after bots.broadcast returns fanout_job_id or plan_key. Surfaces coordinator job status, recipient_index vs plan_storage_ok recipient_total, and optional execute/out"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": true, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.broadcast_status", "related_tools": ["bots.broadcast", "bots.health", "bots.dlq_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Broadcast Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "fanout_job_id_or_plan_key_required": "Pass fanout_job_id from bots.broadcast async response or plan_key from the same payload.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only async broadcast progress after bots.broadcast returns fanout_job_id or plan_key. Surfaces coordinator job status, recipient_index vs plan_storage_ok recipient_total, and optional execute/out"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Read-only async broadcast progress after bots.broadcast returns fanout_job_id or plan_key. Surfaces…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.broadcast", "bots.health", "bots.dlq_list"], "required_cap": "bots_run", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "bots_broadcast_status", "semantic_input_mode": "inherit_workflow", "summary": "Read-only async broadcast progress after bots.broadcast returns fanout_job_id or plan_key. Surfaces coordinator job status, recipient_index vs plan_storage_ok recipient_total, and optional execute/out", "title": "Bots Broadcast Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "fanout_job_id_or_plan_key_required": "Pass fanout_job_id from bots.broadcast async response or plan_key from the same payload.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only async broadcast progress after bots.broadcast returns fanout_job_id or plan_key. Surfaces coordinator job status, recipient_index vs plan_storage_ok recipient_total, and optional execute/out", "write_mode": null}, {"action": "bots.send_commerce_offer", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Passing env_uuid when home is project_self or self.", "anti_patterns": ["Passing env_uuid when home is project_self or self.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.send_commerce_offer", "related_tools": ["bots.conversations", "bots.health", "bots.staff_reply", "storage.upload"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Send Commerce Offer", "when_blocked": {"bot_not_found": "Unknown bot_id — bots.list then retry.", "channel_not_found": "Channel binding missing on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id — bots.conversations.", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "listing_not_found": "Unknown listing_uuid — commerce catalog or bots.health shop linkage.", "no_channel": "Bot channel not resolved for this thread.", "offer_send_failed": "Offer delivery failed — verify listing_uuid, channel binding, and conversation_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enqueue marketplace listing card (listing_uuid, bot_id, conversation_id). Sync MCP errors: listing_not_found, bot_not_found, conversation_not_found, no_channel. Thumbnail delivery is async on outbound"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.send_commerce_offer", "related_tools": ["bots.conversations", "bots.health", "bots.staff_reply", "storage.upload"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Send Commerce Offer", "when_blocked": {"bot_not_found": "Unknown bot_id — bots.list then retry.", "channel_not_found": "Channel binding missing on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id — bots.conversations.", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "listing_not_found": "Unknown listing_uuid — commerce catalog or bots.health shop linkage.", "no_channel": "Bot channel not resolved for this thread.", "offer_send_failed": "Offer delivery failed — verify listing_uuid, channel binding, and conversation_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enqueue marketplace listing card (listing_uuid, bot_id, conversation_id). Sync MCP errors: listing_not_found, bot_not_found, conversation_not_found, no_channel. Thumbnail delivery is async on outbound"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Enqueue marketplace listing card (listing_uuid, bot_id, conversation_id). Sync MCP errors: listing_…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.conversations", "bots.health", "bots.staff_reply", "storage.upload"], "required_cap": "bots_run", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "bots_send_commerce_offer", "semantic_input_mode": "inherit_workflow", "summary": "Send a commerce offer card to a bot conversation (listing UUID → outbound attachment).", "title": "Bots Send Commerce Offer", "when_blocked": {"bot_not_found": "Unknown bot_id — bots.list then retry.", "channel_not_found": "Channel binding missing on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id — bots.conversations.", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "listing_not_found": "Unknown listing_uuid — commerce catalog or bots.health shop linkage.", "no_channel": "Bot channel not resolved for this thread.", "offer_send_failed": "Offer delivery failed — verify listing_uuid, channel binding, and conversation_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enqueue marketplace listing card (listing_uuid, bot_id, conversation_id). Sync MCP errors: listing_not_found, bot_not_found, conversation_not_found, no_channel. Thumbnail delivery is async on outbound", "write_mode": null}, {"action": "bots.bus.handle.list", "aliases": ["bots.bus.handle.list_handles"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.handle.list", "related_tools": ["bots.bus.handle.set", "bots.bus.handle.release", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Handle List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read config.message_bus.handles for the project slice (env_uuid on sandbox)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.handle.list", "related_tools": ["bots.bus.handle.set", "bots.bus.handle.release", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Handle List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read config.message_bus.handles for the project slice (env_uuid on sandbox)."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Read config.message_bus.handles for the project slice (env_uuid on sandbox).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.handle.set", "bots.bus.handle.release", "bots.bus.inbox"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_handle_list", "semantic_input_mode": "inherit_workflow", "summary": "List message-bus handles (config.message_bus.handles).", "title": "Bots Bus Handle List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read config.message_bus.handles for the project slice (env_uuid on sandbox).", "write_mode": null}, {"action": "bots.bus.whoami", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.whoami", "related_tools": ["bots.bus.handle.list", "bots.bus.handle.set", "bots.bus.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Whoami", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "null bound_handle + non-empty allowed_source_agents = multi-handle; pass source_agent_id (do not treat as unbound).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_unbound": "Empty allowed_source_agents — bots.bus.handle.set first.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Introspect which @handles this MCP credential may speak as (allowed_source_agents, bound_handle). bound_handle is set only when exactly one handle is allowed; null + non-empty allowed means multi-hand"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.whoami", "related_tools": ["bots.bus.handle.list", "bots.bus.handle.set", "bots.bus.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Whoami", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "null bound_handle + non-empty allowed_source_agents = multi-handle; pass source_agent_id (do not treat as unbound).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_unbound": "Empty allowed_source_agents — bots.bus.handle.set first.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Introspect which @handles this MCP credential may speak as (allowed_source_agents, bound_handle). bound_handle is set only when exactly one handle is allowed; null + non-empty allowed means multi-hand"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Which handle this key may speak as", "request": {"params": {"project_id": 1}, "tool": "bots.bus.whoami"}}], "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Introspect which @handles this MCP credential may speak as (allowed_source_agents, bound_handle). b…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["If bound_handle is null and allowed_source_agents is empty: bots.bus.handle.set", "If bound_handle is null and allowed_source_agents has entries: multi-handle — pass source_agent_id (not unbound)", "If handle_required on send: pass source_agent_id from allowed_source_agents", "Then bots.bus.inbox handle=<chosen> reply_for_scope=pending", "Budget-cheap ≠ wall-clock cheap under sticky sandbox — omit env_uuid for prod reads"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.handle.list", "bots.bus.handle.set", "bots.bus.deliver"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_whoami", "semantic_input_mode": "inherit_workflow", "summary": "Introspect message-bus handle ownership for the active MCP credential.", "title": "Bots Bus Whoami", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "null bound_handle + non-empty allowed_source_agents = multi-handle; pass source_agent_id (do not treat as unbound).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_unbound": "Empty allowed_source_agents — bots.bus.handle.set first.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Introspect which @handles this MCP credential may speak as (allowed_source_agents, bound_handle). bound_handle is set only when exactly one handle is allowed; null + non-empty allowed means multi-hand", "write_mode": null}, {"action": "bots.bus.handle.set", "aliases": ["bots.bus.handle.register"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["This call binds the handle to the current API key or session. Another key cannot speak as it.", "Calling set again adds another handle on this key. Then pass source_agent_id.", "Not a second Telegram bot — a logical sender on the project's live channel bot."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.handle.set", "mutation_risk": "low", "related_tools": ["bots.bus.handle.list", "bots.bus.handle.release", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Handle Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_charset": "Use lowercase alphanumeric + hyphen/underscore.", "handle_failed": "DNA write failed — check env_uuid / generation sandbox.", "handle_length": "Handle slug length out of allowed range", "handle_reserved": "Slug reserved — choose another.", "handle_taken": "Another key owns this handle — pick a new slug.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rate_limited": "Too many handle updates — retry after cooldown.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "signature_position_invalid": "Use prefix, suffix, or off.", "source_agent_unbound": "No API key or session on this call — cannot bind a handle.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Register @handle on config.message_bus.handles and bind it to this API key or session. The same key may own multiple handles (AgentGrok + AgentStackDev on one scoped key). Pass source_agent_id on send"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.handle.set", "mutation_risk": "low", "related_tools": ["bots.bus.handle.list", "bots.bus.handle.release", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Handle Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_charset": "Use lowercase alphanumeric + hyphen/underscore.", "handle_failed": "DNA write failed — check env_uuid / generation sandbox.", "handle_length": "Handle slug length out of allowed range", "handle_reserved": "Slug reserved — choose another.", "handle_taken": "Another key owns this handle — pick a new slug.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rate_limited": "Too many handle updates — retry after cooldown.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "signature_position_invalid": "Use prefix, suffix, or off.", "source_agent_unbound": "No API key or session on this call — cannot bind a handle.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Register @handle on config.message_bus.handles and bind it to this API key or session. The same key may own multiple handles (AgentGrok + AgentStackDev on one scoped key). Pass source_agent_id on send"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Register @handle on config.message_bus.handles and bind it to this API key or session. The same key…", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["bots.bus.handle.list — verify row", "bots.bus.inbox handle=<slug> reply_for_scope=pending", "Optional: bots.bus.webhook.connect for push wake"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.handle.list", "bots.bus.handle.release", "bots.bus.inbox"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_handle_set", "semantic_input_mode": "inherit_workflow", "summary": "Register or replace your logical @handle for mailbox routing.", "title": "Bots Bus Handle Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_charset": "Use lowercase alphanumeric + hyphen/underscore.", "handle_failed": "DNA write failed — check env_uuid / generation sandbox.", "handle_length": "Handle slug length out of allowed range", "handle_reserved": "Slug reserved — choose another.", "handle_taken": "Another key owns this handle — pick a new slug.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rate_limited": "Too many handle updates — retry after cooldown.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "signature_position_invalid": "Use prefix, suffix, or off.", "source_agent_unbound": "No API key or session on this call — cannot bind a handle.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Register @handle on config.message_bus.handles and bind it to this API key or session. The same key may own multiple handles (AgentGrok + AgentStackDev on one scoped key). Pass source_agent_id on send", "write_mode": null}, {"action": "bots.bus.handle.release", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.handle.release", "mutation_risk": "low", "related_tools": ["bots.bus.handle.set", "bots.bus.handle.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Handle Release", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_not_found": "No handle registered for this slug", "handle_not_owned": "Release only your handle row for this principal", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drop your handle row; does not delete conversation history."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.handle.release", "mutation_risk": "low", "related_tools": ["bots.bus.handle.set", "bots.bus.handle.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Handle Release", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_not_found": "No handle registered for this slug", "handle_not_owned": "Release only your handle row for this principal", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drop your handle row; does not delete conversation history."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Drop your handle row; does not delete conversation history.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.handle.set", "bots.bus.handle.list"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_handle_release", "semantic_input_mode": "inherit_workflow", "summary": "Release your @handle from config.message_bus.handles.", "title": "Bots Bus Handle Release", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_not_found": "No handle registered for this slug", "handle_not_owned": "Release only your handle row for this principal", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drop your handle row; does not delete conversation history.", "write_mode": null}, {"action": "bots.bus.inbox", "aliases": ["bots.bus.get", "bots.bus.get_message", "bots.bus.list", "bots.bus.message.get", "bots.bus.poll", "bots.bus.thread", "bots.inbox", "bots.mailbox.inbox", "bots.mailbox.list", "bots.mailbox.poll"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not use messaging.mailbox.* — this is the bot message bus.", "anti_patterns": ["Do not use messaging.mailbox.* — this is the bot message bus.", "Poll handle=<your bound slug>. Pending is unacked inbound for that mailbox.", "A webhook is only a wake. After POST bus.message.inbound, call bots.bus.inbox."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.inbox", "related_tools": ["bots.bus.reply", "bots.bus.ask", "bots.bus.ack", "bots.bus.deliver", "bots.conversations"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Inbox", "when_blocked": {"bot_not_found": "bots.list under the owning project_id, then retry inbox.", "bot_not_in_project": "bot_id is not on context.project_id — platform AgentBus lives on project_id=1.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Multi-handle key — pass handle from bots.bus.handle.list.", "internal_error": "Unexpected inbox shape — redeploy tools_bots; expect MCPResponse with conversations[].", "invalid_parameters": "Set context.project_id (or project_id param).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestrator_bot_unbound": "Bind orchestrator on message_bus or pass bot_id from bots.list (platform AgentBus: project_id=1).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass a handle this key owns, or omit source_agent_id.", "source_agent_unbound": "bots.bus.handle.set with this key first.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll one agent mailbox: handle or source_agent_id maps to reply_for. reply_for_scope=pending + include_messages=true returns only unacked inbound turns for that handle (not the full transcript). Ack w"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.inbox", "related_tools": ["bots.bus.reply", "bots.bus.ask", "bots.bus.ack", "bots.bus.deliver", "bots.conversations"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Inbox", "when_blocked": {"bot_not_found": "bots.list under the owning project_id, then retry inbox.", "bot_not_in_project": "bot_id is not on context.project_id — platform AgentBus lives on project_id=1.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Multi-handle key — pass handle from bots.bus.handle.list.", "internal_error": "Unexpected inbox shape — redeploy tools_bots; expect MCPResponse with conversations[].", "invalid_parameters": "Set context.project_id (or project_id param).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestrator_bot_unbound": "Bind orchestrator on message_bus or pass bot_id from bots.list (platform AgentBus: project_id=1).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass a handle this key owns, or omit source_agent_id.", "source_agent_unbound": "bots.bus.handle.set with this key first.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll one agent mailbox: handle or source_agent_id maps to reply_for. reply_for_scope=pending + include_messages=true returns only unacked inbound turns for that handle (not the full transcript). Ack w"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Pending mailbox poll", "request": {"params": {"bot_id": "<from bots.list>", "handle": "<your bound handle>", "messages_limit": 10, "reply_for_scope": "pending"}, "tool": "bots.bus.inbox"}}], "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Poll one agent mailbox: handle or source_agent_id maps to reply_for. reply_for_scope=pending + incl…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["Reply on the channel: bots.bus.reply (server stamps your handle)", "Ask the person in this thread: bots.bus.ask (same buttons as question on reply)", "Hand a note or work-graph task to another agent: bots.bus.deliver to_handle=<them>", "Read-only: bots.bus.ack message_id or provider_message_id", "Push wake: bots.bus.webhook.connect + recipe mcp_bot_message_bus_webhook_v1"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.reply", "bots.bus.ask", "bots.bus.ack", "bots.bus.deliver", "bots.conversations"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_inbox", "semantic_input_mode": "inherit_workflow", "summary": "Alias: bots.conversations with reply_for (mailbox pull). With reply_for_scope=pending and include_messages=true, returns only unacked inbound turns for that handle — not the full session transcript.", "title": "Bots Bus Inbox", "when_blocked": {"bot_not_found": "bots.list under the owning project_id, then retry inbox.", "bot_not_in_project": "bot_id is not on context.project_id — platform AgentBus lives on project_id=1.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Multi-handle key — pass handle from bots.bus.handle.list.", "internal_error": "Unexpected inbox shape — redeploy tools_bots; expect MCPResponse with conversations[].", "invalid_parameters": "Set context.project_id (or project_id param).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestrator_bot_unbound": "Bind orchestrator on message_bus or pass bot_id from bots.list (platform AgentBus: project_id=1).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass a handle this key owns, or omit source_agent_id.", "source_agent_unbound": "bots.bus.handle.set with this key first.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll one agent mailbox: handle or source_agent_id maps to reply_for. reply_for_scope=pending + include_messages=true returns only unacked inbound turns for that handle (not the full transcript). Ack w", "write_mode": null}, {"action": "bots.bus.inbox_counts", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.inbox_counts", "related_tools": ["bots.bus.inbox", "bots.conversations"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Inbox Counts", "when_blocked": {"bot_not_found": "bots.list under the owning project_id, then retry inbox_counts.", "bot_not_in_project": "Explicit bot_id missing on project slice — list bots for context.project_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "Set context.project_id (or project_id param).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestrator_bot_unbound": "Bind orchestrator on message_bus or pass bot_id from bots.list (platform AgentBus: project_id=1).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Full inbox index counts for Bot Studio tab badges — not capped by conversations list limit. Use instead of bots.conversations limit=30 when summarizing handoff/needs_reply/agent_mailbox."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.inbox_counts", "related_tools": ["bots.bus.inbox", "bots.conversations"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Inbox Counts", "when_blocked": {"bot_not_found": "bots.list under the owning project_id, then retry inbox_counts.", "bot_not_in_project": "Explicit bot_id missing on project slice — list bots for context.project_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "Set context.project_id (or project_id param).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestrator_bot_unbound": "Bind orchestrator on message_bus or pass bot_id from bots.list (platform AgentBus: project_id=1).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Full inbox index counts for Bot Studio tab badges — not capped by conversations list limit. Use instead of bots.conversations limit=30 when summarizing handoff/needs_reply/agent_mailbox."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Full inbox index counts for Bot Studio tab badges — not capped by conversations list limit. Use ins…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.inbox", "bots.conversations"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_inbox_counts", "semantic_input_mode": "inherit_workflow", "summary": "Full inbox index counts for tab badges (handoff, needs_reply, agent_mailbox, …).", "title": "Bots Bus Inbox Counts", "when_blocked": {"bot_not_found": "bots.list under the owning project_id, then retry inbox_counts.", "bot_not_in_project": "Explicit bot_id missing on project slice — list bots for context.project_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "Set context.project_id (or project_id param).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestrator_bot_unbound": "Bind orchestrator on message_bus or pass bot_id from bots.list (platform AgentBus: project_id=1).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Full inbox index counts for Bot Studio tab badges — not capped by conversations list limit. Use instead of bots.conversations limit=30 when summarizing handoff/needs_reply/agent_mailbox.", "write_mode": null}, {"action": "bots.bus.ack", "aliases": ["bots.mailbox.ack"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Ack only mail addressed to your handle. ack_forbidden means it is someone else's mailbox.", "anti_patterns": ["Ack only mail addressed to your handle. ack_forbidden means it is someone else's mailbox.", "Do not batch-ack turns for @cursor-ops when bound as AgentStackSharp/AgentGrok — use bots.bus.deliver instead.", "Prefer provider_message_id from the channel; message_id is the turn id or hlc."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.ack", "mutation_risk": "low", "related_tools": ["bots.bus.inbox", "bots.bus.reply", "bots.bus.ask", "bots.bus.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Ack", "when_blocked": {"ack_forbidden": "Mailbox reply_target not owned by this key — bots.bus.whoami.", "bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "bot_not_in_project": "bot_id not on context.project_id — AgentBus platform bot needs project_id=1.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_id_required": "Poll bots.bus.inbox first — copy conversation_id and provider_message_id, then bots.bus.ack (bot_id optional on pid=1).", "conversation_not_found": "Wrong conversation_id — bots.bus.inbox then retry.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "This key owns more than one handle. Pass handle from bots.bus.handle.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "message_id_required": "Pass message_id or provider_message_id.", "message_not_found": "Turn stale — use provider_message_id from inbox (conversation ok).", "orchestrator_bot_unbound": "Bind orchestrator on message_bus or pass bot_id from bots.list (platform AgentBus: project_id=1).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass a handle this key owns, or omit source_agent_id.", "source_agent_unbound": "bots.bus.handle.set with this key first.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark inbound turn read without outbound text. Prefer provider_message_id (Telegram message id, including the quoted keyboard message of a button tap). message_id must match bots.bus.inbox / webhook tu"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.ack", "mutation_risk": "low", "related_tools": ["bots.bus.inbox", "bots.bus.reply", "bots.bus.ask", "bots.bus.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Ack", "when_blocked": {"ack_forbidden": "Mailbox reply_target not owned by this key — bots.bus.whoami.", "bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "bot_not_in_project": "bot_id not on context.project_id — AgentBus platform bot needs project_id=1.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_id_required": "Poll bots.bus.inbox first — copy conversation_id and provider_message_id, then bots.bus.ack (bot_id optional on pid=1).", "conversation_not_found": "Wrong conversation_id — bots.bus.inbox then retry.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "This key owns more than one handle. Pass handle from bots.bus.handle.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "message_id_required": "Pass message_id or provider_message_id.", "message_not_found": "Turn stale — use provider_message_id from inbox (conversation ok).", "orchestrator_bot_unbound": "Bind orchestrator on message_bus or pass bot_id from bots.list (platform AgentBus: project_id=1).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass a handle this key owns, or omit source_agent_id.", "source_agent_unbound": "bots.bus.handle.set with this key first.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark inbound turn read without outbound text. Prefer provider_message_id (Telegram message id, including the quoted keyboard message of a button tap). message_id must match bots.bus.inbox / webhook tu"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Mark pending turn read", "request": {"params": {"bot_id": "<from bots.list>", "conversation_id": "<from inbox>", "handle": "<your bound handle>", "provider_message_id": "<preferred>"}, "tool": "bots.bus.ack"}}], "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Mark inbound turn read without outbound text. Prefer provider_message_id (Telegram message id, incl…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.inbox", "bots.bus.reply", "bots.bus.ask", "bots.bus.deliver"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_ack", "semantic_input_mode": "inherit_workflow", "summary": "Mark inbound turn acked (read) without outbound text.", "title": "Bots Bus Ack", "when_blocked": {"ack_forbidden": "Mailbox reply_target not owned by this key — bots.bus.whoami.", "bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "bot_not_in_project": "bot_id not on context.project_id — AgentBus platform bot needs project_id=1.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_id_required": "Poll bots.bus.inbox first — copy conversation_id and provider_message_id, then bots.bus.ack (bot_id optional on pid=1).", "conversation_not_found": "Wrong conversation_id — bots.bus.inbox then retry.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "This key owns more than one handle. Pass handle from bots.bus.handle.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "message_id_required": "Pass message_id or provider_message_id.", "message_not_found": "Turn stale — use provider_message_id from inbox (conversation ok).", "orchestrator_bot_unbound": "Bind orchestrator on message_bus or pass bot_id from bots.list (platform AgentBus: project_id=1).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass a handle this key owns, or omit source_agent_id.", "source_agent_unbound": "bots.bus.handle.set with this key first.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark inbound turn read without outbound text. Prefer provider_message_id (Telegram message id, including the quoted keyboard message of a button tap). message_id must match bots.bus.inbox / webhook tu", "write_mode": null}, {"action": "bots.bus.webhook.connect", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not store Bearer in 8DNA — authorization merges into Integration Hub secrets.", "On project_id=1 the connection is personal to the operator. Pass url; connection_id is optional.", "Webhook POST is one bus.message.inbound envelope, not a full inbox snapshot.", "After the wake, pull bots.bus.inbox. That list is the source of truth."], "bots_atoms": ["BOTS_BUS_WEBHOOK_PUSH", "BOTS_REPLY_MAILBOX", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.connect", "mutation_risk": "low", "related_tools": ["bots.bus.webhook.test", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook Connect", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "handle plus url or connection_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "test_hook_failed": "The leaf is already bound. Call bots.bus.webhook.test. Do not connect again.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_id_required": "This project stores the webhook on the operator user. Reconnect MCP so the call has a user.", "webhook_connect_failed": "Could not create the outbound connection for url", "webhook_url_invalid": "url rejected or connection update failed", "webhook_url_missing": "Connection has no outbound URL"}, "when_to_use": "Bind a push URL for config.message_bus.webhooks.{handle}. Pass url to create an outbound Integration Hub connection, or connection_id of an existing one. Ecosystem bot on project_id=1 stores the conne"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.connect", "mutation_risk": "low", "related_tools": ["bots.bus.webhook.test", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook Connect", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "handle plus url or connection_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "test_hook_failed": "The leaf is already bound. Call bots.bus.webhook.test. Do not connect again.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_id_required": "This project stores the webhook on the operator user. Reconnect MCP so the call has a user.", "webhook_connect_failed": "Could not create the outbound connection for url", "webhook_url_invalid": "url rejected or connection update failed", "webhook_url_missing": "Connection has no outbound URL"}, "when_to_use": "Bind a push URL for config.message_bus.webhooks.{handle}. Pass url to create an outbound Integration Hub connection, or connection_id of an existing one. Ecosystem bot on project_id=1 stores the conne"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Bind a push URL for config.message_bus.webhooks.{handle}. Pass url to create an outbound Integratio…", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["Pass url. connection_id is optional. Then bots.bus.webhook.test.", "On bus.message.inbound POST → bots.bus.inbox then reply or ack"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.webhook.test", "bots.bus.inbox"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_webhook_connect", "semantic_input_mode": "inherit_workflow", "summary": "Store outbound webhook connection for a handle (Integration Hub).", "title": "Bots Bus Webhook Connect", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "handle plus url or connection_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "test_hook_failed": "The leaf is already bound. Call bots.bus.webhook.test. Do not connect again.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_id_required": "This project stores the webhook on the operator user. Reconnect MCP so the call has a user.", "webhook_connect_failed": "Could not create the outbound connection for url", "webhook_url_invalid": "url rejected or connection update failed", "webhook_url_missing": "Connection has no outbound URL"}, "when_to_use": "Bind a push URL for config.message_bus.webhooks.{handle}. Pass url to create an outbound Integration Hub connection, or connection_id of an existing one. Ecosystem bot on project_id=1 stores the conne", "write_mode": null}, {"action": "bots.bus.webhook.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.list", "related_tools": ["bots.bus.webhook.connect", "bots.bus.webhook.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List bound bus webhooks for this project slice. No secrets."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.list", "related_tools": ["bots.bus.webhook.connect", "bots.bus.webhook.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List bound bus webhooks for this project slice. No secrets."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "List bound bus webhooks for this project slice. No secrets.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.webhook.connect", "bots.bus.webhook.status"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_webhook_list", "semantic_input_mode": "inherit_workflow", "summary": "List message-bus webhook bindings (connection id, no secrets).", "title": "Bots Bus Webhook List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List bound bus webhooks for this project slice. No secrets.", "write_mode": null}, {"action": "bots.bus.webhook.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.status", "related_tools": ["bots.bus.webhook.connect", "bots.bus.webhook.test"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One handle: connected, outbound url, has_authorization. No secret values."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.status", "related_tools": ["bots.bus.webhook.connect", "bots.bus.webhook.test"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One handle: connected, outbound url, has_authorization. No secret values."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "One handle: connected, outbound url, has_authorization. No secret values.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.webhook.connect", "bots.bus.webhook.test"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_webhook_status", "semantic_input_mode": "inherit_workflow", "summary": "One handle webhook: connected, url, has_authorization. No secret values.", "title": "Bots Bus Webhook Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One handle: connected, outbound url, has_authorization. No secret values.", "write_mode": null}, {"action": "bots.bus.webhook.test", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.test", "mutation_risk": "low", "related_tools": ["bots.bus.webhook.status", "bots.bus.webhook.connect"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook Test", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "test_hook_failed": "Probe failed. The leaf stays bound. Call bots.bus.webhook.test again.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "webhook_not_connected": "bots.bus.webhook.connect first"}, "when_to_use": "POST event bus.message.inbound.test to the bound URL."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.test", "mutation_risk": "low", "related_tools": ["bots.bus.webhook.status", "bots.bus.webhook.connect"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook Test", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "test_hook_failed": "Probe failed. The leaf stays bound. Call bots.bus.webhook.test again.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "webhook_not_connected": "bots.bus.webhook.connect first"}, "when_to_use": "POST event bus.message.inbound.test to the bound URL."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "POST event bus.message.inbound.test to the bound URL.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.webhook.status", "bots.bus.webhook.connect"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_webhook_test", "semantic_input_mode": "inherit_workflow", "summary": "POST bus.message.inbound.test to the bound URL.", "title": "Bots Bus Webhook Test", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "test_hook_failed": "Probe failed. The leaf stays bound. Call bots.bus.webhook.test again.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "webhook_not_connected": "bots.bus.webhook.connect first"}, "when_to_use": "POST event bus.message.inbound.test to the bound URL.", "write_mode": null}, {"action": "bots.bus.webhook.disconnect", "ai_tips": "Clear config.message_bus.webhooks.{handle}. Connection row stays.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.disconnect", "mutation_risk": "low", "related_tools": ["bots.bus.webhook.connect", "bots.bus.webhook.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook Disconnect", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "webhook_not_connected": "bots.bus.webhook.connect first, or handle already cleared"}, "when_to_use": "Clear config.message_bus.webhooks.{handle}. Connection row stays."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.disconnect", "mutation_risk": "low", "related_tools": ["bots.bus.webhook.connect", "bots.bus.webhook.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook Disconnect", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "webhook_not_connected": "bots.bus.webhook.connect first, or handle already cleared"}, "when_to_use": "Clear config.message_bus.webhooks.{handle}. Connection row stays."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Clear config.message_bus.webhooks.{handle}. Connection row stays.", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.webhook.connect", "bots.bus.webhook.list"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_webhook_disconnect", "semantic_input_mode": "inherit_workflow", "summary": "Clear the webhook leaf for a handle. Does not delete the Integration Hub connection.", "title": "Bots Bus Webhook Disconnect", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "webhook_not_connected": "bots.bus.webhook.connect first, or handle already cleared"}, "when_to_use": "Clear config.message_bus.webhooks.{handle}. Connection row stays.", "write_mode": null}, {"action": "bots.bus.webhook.rotate_secret", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.rotate_secret", "mutation_risk": "low", "related_tools": ["bots.bus.webhook.status", "bots.bus.webhook.test"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook Rotate Secret", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "webhook_not_connected": "No connection_id on this handle"}, "when_to_use": "Rotate signing_secret on the Integration Hub connection. Secret is returned once."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.rotate_secret", "mutation_risk": "low", "related_tools": ["bots.bus.webhook.status", "bots.bus.webhook.test"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook Rotate Secret", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "webhook_not_connected": "No connection_id on this handle"}, "when_to_use": "Rotate signing_secret on the Integration Hub connection. Secret is returned once."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Rotate signing_secret on the Integration Hub connection. Secret is returned once.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.webhook.status", "bots.bus.webhook.test"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_webhook_rotate_secret", "semantic_input_mode": "inherit_workflow", "summary": "Rotate the webhook signing_secret. The new secret is returned once.", "title": "Bots Bus Webhook Rotate Secret", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "webhook_not_connected": "No connection_id on this handle"}, "when_to_use": "Rotate signing_secret on the Integration Hub connection. Secret is returned once.", "write_mode": null}, {"action": "bots.bus.settings.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.settings.get", "related_tools": ["bots.bus.settings.set", "bots.bus.handle.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Settings Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read signature_position (prefix|suffix|off), platform_agent, sticky_minutes."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.settings.get", "related_tools": ["bots.bus.settings.set", "bots.bus.handle.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Settings Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read signature_position (prefix|suffix|off), platform_agent, sticky_minutes."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Read signature_position (prefix|suffix|off), platform_agent, sticky_minutes.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.settings.set", "bots.bus.handle.list"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_settings_get", "semantic_input_mode": "inherit_workflow", "summary": "Read message-bus settings: signature_position, platform_agent, sticky_minutes.", "title": "Bots Bus Settings Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read signature_position (prefix|suffix|off), platform_agent, sticky_minutes.", "write_mode": null}, {"action": "bots.bus.settings.set", "ai_tips": "Leaf-write config.message_bus.signature_position. Not a full message_bus blob.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.settings.set", "mutation_risk": "low", "related_tools": ["bots.bus.settings.get", "bots.bus.handle.set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Settings Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "signature_position_invalid": "Use prefix, suffix, or off", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Leaf-write config.message_bus.signature_position. Not a full message_bus blob."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.settings.set", "mutation_risk": "low", "related_tools": ["bots.bus.settings.get", "bots.bus.handle.set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Settings Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "signature_position_invalid": "Use prefix, suffix, or off", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Leaf-write config.message_bus.signature_position. Not a full message_bus blob."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Leaf-write config.message_bus.signature_position. Not a full message_bus blob.", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.settings.get", "bots.bus.handle.set"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_settings_set", "semantic_input_mode": "inherit_workflow", "summary": "Set signature_position on config.message_bus (prefix, suffix, or off).", "title": "Bots Bus Settings Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "signature_position_invalid": "Use prefix, suffix, or off", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Leaf-write config.message_bus.signature_position. Not a full message_bus blob.", "write_mode": null}, {"action": "bots.reply_source.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.reply_source.get", "related_tools": ["bots.reply_source.set", "bots.bus.deliver", "ai.chat.settings.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Reply Source Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "bot_id is required — bots.list then pass bot_uuid.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before agents.orchestrate or staff reply: who owns the thread. Workspace: bot_id=workspace, chat_key=workspace:{conversation_id}. Returns source ai|manager|agent and optional agent_handle."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.reply_source.get", "related_tools": ["bots.reply_source.set", "bots.bus.deliver", "ai.chat.settings.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Reply Source Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "bot_id is required — bots.list then pass bot_uuid.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before agents.orchestrate or staff reply: who owns the thread. Workspace: bot_id=workspace, chat_key=workspace:{conversation_id}. Returns source ai|manager|agent and optional agent_handle."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Before agents.orchestrate or staff reply: who owns the thread. Workspace: bot_id=workspace, chat_ke…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.reply_source.set", "bots.bus.deliver", "ai.chat.settings.get"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_reply_source_get", "semantic_input_mode": "inherit_workflow", "summary": "Read who answers a chat: ai (orchestrator, often Free.ai), manager (handoff), or bus agent. Workspace chats use bot_id=workspace and chat_key=workspace:{conversation_id}. When to use: before sending, ", "title": "Bots Reply Source Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "bot_id is required — bots.list then pass bot_uuid.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before agents.orchestrate or staff reply: who owns the thread. Workspace: bot_id=workspace, chat_key=workspace:{conversation_id}. Returns source ai|manager|agent and optional agent_handle.", "write_mode": null}, {"action": "bots.reply_source.set", "ai_tips": "Switch reply owner: ai (orchestrator), manager (handoff), agent (@handle via bus). Owner/admin only for workspace; fleet chats allow the staff user who claimed handoff on chat_key.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.reply_source.set", "mutation_risk": "low", "related_tools": ["bots.reply_source.get", "bots.bus.handle.set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Reply Source Set", "when_blocked": {"agent_handle_required": "source=agent — pass agent_handle or bind via bots.bus.handle.set.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "forbidden": "Project owner/admin required for bot_id=workspace; on fleet chats staff must hold handoff_claimed_by_user_id for that chat_key.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "bot_id and source (ai|manager|agent) required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "reply_source_failed": "Leaf write failed — check env_uuid / sandbox; bots.reply_source.get to verify.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Switch reply owner: ai (orchestrator), manager (handoff), agent (@handle via bus). Owner/admin only for workspace; fleet chats allow the staff user who claimed handoff on chat_key."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.reply_source.set", "mutation_risk": "low", "related_tools": ["bots.reply_source.get", "bots.bus.handle.set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Reply Source Set", "when_blocked": {"agent_handle_required": "source=agent — pass agent_handle or bind via bots.bus.handle.set.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "forbidden": "Project owner/admin required for bot_id=workspace; on fleet chats staff must hold handoff_claimed_by_user_id for that chat_key.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "bot_id and source (ai|manager|agent) required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "reply_source_failed": "Leaf write failed — check env_uuid / sandbox; bots.reply_source.get to verify.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Switch reply owner: ai (orchestrator), manager (handoff), agent (@handle via bus). Owner/admin only for workspace; fleet chats allow the staff user who claimed handoff on chat_key."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Switch reply owner: ai (orchestrator), manager (handoff), agent (@handle via bus). Owner/admin only…", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.reply_source.get", "bots.bus.handle.set"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_reply_source_set", "semantic_input_mode": "inherit_workflow", "summary": "Set who owns a chat. source=ai returns orchestration (use /release or set chat mode freeai). source=manager pairs with handoff so the bot brain stays quiet. source=agent requires agent_handle and rout", "title": "Bots Reply Source Set", "when_blocked": {"agent_handle_required": "source=agent — pass agent_handle or bind via bots.bus.handle.set.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "forbidden": "Project owner/admin required for bot_id=workspace; on fleet chats staff must hold handoff_claimed_by_user_id for that chat_key.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "bot_id and source (ai|manager|agent) required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "reply_source_failed": "Leaf write failed — check env_uuid / sandbox; bots.reply_source.get to verify.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Switch reply owner: ai (orchestrator), manager (handoff), agent (@handle via bus). Owner/admin only for workspace; fleet chats allow the staff user who claimed handoff on chat_key.", "write_mode": null}, {"action": "bots.bus.platform_agent.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.platform_agent.get", "related_tools": ["bots.bus.platform_agent.set", "bots.bus.inbox", "bots.simulate"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Platform Agent Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read config.message_bus.platform_agent.enabled (leaf). runtime_ok is the LLM gate."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.platform_agent.get", "related_tools": ["bots.bus.platform_agent.set", "bots.bus.inbox", "bots.simulate"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Platform Agent Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read config.message_bus.platform_agent.enabled (leaf). runtime_ok is the LLM gate."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Read config.message_bus.platform_agent.enabled (leaf). runtime_ok is the LLM gate.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.platform_agent.set", "bots.bus.inbox", "bots.simulate"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_platform_agent_get", "semantic_input_mode": "inherit_workflow", "summary": "Read platform_agent.enabled from message_bus DNA leaf.", "title": "Bots Bus Platform Agent Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read config.message_bus.platform_agent.enabled (leaf). runtime_ok is the LLM gate.", "write_mode": null}, {"action": "bots.bus.platform_agent.set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.platform_agent.set", "mutation_risk": "low", "related_tools": ["bots.bus.platform_agent.get", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Platform Agent Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch only config.message_bus.platform_agent.enabled. Does not rewrite handles."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.platform_agent.set", "mutation_risk": "low", "related_tools": ["bots.bus.platform_agent.get", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Platform Agent Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch only config.message_bus.platform_agent.enabled. Does not rewrite handles."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Patch only config.message_bus.platform_agent.enabled. Does not rewrite handles.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.platform_agent.get", "bots.bus.inbox"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_platform_agent_set", "semantic_input_mode": "inherit_workflow", "summary": "Set platform_agent.enabled on message_bus DNA leaf.", "title": "Bots Bus Platform Agent Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch only config.message_bus.platform_agent.enabled. Does not rewrite handles.", "write_mode": null}, {"action": "bots.bus.send", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not paste the file body into text — Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-upload to bots__outbound). MCP storage.upload does not take bytes. Do not paste the file body into text.", "anti_patterns": ["Do not paste the file body into text — Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scop", "Omit source_agent_id unless it is the handle already bound to this key.", "source_agent is an alias of source_agent_id. Do not pass handle= on send — that is inbox mailbox filter."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.send", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.staff_reply", "bots.bus.reply", "bots.bus.ask", "bots.bus.inbox", "bots.bus.ack"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Send", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_in_project": "AgentBus platform bot needs project_id=1.", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id for this bot.", "empty_body": "Provide text and/or attachments[].", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Multi-handle key — pass source_agent_id from bots.bus.whoami.", "handoff_not_active": "Enable handoff or pass clear_handoff with staff reply.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "orchestrator_bot_unbound": "Same as inbox — explicit bot_id or orchestrator binding on message_bus.", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Omit source_agent_id, or pass a handle this key owns (not inbox handle=).", "source_agent_unbound": "bots.bus.handle.set with this key first.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-uploa"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.send", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.staff_reply", "bots.bus.reply", "bots.bus.ask", "bots.bus.inbox", "bots.bus.ack"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Send", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_in_project": "AgentBus platform bot needs project_id=1.", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id for this bot.", "empty_body": "Provide text and/or attachments[].", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Multi-handle key — pass source_agent_id from bots.bus.whoami.", "handoff_not_active": "Enable handoff or pass clear_handoff with staff reply.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "orchestrator_bot_unbound": "Same as inbox — explicit bot_id or orchestrator binding on message_bus.", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Omit source_agent_id, or pass a handle this key owns (not inbox handle=).", "source_agent_unbound": "bots.bus.handle.set with this key first.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-uploa"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Channel outbound (server stamps bound handle)", "request": {"params": {"bot_id": "<from bots.list>", "conversation_id": "<from bots.bus.inbox>", "text": "Bus report attached — please ack in mailbox."}, "tool": "bots.bus.send"}}], "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {k…", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["bots.bus.inbox reply_for_scope=pending before send when unsure of thread state", "Quote reply: bots.bus.reply with reply_to_provider_message_id", "Ask yes/no: bots.bus.ask with question.kind=yes_no"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["storage.upload", "bots.staff_reply", "bots.bus.reply", "bots.bus.ask", "bots.bus.inbox", "bots.bus.ack"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_send", "semantic_input_mode": "inherit_workflow", "summary": "Send bus outbound text and/or attachments[] (signature + outbox) via staff_reply rail.", "title": "Bots Bus Send", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_in_project": "AgentBus platform bot needs project_id=1.", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id for this bot.", "empty_body": "Provide text and/or attachments[].", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Multi-handle key — pass source_agent_id from bots.bus.whoami.", "handoff_not_active": "Enable handoff or pass clear_handoff with staff reply.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "orchestrator_bot_unbound": "Same as inbox — explicit bot_id or orchestrator binding on message_bus.", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Omit source_agent_id, or pass a handle this key owns (not inbox handle=).", "source_agent_unbound": "bots.bus.handle.set with this key first.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-uploa", "write_mode": null}, {"action": "bots.bus.reply", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not paste the file body into text — Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-upload to bots__outbound). MCP storage.upload does not take bytes. Do not paste the file body into text.", "anti_patterns": ["Do not paste the file body into text — Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scop", "Pass reply_to_provider_message_id to quote the inbound turn in the channel.", "Asking the person is bots.bus.ask, or question on this reply. Same buttons, same tap."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.reply", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.bus.send", "bots.bus.ack", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Reply", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_in_project": "bot_id not on context.project_id — AgentBus platform bot needs project_id=1.", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id for this bot.", "empty_body": "Provide text and/or attachments[] after storage.upload.", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "This key owns more than one handle. Pass source_agent_id from bots.bus.handle.list.", "handoff_not_active": "Enable handoff or pass clear_handoff with staff reply.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "not_manager_live": "Channel reply succeeded but order_routing_live is unchanged — run bots.order_manager_bootstrap (dry_run then apply with env_uuid).", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass source_agent_id (alias source_agent) from bots.bus.handle.list that this key owns. handle= is inbox-only — not the speaker on reply.", "source_agent_unbound": "bots.bus.handle.set with this key first.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-uploa"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.reply", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.bus.send", "bots.bus.ack", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Reply", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_in_project": "bot_id not on context.project_id — AgentBus platform bot needs project_id=1.", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id for this bot.", "empty_body": "Provide text and/or attachments[] after storage.upload.", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "This key owns more than one handle. Pass source_agent_id from bots.bus.handle.list.", "handoff_not_active": "Enable handoff or pass clear_handoff with staff reply.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "not_manager_live": "Channel reply succeeded but order_routing_live is unchanged — run bots.order_manager_bootstrap (dry_run then apply with env_uuid).", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass source_agent_id (alias source_agent) from bots.bus.handle.list that this key owns. handle= is inbox-only — not the speaker on reply.", "source_agent_unbound": "bots.bus.handle.set with this key first.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-uploa"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Thread reply (handle stamped server-side)", "request": {"params": {"bot_id": "<from bots.list>", "conversation_id": "<from inbox>", "reply_to_provider_message_id": "<from inbox turn>", "text": "Done — see bus report."}, "tool": "bots.bus.reply"}}], "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {k…", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": [{"action": "bots.bus.handle.list", "why": "When source_agent_forbidden — pick a handle this API key owns."}, {"action": "bots.bus.reply", "params_hint": {"omit": "source_agent_id"}, "why": "Server stamps the speaker from the bound handle."}, {"action": "bots.bus.inbox", "params_hint": {"reply_for_scope": "pending"}, "why": "Poll pending before reply."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["storage.upload", "bots.bus.send", "bots.bus.ack", "bots.bus.inbox"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_reply", "semantic_input_mode": "inherit_workflow", "summary": "Quote-reply on bus rail (provider_message_id + signature).", "title": "Bots Bus Reply", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_in_project": "bot_id not on context.project_id — AgentBus platform bot needs project_id=1.", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id for this bot.", "empty_body": "Provide text and/or attachments[] after storage.upload.", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "This key owns more than one handle. Pass source_agent_id from bots.bus.handle.list.", "handoff_not_active": "Enable handoff or pass clear_handoff with staff reply.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "not_manager_live": "Channel reply succeeded but order_routing_live is unchanged — run bots.order_manager_bootstrap (dry_run then apply with env_uuid).", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass source_agent_id (alias source_agent) from bots.bus.handle.list that this key owns. handle= is inbox-only — not the speaker on reply.", "source_agent_unbound": "bots.bus.handle.set with this key first.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-uploa", "write_mode": null}, {"action": "bots.bus.ask", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Same keyboard as question on bots.bus.reply and bots.bus.send. Do not invent another format.", "anti_patterns": ["Same keyboard as question on bots.bus.reply and bots.bus.send. Do not invent another format.", "Omit question for yes/no. Do not write Да/Нет only in the text.", "U15 mode: question.kind=mode → group_access:mode:* (or bots.acl.set_mode / Telegram /mode), not REST."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.bus.ask", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.bus.reply", "bots.bus.send", "bots.bus.inbox", "bots.acl.set_mode"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Ask", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_in_project": "bot_id not on context.project_id — AgentBus platform bot needs project_id=1.", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "bots.bus.inbox for a live conversation_id.", "empty_body": "Provide text and/or attachments[].", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Multi-handle key — pass source_agent_id from bots.bus.whoami.", "handoff_not_active": "Enable handoff or pass clear_handoff with staff reply.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "mode_keyboard": "question.kind=mode posts group_access:mode:consultation|order (U15); same leaf as bots.acl.set_mode / Telegram /mode — not a REST /mode route.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass a handle this key owns (alias source_agent).", "source_agent_unbound": "bots.bus.handle.set first.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Ask the owner or the person already in conversation_id. Same buttons as question on bots.bus.reply and bots.bus.send — not a second feature. text is the question. Omit question for ✅ Да / ❌ Нет. quest"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.bus.ask", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.bus.reply", "bots.bus.send", "bots.bus.inbox", "bots.acl.set_mode"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Ask", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_in_project": "bot_id not on context.project_id — AgentBus platform bot needs project_id=1.", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "bots.bus.inbox for a live conversation_id.", "empty_body": "Provide text and/or attachments[].", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Multi-handle key — pass source_agent_id from bots.bus.whoami.", "handoff_not_active": "Enable handoff or pass clear_handoff with staff reply.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "mode_keyboard": "question.kind=mode posts group_access:mode:consultation|order (U15); same leaf as bots.acl.set_mode / Telegram /mode — not a REST /mode route.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass a handle this key owns (alias source_agent).", "source_agent_unbound": "bots.bus.handle.set first.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Ask the owner or the person already in conversation_id. Same buttons as question on bots.bus.reply and bots.bus.send — not a second feature. text is the question. Omit question for ✅ Да / ❌ Нет. quest"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Ask the person (yes/no buttons)", "request": {"params": {"bot_id": "<from bots.list>", "conversation_id": "<from bots.bus.inbox>", "text": "Confirm invoice total is correct?"}, "tool": "bots.bus.ask"}}, {"name": "U15 session mode keyboard (kind=mode)", "request": {"params": {"bot_id": "<from bots.list>", "conversation_id": "<group or owner thread>", "question": {"kind": "mode"}, "text": "Выберите режим работы в этом чате"}, "tool": "bots.bus.ask"}}], "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Ask the owner or the person already in conversation_id. Same buttons as question on bots.bus.reply …", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["Poll pending: bots.bus.inbox handle=<bound> reply_for_scope=pending", "After answer: bots.bus.reply or bots.bus.ack", "U15 mode: question.kind=mode → group_access:mode:* (or bots.acl.set_mode / Telegram /mode)"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["storage.upload", "bots.bus.reply", "bots.bus.send", "bots.bus.inbox", "bots.acl.set_mode"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_ask", "semantic_input_mode": "inherit_workflow", "summary": "Ask the person in this channel thread. Same keyboard as question on bots.bus.reply and bots.bus.send. Default ✅ Да / ❌ Нет. question {kind:choice, options:[...]} for several answers.", "title": "Bots Bus Ask", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_in_project": "bot_id not on context.project_id — AgentBus platform bot needs project_id=1.", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "bots.bus.inbox for a live conversation_id.", "empty_body": "Provide text and/or attachments[].", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Multi-handle key — pass source_agent_id from bots.bus.whoami.", "handoff_not_active": "Enable handoff or pass clear_handoff with staff reply.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "mode_keyboard": "question.kind=mode posts group_access:mode:consultation|order (U15); same leaf as bots.acl.set_mode / Telegram /mode — not a REST /mode route.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass a handle this key owns (alias source_agent).", "source_agent_unbound": "bots.bus.handle.set first.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Ask the owner or the person already in conversation_id. Same buttons as question on bots.bus.reply and bots.bus.send — not a second feature. text is the question. Omit question for ✅ Да / ❌ Нет. quest", "write_mode": null}, {"action": "bots.bus.deliver", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not paste the file body into text — Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-upload to bots__outbound). MCP storage.upload does not take bytes. Do not paste the file body into text.", "anti_patterns": ["Do not paste the file body into text — Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scop", "to_handle is the recipient, or @All for every other mailbox. Your name comes from this key.", "Pass task {node_id, plan_id, title, instruction, next_action} to hand off a work-graph node."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.deliver", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.bus.send", "bots.bus.inbox", "bots.bus.handle.set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Deliver", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_in_project": "bot_id not on context.project_id — AgentBus platform bot needs project_id=1.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "delivery_timeout": "Retry once; do not duplicate via staff_reply.", "empty_body": "Provide text, attachments[], or task.", "env_uuid_project_only": "env_uuid is only valid for home=project", "fanout_limit": "@All exceeds the mailbox fan-out cap (48) — deliver to fewer handles or batch.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "grant_denied": "owner_messenger_grant task rejected — fix principal, bot_uuid, project_id_grant.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Pass source_agent_id when this key owns multiple handles.", "invalid_parameters": "bot_id and to_handle are required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_recipients": "@All needs other handles on the project.", "not_manager_live": "Mailbox delivery succeeded but manager routing is not live — bots.order_manager_bootstrap apply with sandbox env_uuid.", "orchestrator_bot_unbound": "Pass bot_id or bind orchestrator on message_bus before deliver.", "owner_grant_task_invalid": "task.kind=owner_messenger_grant needs principal, project_id_grant, bot_uuid, recipient_dm_chat_id — see when_to_use on bots.bus.deliver.", "recipient_not_found": "to_handle missing — bots.bus.handle.list on this project.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "self_deliver_forbidden": "to_handle is your own speaker — pick another handle from bots.bus.handle.list.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "source_agent_id must be a handle this key owns.", "source_agent_unbound": "bots.bus.handle.set with this MCP key before deliver.", "storage_file_not_found": "storage_file_id missing on disk — re-upload to bots__outbound.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-uploa"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.deliver", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.bus.send", "bots.bus.inbox", "bots.bus.handle.set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Deliver", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_in_project": "bot_id not on context.project_id — AgentBus platform bot needs project_id=1.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "delivery_timeout": "Retry once; do not duplicate via staff_reply.", "empty_body": "Provide text, attachments[], or task.", "env_uuid_project_only": "env_uuid is only valid for home=project", "fanout_limit": "@All exceeds the mailbox fan-out cap (48) — deliver to fewer handles or batch.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "grant_denied": "owner_messenger_grant task rejected — fix principal, bot_uuid, project_id_grant.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Pass source_agent_id when this key owns multiple handles.", "invalid_parameters": "bot_id and to_handle are required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_recipients": "@All needs other handles on the project.", "not_manager_live": "Mailbox delivery succeeded but manager routing is not live — bots.order_manager_bootstrap apply with sandbox env_uuid.", "orchestrator_bot_unbound": "Pass bot_id or bind orchestrator on message_bus before deliver.", "owner_grant_task_invalid": "task.kind=owner_messenger_grant needs principal, project_id_grant, bot_uuid, recipient_dm_chat_id — see when_to_use on bots.bus.deliver.", "recipient_not_found": "to_handle missing — bots.bus.handle.list on this project.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "self_deliver_forbidden": "to_handle is your own speaker — pick another handle from bots.bus.handle.list.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "source_agent_id must be a handle this key owns.", "source_agent_unbound": "bots.bus.handle.set with this MCP key before deliver.", "storage_file_not_found": "storage_file_id missing on disk — re-upload to bots__outbound.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-uploa"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Mailbox handoff", "request": {"params": {"bot_id": "<from bots.list>", "source_agent_id": "cursor-deploy", "text": "Кому: @AgentStackDev\nТема: …\n\nBody.", "to_handle": "@AgentStackDev"}, "tool": "bots.bus.deliver"}}], "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {k…", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["Recipient: bots.bus.inbox handle=<to_handle> reply_for_scope=pending", "Reply path: bots.bus.deliver to_handle=<from_handle> with the result text", "If webhook_queued is false: bots.bus.webhook.connect on the recipient key"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["storage.upload", "bots.bus.send", "bots.bus.inbox", "bots.bus.handle.set"], "required_cap": "bots_run", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "bots_bus_deliver", "semantic_input_mode": "inherit_workflow", "summary": "Put text, attachments[], and/or task in another handle's mailbox. The sender is the caller's bound handle. Does not sign the message as the recipient. idempotency_key (or options.idempotency_key) make", "title": "Bots Bus Deliver", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_in_project": "bot_id not on context.project_id — AgentBus platform bot needs project_id=1.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "delivery_timeout": "Retry once; do not duplicate via staff_reply.", "empty_body": "Provide text, attachments[], or task.", "env_uuid_project_only": "env_uuid is only valid for home=project", "fanout_limit": "@All exceeds the mailbox fan-out cap (48) — deliver to fewer handles or batch.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "grant_denied": "owner_messenger_grant task rejected — fix principal, bot_uuid, project_id_grant.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Pass source_agent_id when this key owns multiple handles.", "invalid_parameters": "bot_id and to_handle are required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_recipients": "@All needs other handles on the project.", "not_manager_live": "Mailbox delivery succeeded but manager routing is not live — bots.order_manager_bootstrap apply with sandbox env_uuid.", "orchestrator_bot_unbound": "Pass bot_id or bind orchestrator on message_bus before deliver.", "owner_grant_task_invalid": "task.kind=owner_messenger_grant needs principal, project_id_grant, bot_uuid, recipient_dm_chat_id — see when_to_use on bots.bus.deliver.", "recipient_not_found": "to_handle missing — bots.bus.handle.list on this project.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "self_deliver_forbidden": "to_handle is your own speaker — pick another handle from bots.bus.handle.list.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "source_agent_id must be a handle this key owns.", "source_agent_unbound": "bots.bus.handle.set with this MCP key before deliver.", "storage_file_not_found": "storage_file_id missing on disk — re-upload to bots__outbound.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-uploa", "write_mode": null}, {"action": "bots.bus.onboard", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_BUS_AGENT_LADDER", "BOTS_BUS_WEBHOOK_PUSH", "BOTS_REPLY_MAILBOX", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.onboard", "related_tools": ["bots.bus.handle.set", "bots.bus.inbox", "bots.bus.webhook.connect", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Onboard", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Start here. Read-only ladder for this project — prompt agentstack_bot_message_bus, recipes mcp_bot_reply_mailbox_v1 / mcp_bot_message_bus_webhook_v1. Messages live on this project's bot: 200 turns per"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.onboard", "related_tools": ["bots.bus.handle.set", "bots.bus.inbox", "bots.bus.webhook.connect", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Onboard", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Start here. Read-only ladder for this project — prompt agentstack_bot_message_bus, recipes mcp_bot_reply_mailbox_v1 / mcp_bot_message_bus_webhook_v1. Messages live on this project's bot: 200 turns per"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Start here. Read-only ladder for this project — prompt agentstack_bot_message_bus, recipes mcp_bot_…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["bots.bus.handle.set — register @handle", "bots.bus.inbox handle=<slug> reply_for_scope=pending include_messages=true", "recipe mcp_bot_message_bus_webhook_v1 when push wake needed"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.handle.set", "bots.bus.inbox", "bots.bus.webhook.connect", "discovery.describe"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_onboard", "semantic_input_mode": "inherit_workflow", "summary": "Read-only agent message bus onboarding ladder (prompt, recipes, verify).", "title": "Bots Bus Onboard", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Start here. Read-only ladder for this project — prompt agentstack_bot_message_bus, recipes mcp_bot_reply_mailbox_v1 / mcp_bot_message_bus_webhook_v1. Messages live on this project's bot: 200 turns per", "write_mode": null}, {"action": "bots.bus.health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.health", "related_tools": ["bots.health", "bots.fleet_diagnostics"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Health", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Queue depths + RED metrics for this bot (include=queues). error_rate_basis=window uses last 32 samples; stale means no recent samples — check errors_lifetime and execute/outbound DLQ rows, not error_r"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.health", "related_tools": ["bots.health", "bots.fleet_diagnostics"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Health", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Queue depths + RED metrics for this bot (include=queues). error_rate_basis=window uses last 32 samples; stale means no recent samples — check errors_lifetime and execute/outbound DLQ rows, not error_r"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Queue depths + RED metrics for this bot (include=queues). error_rate_basis=window uses last 32 samp…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.health", "bots.fleet_diagnostics"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_health", "semantic_input_mode": "inherit_workflow", "summary": "Message-bus ops health: queues + channel capabilities.", "title": "Bots Bus Health", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Queue depths + RED metrics for this bot (include=queues). error_rate_basis=window uses last 32 samples; stale means no recent samples — check errors_lifetime and execute/outbound DLQ rows, not error_r", "write_mode": null}, {"action": "bots.fleet_diagnostics", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.fleet_diagnostics", "related_tools": ["bots.bus.health", "bots.list", "integrations.diagnose_telegram"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Fleet Diagnostics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bot Studio / ops triage; mirrors GET /api/projects/{id}/bots/fleet/diagnostics."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.fleet_diagnostics", "related_tools": ["bots.bus.health", "bots.list", "integrations.diagnose_telegram"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Fleet Diagnostics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bot Studio / ops triage; mirrors GET /api/projects/{id}/bots/fleet/diagnostics."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Bot Studio / ops triage; mirrors GET /api/projects/{id}/bots/fleet/diagnostics.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.health", "bots.list", "integrations.diagnose_telegram"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_fleet_diagnostics", "semantic_input_mode": "inherit_workflow", "summary": "Project bots fleet health (channel health, sessions) — project read RBAC.", "title": "Bots Fleet Diagnostics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bot Studio / ops triage; mirrors GET /api/projects/{id}/bots/fleet/diagnostics.", "write_mode": null}, {"action": "bots.flows.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not auto-execute manifest blocks — use bots.order_manager_bootstrap or recipe mcp_bot_order_manager_bootstrap_v1.", "Do not invent a second config schema — data.quick_start.blocks is the template (title, done_when, apply)."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1", "core.mcp.self_description.gen1"], "id": "bots.flows.get", "related_tools": ["bots.acl.list", "bots.order_manager_bootstrap", "discovery.recipes"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Flows Get", "when_blocked": {"bot_uuid_required": "When provider + external_chat_id are set, pass bot_uuid or bot_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dm_addressing_invalid": "external_chat_id must be numeric home chat.id (DM ok), not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "flow_manifest_invalid": "Fix manifest blocks/actions in DNA or pass valid inline structure.", "flow_manifest_not_found": "Set DNA leaf ecosystem.fleet.agent_flows.defaults.{flow_id} or use order_manager_v1.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "When building routing_gates, provider is required with external_chat_id.", "routing_context_incomplete": "Pass provider and external_chat_id together when you want routing_gates, or omit both for manifest-only (no bot_id required).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read validated AgentFlowManifestV1 (declarative blocks) + optional routing_gates snapshot. Default flow_id=order_manager_v1; DNA override: ecosystem.fleet.agent_flows.defaults.{flow_id}. Pass bot_uuid"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1", "core.mcp.self_description.gen1"], "id": "bots.flows.get", "related_tools": ["bots.acl.list", "bots.order_manager_bootstrap", "discovery.recipes"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Flows Get", "when_blocked": {"bot_uuid_required": "When provider + external_chat_id are set, pass bot_uuid or bot_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dm_addressing_invalid": "external_chat_id must be numeric home chat.id (DM ok), not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "flow_manifest_invalid": "Fix manifest blocks/actions in DNA or pass valid inline structure.", "flow_manifest_not_found": "Set DNA leaf ecosystem.fleet.agent_flows.defaults.{flow_id} or use order_manager_v1.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "When building routing_gates, provider is required with external_chat_id.", "routing_context_incomplete": "Pass provider and external_chat_id together when you want routing_gates, or omit both for manifest-only (no bot_id required).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read validated AgentFlowManifestV1 (declarative blocks) + optional routing_gates snapshot. Default flow_id=order_manager_v1; DNA override: ecosystem.fleet.agent_flows.defaults.{flow_id}. Pass bot_uuid"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Manifest + quick_start template", "request": {"params": {"flow_id": "order_manager_v1"}, "tool": "bots.flows.get"}}, {"name": "Template + live gates", "request": {"params": {"bot_uuid": "<uuid>", "external_chat_id": "<numeric home chat.id>", "provider": "telegram"}, "tool": "bots.flows.get"}}], "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Read validated AgentFlowManifestV1 (declarative blocks) + optional routing_gates snapshot. Default …", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["Read data.quick_start.blocks — titles, done_when, apply.params", "Run bots.order_manager_bootstrap (default dry_run) — quote readout.bus_text on the bus", "include_manifest=false when only routing_gates is needed"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.acl.list", "bots.order_manager_bootstrap", "discovery.recipes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_flows_get", "semantic_input_mode": "inherit_workflow", "summary": "Load AgentFlowManifestV1 (declarative MCP block list) with optional routing_gates snapshot. Execute via bots.order_manager_bootstrap or recipe mcp_bot_order_manager_bootstrap_v1.", "title": "Bots Flows Get", "when_blocked": {"bot_uuid_required": "When provider + external_chat_id are set, pass bot_uuid or bot_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dm_addressing_invalid": "external_chat_id must be numeric home chat.id (DM ok), not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "flow_manifest_invalid": "Fix manifest blocks/actions in DNA or pass valid inline structure.", "flow_manifest_not_found": "Set DNA leaf ecosystem.fleet.agent_flows.defaults.{flow_id} or use order_manager_v1.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "When building routing_gates, provider is required with external_chat_id.", "routing_context_incomplete": "Pass provider and external_chat_id together when you want routing_gates, or omit both for manifest-only (no bot_id required).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read validated AgentFlowManifestV1 (declarative blocks) + optional routing_gates snapshot. Default flow_id=order_manager_v1; DNA override: ecosystem.fleet.agent_flows.defaults.{flow_id}. Pass bot_uuid", "write_mode": null}, {"action": "bots.flows.validate", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1", "core.mcp.self_description.gen1"], "id": "bots.flows.validate", "related_tools": ["bots.flows.get", "bots.acl.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Flows Validate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "flow_manifest_invalid": "Whitelist/DAG failed — fix blocks, requires[], or unknown action ids.", "flow_manifest_not_found": "No DNA leaf for flow_id and not built-in order_manager_v1 — set leaf or pass manifest=.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Validate manifest JSON: whitelist actions, DAG requires[], no cycles. Optional vars replaces {{key}} in block params strings. Pass flow_id to load from DNA or inline manifest= for a dry check."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1", "core.mcp.self_description.gen1"], "id": "bots.flows.validate", "related_tools": ["bots.flows.get", "bots.acl.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Flows Validate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "flow_manifest_invalid": "Whitelist/DAG failed — fix blocks, requires[], or unknown action ids.", "flow_manifest_not_found": "No DNA leaf for flow_id and not built-in order_manager_v1 — set leaf or pass manifest=.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Validate manifest JSON: whitelist actions, DAG requires[], no cycles. Optional vars replaces {{key}} in block params strings. Pass flow_id to load from DNA or inline manifest= for a dry check."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Validate manifest JSON: whitelist actions, DAG requires[], no cycles. Optional vars replaces {{key}…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.flows.get", "bots.acl.list"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_flows_validate", "semantic_input_mode": "inherit_workflow", "summary": "Validate AgentFlowManifestV1 (whitelist + DAG). Optional inline manifest or DNA load + vars substitution.", "title": "Bots Flows Validate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "flow_manifest_invalid": "Whitelist/DAG failed — fix blocks, requires[], or unknown action ids.", "flow_manifest_not_found": "No DNA leaf for flow_id and not built-in order_manager_v1 — set leaf or pass manifest=.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Validate manifest JSON: whitelist actions, DAG requires[], no cycles. Optional vars replaces {{key}} in block params strings. Pass flow_id to load from DNA or inline manifest= for a dry check.", "write_mode": null}, {"action": "bots.order_manager_bootstrap", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not set dry_run=false on production without env_uuid and generation gates.", "Do not nest agentstack.execute for each manifest block — this tool runs the ladder in-process.", "Do not bots.bus.deliver that launch is not ready from dry_run=true. status=planned did not write DNA. Quote data.readout.bus_text (verdict PLAN)."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.group_access.gen1", "core.mcp.self_description.gen1"], "id": "bots.order_manager_bootstrap", "mutation_risk": "low", "related_tools": ["generation.fork", "generation.env_snapshot", "generation.supply_status", "bots.flows.get", "bots.acl.list", "bots.acl.responsible.set"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Order Manager Bootstrap", "when_blocked": {"acl_leaf_missing_after_load": "Could not materialize by_chat config after negative cache — retry or bust bot:group_acl cache.", "bootstrap_failed": "Non-domain runner error — inspect steps[] and server logs; dry_run=true to replan.", "bot_uuid_required": "Pass bot_uuid or bot_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_id_required": "Pass thread_id for forum topics or fix home chat.id.", "dm_addressing_invalid": "Home channel must be numeric chat.id (DM ok), not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "dry_run=false needs env_uuid (or a role that may write production). generation.fork → generation.env_snapshot once with receipt env_uuid (Gate A) → retry dry_run=false with that env_uuid.", "graph_home_unknown": "home must be project, self, or project_self", "group_access_config_invalid": "ACL leaf failed Pydantic validation on write — fix payload; readout steps[] for step id.", "handle_failed": "Bus handle write failed — after generation.fork: generation.env_snapshot with env_uuid; dry_run=false only when sandbox_gate.apply_ready.", "handle_not_found": "bots.bus.handle.list → bots.bus.handle.set → retry responsible step.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "manager_slug_required": "Pass manager_slug (bus handle without @).", "order_blocked": "Resolve routing_gates blockers before apply — bots.acl.list readout.", "order_needs_responsible_handle": "bots.acl.responsible.set before set_mode=order.", "provider_required": "Pass provider (telegram, …).", "sandbox_gate_closed": "Gate A — generation.env_snapshot (env_uuid from fork) before dry_run=false; dry_run=true is planning-only.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_unbound": "Register slug with bots.bus.handle.set; retry with dry_run=false in sandbox (env_uuid).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix provider + external_chat_id + bot_uuid before apply."}, "when_to_use": "Idempotent server runner for order_manager_v1: bus slug, responsible_handle, mode=order, verify routing_gates. Default dry_run=true — set dry_run=false only in sandbox (env_uuid); generation auto-fork"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.group_access.gen1", "core.mcp.self_description.gen1"], "id": "bots.order_manager_bootstrap", "mutation_risk": "low", "related_tools": ["generation.fork", "generation.env_snapshot", "generation.supply_status", "bots.flows.get", "bots.acl.list", "bots.acl.responsible.set"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Order Manager Bootstrap", "when_blocked": {"acl_leaf_missing_after_load": "Could not materialize by_chat config after negative cache — retry or bust bot:group_acl cache.", "bootstrap_failed": "Non-domain runner error — inspect steps[] and server logs; dry_run=true to replan.", "bot_uuid_required": "Pass bot_uuid or bot_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_id_required": "Pass thread_id for forum topics or fix home chat.id.", "dm_addressing_invalid": "Home channel must be numeric chat.id (DM ok), not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "dry_run=false needs env_uuid (or a role that may write production). generation.fork → generation.env_snapshot once with receipt env_uuid (Gate A) → retry dry_run=false with that env_uuid.", "graph_home_unknown": "home must be project, self, or project_self", "group_access_config_invalid": "ACL leaf failed Pydantic validation on write — fix payload; readout steps[] for step id.", "handle_failed": "Bus handle write failed — after generation.fork: generation.env_snapshot with env_uuid; dry_run=false only when sandbox_gate.apply_ready.", "handle_not_found": "bots.bus.handle.list → bots.bus.handle.set → retry responsible step.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "manager_slug_required": "Pass manager_slug (bus handle without @).", "order_blocked": "Resolve routing_gates blockers before apply — bots.acl.list readout.", "order_needs_responsible_handle": "bots.acl.responsible.set before set_mode=order.", "provider_required": "Pass provider (telegram, …).", "sandbox_gate_closed": "Gate A — generation.env_snapshot (env_uuid from fork) before dry_run=false; dry_run=true is planning-only.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_unbound": "Register slug with bots.bus.handle.set; retry with dry_run=false in sandbox (env_uuid).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix provider + external_chat_id + bot_uuid before apply."}, "when_to_use": "Idempotent server runner for order_manager_v1: bus slug, responsible_handle, mode=order, verify routing_gates. Default dry_run=true — set dry_run=false only in sandbox (env_uuid); generation auto-fork"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "DM manager dry_run plan", "request": {"params": {"bot_uuid": "<uuid>", "dry_run": true, "external_chat_id": "<DM chat.id>", "manager_slug": "<slug>", "project_id": 1, "provider": "telegram"}, "tool": "bots.order_manager_bootstrap"}, "response": {"data": {"dry_run": true, "dry_run_planning": {"apply_needs_env_uuid": true, "planning_ok_when_gate_closed": true, "requires_apply_ready": false}, "flow_id": "order_manager_v1", "order_routing_live": false, "readout": {"bus_text": "Plan only; no writes planned. Confirm sandbox Gate A before apply with dry_run=false and env_uuid. This is not a failed launch.", "verdict": "PLAN"}, "sandbox_gate": {"apply_ready": false, "planning_carve_out": true, "reason": "no_open_anchor"}, "steps": [{"action": "bots.acl.list", "status": "planned"}]}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_GATE_AFTER_FORK": "After generation.fork, reuse data.env_uuid for mutations and Gate A probes — generation.env_snapshot (lightest) then bootstrap dry_run=true; generation.supply_status only when tier/quota needed. Batch context honors params.env_uuid when list lags (hydrate + memo bust).", "GENERATION_NEXT_ACTIONS_HINTS_ONLY": "next_actions and recovery_hint on gate reads are navigation hints, not operator consent to mutate prod. When sandbox_gate.apply_ready=false, STOP — do not auto-run generation.fork or dry_run=false bootstrap from agent loops. Exception: bots.order_manager_bootstrap dry_run=true is planning only — it does not require apply_ready; pass env_uuid from generation.fork before dry_run=false apply (Gate B)."}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Idempotent server runner for order_manager_v1: bus slug, responsible_handle, mode=order, verify rou…", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["Gate A: generation.env_snapshot with env_uuid from generation.fork (lightest); generation.supply_status when tier/quota needed", "dry_run_planning: dry_run=true does not require sandbox_gate.apply_ready", "apply_ready=false blocks dry_run=false apply only — dry_run=true planning does not require apply_ready", "Quote data.readout.bus_text — verdict PLAN is not a failed launch", "dry_run=true: status=planned did not write DNA; template at bots.flows.get quick_start", "dry_run=false only in sandbox generation (env_uuid) after Gate B consent"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bootstrap_phase": {"description": "pre_runner_gate_probe | post_runner_envelope when envelope fails", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "committed": {"description": "True when dry_run=false apply finished (fleet write receipt)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "dry_run": {"description": "Plan-only default; true means no DNA writes", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "dry_run_planning": {"description": "dry_run=true carve-out — planning does not require apply_ready", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "env_uuid": {"description": "Sandbox slice used for apply", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "error_code": {"description": "Stable failure code on apply (domain step)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "exception_type": {"description": "Python class when error_code=bootstrap_failed", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "flow_id": {"description": "Manifest id (default order_manager_v1)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "message": {"description": "Alias of reason on bootstrap_failed remap", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "next_actions": {"description": "Verify blockers or apply recovery ladder", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "order_routing_live": {"description": "False until responsible + mode=order on home chat", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "post_apply_catalog_lag": {"description": "On sandbox_gate when post-apply snapshot lags (observability only)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "readout": {"description": "verdict PLAN|GO|NO-GO plus bus_text for operator quoting", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "reason": {"description": "Operator text for failure — prefer over bare error_code", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "recovery_hint": {"description": "When dry_run=false apply blocked by sandbox_gate", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "routing_gates": {"description": "Post-ladder snapshot (same shape as bots.acl.list)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "sandbox_gate": {"description": "Gate A mirror (apply_ready ≠ traffic pointer)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "session_mode": {"description": "consultation|order from final ACL snapshot", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "steps": {"description": "Per-block ladder statuses", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["generation.fork", "generation.env_snapshot", "generation.supply_status", "bots.flows.get", "bots.acl.list", "bots.acl.responsible.set"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_order_manager_bootstrap", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Idempotent server runner for order_manager_v1: bus slug, responsible_handle, mode=order, verify routing_gates. Pass thread_id for forum topics (U15).", "title": "Bots Order Manager Bootstrap", "when_blocked": {"acl_leaf_missing_after_load": "Could not materialize by_chat config after negative cache — retry or bust bot:group_acl cache.", "bootstrap_failed": "Non-domain runner error — inspect steps[] and server logs; dry_run=true to replan.", "bot_uuid_required": "Pass bot_uuid or bot_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_id_required": "Pass thread_id for forum topics or fix home chat.id.", "dm_addressing_invalid": "Home channel must be numeric chat.id (DM ok), not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "dry_run=false needs env_uuid (or a role that may write production). generation.fork → generation.env_snapshot once with receipt env_uuid (Gate A) → retry dry_run=false with that env_uuid.", "graph_home_unknown": "home must be project, self, or project_self", "group_access_config_invalid": "ACL leaf failed Pydantic validation on write — fix payload; readout steps[] for step id.", "handle_failed": "Bus handle write failed — after generation.fork: generation.env_snapshot with env_uuid; dry_run=false only when sandbox_gate.apply_ready.", "handle_not_found": "bots.bus.handle.list → bots.bus.handle.set → retry responsible step.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "manager_slug_required": "Pass manager_slug (bus handle without @).", "order_blocked": "Resolve routing_gates blockers before apply — bots.acl.list readout.", "order_needs_responsible_handle": "bots.acl.responsible.set before set_mode=order.", "provider_required": "Pass provider (telegram, …).", "sandbox_gate_closed": "Gate A — generation.env_snapshot (env_uuid from fork) before dry_run=false; dry_run=true is planning-only.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_unbound": "Register slug with bots.bus.handle.set; retry with dry_run=false in sandbox (env_uuid).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix provider + external_chat_id + bot_uuid before apply."}, "when_to_use": "Idempotent server runner for order_manager_v1: bus slug, responsible_handle, mode=order, verify routing_gates. Default dry_run=true — set dry_run=false only in sandbox (env_uuid); generation auto-fork", "write_mode": null}, {"action": "bots.acl.list", "aliases": ["bots.group_access", "bots.group_access.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not treat config:null as a load failure — bots.acl.grant writes messenger_grants on the user, not the by_chat leaf; add responsible/session via bots.acl.responsible.set or PATCH, then promote.", "Do not call bots.acl.get_mode only to read mode after list — session_mode is already on list.", "OpenAPI /docs is not the repo — use docs/operations/BOT_GROUP_ACCESS_RUNBOOK.md, not /docs/plans/*."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.list", "related_tools": ["bots.acl.grant", "bots.acl.chats.list", "bots.acl.get_mode", "bots.acl.set_mode", "bots.acl.audit.list", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl List", "when_blocked": {"bot_uuid_required": "Pass bot_uuid or bot_id (fleet alias).", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dm_addressing_invalid": "external_chat_id must be the numeric messenger home chat id, not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "Pass provider (telegram|max|…). No silent telegram default.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_key_mismatch": "Omit conversation_id or align with provider+external_chat_id derived leaf.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Omit env_uuid: reads config.active_env_uuid when set (parity with projects.get_data follow_active_generation). Explicit env_uuid wins; sticky sandbox applies only to fleet DNA mutators (grant/revoke/g"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.list", "related_tools": ["bots.acl.grant", "bots.acl.chats.list", "bots.acl.get_mode", "bots.acl.set_mode", "bots.acl.audit.list", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl List", "when_blocked": {"bot_uuid_required": "Pass bot_uuid or bot_id (fleet alias).", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dm_addressing_invalid": "external_chat_id must be the numeric messenger home chat id, not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "Pass provider (telegram|max|…). No silent telegram default.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_key_mismatch": "Omit conversation_id or align with provider+external_chat_id derived leaf.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Omit env_uuid: reads config.active_env_uuid when set (parity with projects.get_data follow_active_generation). Explicit env_uuid wins; sticky sandbox applies only to fleet DNA mutators (grant/revoke/g"}, "domain": "bots", "domain_title": "Bot group access organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"bot_uuid": "550e8400-e29b-41d4-a716-446655440000", "external_chat_id": "-100123456789", "provider": "telegram"}], "execution_class": "plain_read", "genetic_tags": ["core.bots.group_access.gen1", "core.bots.fleet.gen1"], "instruction_hint": "Omit env_uuid: reads config.active_env_uuid when set (parity with projects.get_data follow_active_g…", "kind": "organelle", "mutation_kind": "none", "next_actions": [{"action": "bots.acl.responsible.set", "why": "creates the home-channel by_chat leaf and sets responsible_handle; requires a registered bus slug (bots.bus.handle.list / handle.set first)"}, {"action": "bots.order_manager_bootstrap", "why": "generation.fork → generation.env_snapshot (Gate A); order_manager_v1 dry_run default; dry_run=false with env_uuid to apply"}, {"action": "bots.acl.grant", "why": "grant messenger user on account (home channel = external_chat_id); does not create the by_chat leaf"}, {"action": "bots.acl.set_mode", "why": "persist U15 session mode (order needs responsible_handle)"}, {"action": "bots.acl.chats.list", "why": "discover indexed home chat_keys"}, {"action": "preflight.check", "why": "before sandbox mutate"}], "onboarding_tier": "domain_playbook", "organ_id": "bots.group_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bot_uuid": {"description": "Echo of resolved fleet id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "chat_key": {"description": "Stable DNA key", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "chat_kind": {"description": "private|group — from home chat.id classifier (LAUNCH-1561)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "config": {"description": "BotGroupAccessConfig or null", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "conversation_id": {"description": "Canonical U15 session leaf", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "mode_source": {"description": "default|leaf|legacy_external_chat_id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "next_actions": {"description": "Suggested MCP follow-ups when config is null", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "order_routing_live": {"description": "True when order mode + responsible_handle on by_chat", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "order_template_enabled": {"description": "Project-level DNA flag", "type": "boolean"}, "recovery_hint": {"description": "Present when config is null", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "routing_gates": {"description": "Diagnostics: gates, blockers, next_actions for order/manager path", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "session_key_mismatch": {"description": "True when explicit conversation_id disagrees with derived leaf", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "session_mode": {"description": "consultation|order (same leaf as bots.acl.get_mode)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.bots.group_access.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.acl.grant", "bots.acl.chats.list", "bots.acl.get_mode", "bots.acl.set_mode", "bots.acl.audit.list", "preflight.check"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_acl_list", "semantic_input_mode": "inherit_workflow", "summary": "List group_access config for a home channel (DM, group, or supergroup).", "title": "Bots Acl List", "when_blocked": {"bot_uuid_required": "Pass bot_uuid or bot_id (fleet alias).", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dm_addressing_invalid": "external_chat_id must be the numeric messenger home chat id, not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "Pass provider (telegram|max|…). No silent telegram default.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_key_mismatch": "Omit conversation_id or align with provider+external_chat_id derived leaf.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Omit env_uuid: reads config.active_env_uuid when set (parity with projects.get_data follow_active_generation). Explicit env_uuid wins; sticky sandbox applies only to fleet DNA mutators (grant/revoke/g", "write_mode": null}, {"action": "bots.acl.chats.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not invent chat_keys — call bots.acl.chats.list for indexed home keys, then bots.acl.list with provider + external_chat_id."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.chats.list", "related_tools": ["bots.acl.list", "bots.acl.grant", "bots.acl.audit.list", "bots.acl.get_mode"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Chats List", "when_blocked": {"bot_uuid_required": "Pass bot_uuid or bot_id (fleet alias).", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List indexed home-channel chat_keys for one bot (bot:provider:external_chat_id). chat_keys:[] means no home-channel rows indexed yet (empty index). Account-level grants do not add chat_keys until a ho"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.chats.list", "related_tools": ["bots.acl.list", "bots.acl.grant", "bots.acl.audit.list", "bots.acl.get_mode"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Chats List", "when_blocked": {"bot_uuid_required": "Pass bot_uuid or bot_id (fleet alias).", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List indexed home-channel chat_keys for one bot (bot:provider:external_chat_id). chat_keys:[] means no home-channel rows indexed yet (empty index). Account-level grants do not add chat_keys until a ho"}, "domain": "bots", "domain_title": "Bot group access organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"bot_uuid": "550e8400-e29b-41d4-a716-446655440000"}], "execution_class": "plain_read", "genetic_tags": ["core.bots.group_access.gen1", "core.bots.fleet.gen1"], "instruction_hint": "List indexed home-channel chat_keys for one bot (bot:provider:external_chat_id). chat_keys:[] means…", "kind": "organelle", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "bots.group_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"chat_keys": {"description": "bot:provider:external_chat_id home-channel index rows; [] = no indexed home chats (by_chat) yet — not an error; account grants can still exist", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.bots.group_access.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.acl.list", "bots.acl.grant", "bots.acl.audit.list", "bots.acl.get_mode"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_acl_chats_list", "semantic_input_mode": "inherit_workflow", "summary": "List indexed home-channel chat_keys for one bot (bot:provider:external_chat_id).", "title": "Bots Acl Chats List", "when_blocked": {"bot_uuid_required": "Pass bot_uuid or bot_id (fleet alias).", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List indexed home-channel chat_keys for one bot (bot:provider:external_chat_id). chat_keys:[] means no home-channel rows indexed yet (empty index). Account-level grants do not add chat_keys until a ho", "write_mode": null}, {"action": "bots.acl.grant", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not append a per-chat allowlist row — the grant is stored on the AgentStack user.", "Do not expect grant alone to set responsible_handle or order mode — entitlement (messenger_grants) is separate from manager config (by_chat on the same home channel id via bots.acl.responsible.set or bots.order_manager_bootstrap).", "Do not grant without external_chat_id — it is the home channel (DM chat.id ok), not optional.", "Do not use bots.acl.grant to register a person. Identity is the messenger external_user_id. Do not call ensure_messenger_account for grant — use DM /login (email OTP or web_link) then grant; messenger_not_linked means resolve returned 0. Anonymous until DM /login links channel_identities (email OTP registers unknown mailboxes; grant does not).", "Do not call projects.add_user to grant group chat access.", "Do not omit provider — the default used to be telegram and wrote the wrong chat leaf.", "Do not use bots.acl for email, web push, or in-app events — use channels.*.", "Do not send role — the tool wants principal + project_id_grant (+ optional expires_at)."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.grant", "mutation_risk": "low", "related_tools": ["bots.acl.list", "bots.acl.revoke", "bots.acl.audit.list", "preflight.check", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Grant", "when_blocked": {"batch_grant_partial": "Inspect data.results[].error_code — earlier rows may have committed.", "bot_uuid_required": "Pass bot_uuid or bot_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dm_addressing_invalid": "Grant targets home channel — numeric chat.id for DM.", "env_uuid_project_only": "env_uuid is only valid for home=project", "expires_at_invalid": "ISO-8601, future, within 90 days. Omit for the 30-day default.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "grant_denied_not_member": "project_id_grant must be in grantor accessible_project_ids.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "messenger_not_linked": "resolve returned 0 — messenger id missing from channel_roster.known. Person must /login in DM first (email OTP or web_link; bots.update identity.auth_modes, empty list defaults to web_link).", "principal_required": "Pass principal or principals[] (max 10), not both empty.", "principals_batch_too_large": "At most 10 principals per call.", "provider_required": "Pass provider — wrong channel writes the wrong by_chat leaf.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Grant messenger entitlement (messenger_grants on the linked account) for one project_id the grantor may administer — not project membership via projects.add_user. principal must resolve (project 1 cha"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.grant", "mutation_risk": "low", "related_tools": ["bots.acl.list", "bots.acl.revoke", "bots.acl.audit.list", "preflight.check", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Grant", "when_blocked": {"batch_grant_partial": "Inspect data.results[].error_code — earlier rows may have committed.", "bot_uuid_required": "Pass bot_uuid or bot_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dm_addressing_invalid": "Grant targets home channel — numeric chat.id for DM.", "env_uuid_project_only": "env_uuid is only valid for home=project", "expires_at_invalid": "ISO-8601, future, within 90 days. Omit for the 30-day default.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "grant_denied_not_member": "project_id_grant must be in grantor accessible_project_ids.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "messenger_not_linked": "resolve returned 0 — messenger id missing from channel_roster.known. Person must /login in DM first (email OTP or web_link; bots.update identity.auth_modes, empty list defaults to web_link).", "principal_required": "Pass principal or principals[] (max 10), not both empty.", "principals_batch_too_large": "At most 10 principals per call.", "provider_required": "Pass provider — wrong channel writes the wrong by_chat leaf.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Grant messenger entitlement (messenger_grants on the linked account) for one project_id the grantor may administer — not project membership via projects.add_user. principal must resolve (project 1 cha"}, "domain": "bots", "domain_title": "Bot group access organelle", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"bot_uuid": "550e8400-e29b-41d4-a716-446655440000", "expires_at": "", "external_chat_id": "-100123456789", "principal": "424242", "project_id_grant": 2, "provider": "max"}], "execution_class": "cheap", "genetic_tags": ["core.bots.group_access.gen1", "core.bots.fleet.gen1"], "instruction_hint": "Grant messenger entitlement (messenger_grants on the linked account) for one project_id the grantor…", "kind": "organelle", "mutation_kind": "entity", "next_actions": ["generation.diff_vs_prod → generation.gates → generation.promote (separate sync executes)", "bots.acl.list (home channel) to verify responsible_handle / order_routing_live"], "onboarding_tier": "domain_playbook", "organ_id": "bots.group_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"already_exists": {"description": "True when the same projects, home channel, and expires_at are already active", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "config": {"description": "Home-channel by_chat leaf, or null when that leaf was never written. The grant is on the user.", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "platform_user_id": {"description": "AgentStack user that holds the grant. 0 when unresolved.", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.bots.group_access.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.acl.list", "bots.acl.revoke", "bots.acl.audit.list", "preflight.check", "generation.promote"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_acl_grant", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Grant a messenger user on their AgentStack account for one project_id inside the grantor's membership.", "title": "Bots Acl Grant", "when_blocked": {"batch_grant_partial": "Inspect data.results[].error_code — earlier rows may have committed.", "bot_uuid_required": "Pass bot_uuid or bot_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dm_addressing_invalid": "Grant targets home channel — numeric chat.id for DM.", "env_uuid_project_only": "env_uuid is only valid for home=project", "expires_at_invalid": "ISO-8601, future, within 90 days. Omit for the 30-day default.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "grant_denied_not_member": "project_id_grant must be in grantor accessible_project_ids.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "messenger_not_linked": "resolve returned 0 — messenger id missing from channel_roster.known. Person must /login in DM first (email OTP or web_link; bots.update identity.auth_modes, empty list defaults to web_link).", "principal_required": "Pass principal or principals[] (max 10), not both empty.", "principals_batch_too_large": "At most 10 principals per call.", "provider_required": "Pass provider — wrong channel writes the wrong by_chat leaf.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Grant messenger entitlement (messenger_grants on the linked account) for one project_id the grantor may administer — not project membership via projects.add_user. principal must resolve (project 1 cha", "write_mode": null}, {"action": "bots.acl.revoke", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.revoke", "mutation_risk": "high", "related_tools": ["bots.acl.list", "bots.acl.grant", "bots.acl.audit.list"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Revoke", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "Pass provider; chat_key = bot:provider:chat.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke the messenger user's account grant (optional project_id_revoke drops one project). external_chat_id is context, not the grant key."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.revoke", "mutation_risk": "high", "related_tools": ["bots.acl.list", "bots.acl.grant", "bots.acl.audit.list"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Revoke", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "Pass provider; chat_key = bot:provider:chat.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke the messenger user's account grant (optional project_id_revoke drops one project). external_chat_id is context, not the grant key."}, "domain": "bots", "domain_title": "Bot group access organelle", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.bots.group_access.gen1", "core.bots.fleet.gen1"], "instruction_hint": "Revoke the messenger user's account grant (optional project_id_revoke drops one project). external_…", "kind": "organelle", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "bots.group_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"config": {"description": "Config after revoke", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.bots.group_access.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.acl.list", "bots.acl.grant", "bots.acl.audit.list"], "required_cap": "bots_run", "requires_preflight": true, "risk_class": "destructive", "safe_action": "bots_acl_revoke", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Revoke the messenger user's account grant (optional project_id_revoke drops one project).", "title": "Bots Acl Revoke", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "provider_required": "Pass provider; chat_key = bot:provider:chat.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke the messenger user's account grant (optional project_id_revoke drops one project). external_chat_id is context, not the grant key.", "write_mode": null}, {"action": "bots.acl.responsible.set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not invent bots.group_access.get — use bots.acl.list / bots.acl.responsible.set.", "Do not GET /api/bots/group_access for live config — that path returns migration JSON only (error_code legacy_group_access_path).", "Do not pass a display name — pass a bus slug listed on bots.bus.handle.list (strip @).", "Do not expect grant to create the by_chat leaf — bots.acl.responsible.set creates it."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.responsible.set", "mutation_risk": "low", "related_tools": ["bots.bus.handle.list", "bots.bus.handle.set", "bots.acl.list", "bots.acl.set_mode", "bots.acl.grant"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Responsible Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dm_addressing_invalid": "external_chat_id must be numeric home chat.id, not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_not_found": "Registry empty, slug missing, or message_bus leaf unreadable — bots.bus.handle.list, bots.bus.handle.set, then retry bots.acl.responsible.set.", "handle_required": "Pass handle (manager @slug without @).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "Pass provider for the bound chat.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Set the chat manager: ordered ladder — (1) bots.bus.handle.list to confirm slugs; (2) bots.bus.handle.set if the registry is empty or the slug is missing; (3) bots.acl.responsible.set with bot_uuid, p"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.responsible.set", "mutation_risk": "low", "related_tools": ["bots.bus.handle.list", "bots.bus.handle.set", "bots.acl.list", "bots.acl.set_mode", "bots.acl.grant"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Responsible Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dm_addressing_invalid": "external_chat_id must be numeric home chat.id, not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_not_found": "Registry empty, slug missing, or message_bus leaf unreadable — bots.bus.handle.list, bots.bus.handle.set, then retry bots.acl.responsible.set.", "handle_required": "Pass handle (manager @slug without @).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "Pass provider for the bound chat.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Set the chat manager: ordered ladder — (1) bots.bus.handle.list to confirm slugs; (2) bots.bus.handle.set if the registry is empty or the slug is missing; (3) bots.acl.responsible.set with bot_uuid, p"}, "domain": "bots", "domain_title": "Bot group access organelle", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.group_access.gen1", "core.bots.fleet.gen1"], "instruction_hint": "Set the chat manager: ordered ladder — (1) bots.bus.handle.list to confirm slugs; (2) bots.bus.hand…", "kind": "organelle", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "bots.group_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"config": {"description": "Config with responsible_handle", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.bots.group_access.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.handle.list", "bots.bus.handle.set", "bots.acl.list", "bots.acl.set_mode", "bots.acl.grant"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_acl_responsible_set", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Set responsible_handle to a registered message-bus slug. One config.message_bus registry read per call; empty registry, unknown slug, or unreadable bus leaf → handle_not_found (fail closed). Same pred", "title": "Bots Acl Responsible Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dm_addressing_invalid": "external_chat_id must be numeric home chat.id, not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_not_found": "Registry empty, slug missing, or message_bus leaf unreadable — bots.bus.handle.list, bots.bus.handle.set, then retry bots.acl.responsible.set.", "handle_required": "Pass handle (manager @slug without @).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "Pass provider for the bound chat.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Set the chat manager: ordered ladder — (1) bots.bus.handle.list to confirm slugs; (2) bots.bus.handle.set if the registry is empty or the slug is missing; (3) bots.acl.responsible.set with bot_uuid, p", "write_mode": null}, {"action": "bots.acl.set_mode", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not invent REST POST …/mode — use bots.acl.set_mode or Telegram /mode.", "Do not PATCH group-access to set session mode — use bots.acl.set_mode; REST PATCH returns unknown_patch_keys for other fields.", "Do not treat the raw external_chat_id as the session leaf key.", "Do not confuse session mode with ACL grants — grants stay bots.acl.grant."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.set_mode", "mutation_risk": "low", "related_tools": ["bots.acl.get_mode", "bots.bus.ask", "bots.acl.list", "bots.bus.send"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Set Mode", "when_blocked": {"acl_missing_by_chat": "No by_chat leaf — bots.acl.responsible.set creates it.", "bus_registry_unreadable": "config.message_bus unreadable — bots.bus.handle.list / handle.set.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_id_required": "Pass conversation_id, or provider + external_chat_id. The server stores stable_conversation_id, not the raw chat id.", "dm_addressing_invalid": "external_chat_id must be the numeric messenger home chat id, not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "mode_invalid": "Pass mode=consultation|order (Telegram /mode parity).", "order_needs_responsible_handle": "mode=order requires provider + external_chat_id and a registered responsible_handle.", "provider_required": "Omit conversation_id only when provider is set. No silent telegram.", "responsible_not_in_message_bus_handles": "responsible_handle not on config.message_bus.handles — bots.bus.handle.set then retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "U15: write group session mode consultation|order (leaf ecosystem.fleet.group_access.session_by_conversation). consultation may use conversation_id or provider + external_chat_id. mode=order requires p"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.set_mode", "mutation_risk": "low", "related_tools": ["bots.acl.get_mode", "bots.bus.ask", "bots.acl.list", "bots.bus.send"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Set Mode", "when_blocked": {"acl_missing_by_chat": "No by_chat leaf — bots.acl.responsible.set creates it.", "bus_registry_unreadable": "config.message_bus unreadable — bots.bus.handle.list / handle.set.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_id_required": "Pass conversation_id, or provider + external_chat_id. The server stores stable_conversation_id, not the raw chat id.", "dm_addressing_invalid": "external_chat_id must be the numeric messenger home chat id, not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "mode_invalid": "Pass mode=consultation|order (Telegram /mode parity).", "order_needs_responsible_handle": "mode=order requires provider + external_chat_id and a registered responsible_handle.", "provider_required": "Omit conversation_id only when provider is set. No silent telegram.", "responsible_not_in_message_bus_handles": "responsible_handle not on config.message_bus.handles — bots.bus.handle.set then retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "U15: write group session mode consultation|order (leaf ecosystem.fleet.group_access.session_by_conversation). consultation may use conversation_id or provider + external_chat_id. mode=order requires p"}, "domain": "bots", "domain_title": "Bot group access organelle", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"bot_uuid": "550e8400-e29b-41d4-a716-446655440000", "external_chat_id": "-100123456789", "mode": "order", "provider": "telegram"}], "execution_class": "cheap", "genetic_tags": ["core.bots.group_access.gen1", "core.bots.fleet.gen1"], "instruction_hint": "U15: write group session mode consultation|order (leaf ecosystem.fleet.group_access.session_by_conv…", "kind": "organelle", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "bots.group_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"conversation_id": {"description": "Canonical session leaf key (stable_conversation_id)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "mode": {"description": "consultation|order", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.bots.group_access.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.acl.get_mode", "bots.bus.ask", "bots.acl.list", "bots.bus.send"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_acl_set_mode", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "U15: set group session mode consultation|order. Pass conversation_id, or provider + external_chat_id so the server derives stable_conversation_id. Raw chat id is not the leaf key. Same leaf as Telegra", "title": "Bots Acl Set Mode", "when_blocked": {"acl_missing_by_chat": "No by_chat leaf — bots.acl.responsible.set creates it.", "bus_registry_unreadable": "config.message_bus unreadable — bots.bus.handle.list / handle.set.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_id_required": "Pass conversation_id, or provider + external_chat_id. The server stores stable_conversation_id, not the raw chat id.", "dm_addressing_invalid": "external_chat_id must be the numeric messenger home chat id, not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "mode_invalid": "Pass mode=consultation|order (Telegram /mode parity).", "order_needs_responsible_handle": "mode=order requires provider + external_chat_id and a registered responsible_handle.", "provider_required": "Omit conversation_id only when provider is set. No silent telegram.", "responsible_not_in_message_bus_handles": "responsible_handle not on config.message_bus.handles — bots.bus.handle.set then retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "U15: write group session mode consultation|order (leaf ecosystem.fleet.group_access.session_by_conversation). consultation may use conversation_id or provider + external_chat_id. mode=order requires p", "write_mode": null}, {"action": "bots.acl.get_mode", "aliases": ["bots.group_access.get"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not call with only external_chat_id — that is provider_required.", "Do not treat mode_source=legacy_external_chat_id as the canonical leaf — set_mode rewrites it.", "When passing explicit conversation_id with provider + external_chat_id, mode is read on conversation_id — not the derived stable_conversation_id; omit conversation_id to align with list.", "Do not call get_mode after list for routing_gates — list already returns routing_gates."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.group_access.gen1"], "id": "bots.acl.get_mode", "related_tools": ["bots.acl.set_mode", "bots.acl.list", "bots.bus.ask"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Get Mode", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_id_required": "Pass conversation_id, or provider + external_chat_id.", "dm_addressing_invalid": "external_chat_id must be the numeric messenger home chat id, not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "external_chat_id alone is not enough. Pass provider, or pass conversation_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_key_mismatch": "Response field when conversation_id disagrees with derived U15 leaf — omit override.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read U15 group session mode (default consultation when leaf missing). external_chat_id alone returns provider_required — pass conversation_id, or provider + external_chat_id. When provider + external_"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.group_access.gen1"], "id": "bots.acl.get_mode", "related_tools": ["bots.acl.set_mode", "bots.acl.list", "bots.bus.ask"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Get Mode", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_id_required": "Pass conversation_id, or provider + external_chat_id.", "dm_addressing_invalid": "external_chat_id must be the numeric messenger home chat id, not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "external_chat_id alone is not enough. Pass provider, or pass conversation_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_key_mismatch": "Response field when conversation_id disagrees with derived U15 leaf — omit override.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read U15 group session mode (default consultation when leaf missing). external_chat_id alone returns provider_required — pass conversation_id, or provider + external_chat_id. When provider + external_"}, "domain": "bots", "domain_title": "Bot group access organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"bot_uuid": "550e8400-e29b-41d4-a716-446655440000", "external_chat_id": "-100123456789", "provider": "telegram"}], "execution_class": "plain_read", "genetic_tags": ["core.bots.group_access.gen1", "core.bots.fleet.gen1"], "instruction_hint": "Read U15 group session mode (default consultation when leaf missing). external_chat_id alone return…", "kind": "organelle", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "bots.group_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"conversation_id": {"description": "Canonical session leaf key", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "mode": {"description": "consultation|order", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "mode_source": {"description": "default|leaf|legacy_external_chat_id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "order_routing_live": {"description": "Echo from routing_gates when chat context is complete", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "routing_gates": {"description": "Same snapshot as bots.acl.list when provider + external_chat_id are passed", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.bots.group_access.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.acl.set_mode", "bots.acl.list", "bots.bus.ask"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_acl_get_mode", "semantic_input_mode": "inherit_workflow", "summary": "Read U15 group session mode. Pass conversation_id, or provider + external_chat_id. A hit only on the old raw chat-id leaf returns mode_source=legacy_external_chat_id (read-only; set_mode rewrites cano", "title": "Bots Acl Get Mode", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_id_required": "Pass conversation_id, or provider + external_chat_id.", "dm_addressing_invalid": "external_chat_id must be the numeric messenger home chat id, not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "external_chat_id alone is not enough. Pass provider, or pass conversation_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_key_mismatch": "Response field when conversation_id disagrees with derived U15 leaf — omit override.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read U15 group session mode (default consultation when leaf missing). external_chat_id alone returns provider_required — pass conversation_id, or provider + external_chat_id. When provider + external_", "write_mode": null}, {"action": "bots.acl.audit.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.group_access.gen1"], "id": "bots.acl.audit.list", "related_tools": ["bots.acl.list", "bots.acl.grant", "bots.acl.revoke"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Audit List", "when_blocked": {"bot_uuid_required": "Pass bot_uuid (optional chat_key for one group).", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read recent group_access ECS audit after grant/revoke. Requires bot_uuid; optional chat_key exact filter (bot:provider:chat). When items is empty but DNA wrote last_change, response may include dna_la"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.group_access.gen1"], "id": "bots.acl.audit.list", "related_tools": ["bots.acl.list", "bots.acl.grant", "bots.acl.revoke"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Audit List", "when_blocked": {"bot_uuid_required": "Pass bot_uuid (optional chat_key for one group).", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read recent group_access ECS audit after grant/revoke. Requires bot_uuid; optional chat_key exact filter (bot:provider:chat). When items is empty but DNA wrote last_change, response may include dna_la"}, "domain": "bots", "domain_title": "Bot group access organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.group_access.gen1", "core.bots.fleet.gen1"], "instruction_hint": "Read recent group_access ECS audit after grant/revoke. Requires bot_uuid; optional chat_key exact f…", "kind": "organelle", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "bots.group_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bot_uuid": {"description": "Echo of bot filter", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "chat_key": {"description": "Echo of optional chat filter", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "dna_last_change": {"description": "Optional DNA last_change summary when items is empty (append_ecs_log may have been skipped)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "items": {"description": "Recent bot_group_access audit rows", "items": {"type": "object"}, "type": "array"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.bots.group_access.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.acl.list", "bots.acl.grant", "bots.acl.revoke"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_acl_audit_list", "semantic_input_mode": "inherit_workflow", "summary": "Read recent group_access ECS audit after grant/revoke.", "title": "Bots Acl Audit List", "when_blocked": {"bot_uuid_required": "Pass bot_uuid (optional chat_key for one group).", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read recent group_access ECS audit after grant/revoke. Requires bot_uuid; optional chat_key exact filter (bot:provider:chat). When items is empty but DNA wrote last_change, response may include dna_la", "write_mode": null}, {"action": "bots.orders.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not use bots.bus.inbox or bots.conversations for the manager order queue — bots.orders.list is the C20 read model keyed by chat_key bot:provider:external_chat_id.", "Do not treat success with empty items as consultation mode — MCP fail-closed returns error_code session_mode_not_order when U15 session_mode is not order.", "Do not skip bots.acl.list before bootstrap — confirm session_mode, then bots.order_manager_bootstrap dry_run=true (recipe mcp_bot_order_manager_bootstrap_v1).", "Do not call on hosted /s/{pid}/mcp cookie plane — bots.orders.* needs operator bots_run."], "bots_atoms": ["BOTS_ORDERS_READ"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.manager_dm.gen1", "core.mcp.self_description.gen1"], "id": "bots.orders.list", "related_tools": ["bots.orders.get", "bots.acl.list", "bots.order_manager_bootstrap", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Orders List", "when_blocked": {"chat_key_required": "Pass chat_key bot:provider:external_chat_id before listing orders.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "order_routing_unscoped": "order_routing_live without responsible_handle — bots.acl.list grant responsible_handle or pin conversation_id before bots.orders.list.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_mode_not_order": "U15 session_mode is not order — bots.acl.list then bots.order_manager_bootstrap.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Manager DM order projection. Pass chat_key as bot:provider:external_chat_id. Optional env_uuid for sandbox slice; reply_for_scope pending|history when routing live. Does not call Telegram. session_mod"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.manager_dm.gen1", "core.mcp.self_description.gen1"], "id": "bots.orders.list", "related_tools": ["bots.orders.get", "bots.acl.list", "bots.order_manager_bootstrap", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Orders List", "when_blocked": {"chat_key_required": "Pass chat_key bot:provider:external_chat_id before listing orders.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "order_routing_unscoped": "order_routing_live without responsible_handle — bots.acl.list grant responsible_handle or pin conversation_id before bots.orders.list.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_mode_not_order": "U15 session_mode is not order — bots.acl.list then bots.order_manager_bootstrap.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Manager DM order projection. Pass chat_key as bot:provider:external_chat_id. Optional env_uuid for sandbox slice; reply_for_scope pending|history when routing live. Does not call Telegram. session_mod"}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Manager DM order projection. Pass chat_key as bot:provider:external_chat_id. Optional env_uuid for …", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["session_mode_not_order → bots.acl.list then bots.order_manager_bootstrap dry_run=true", "Empty items while session_mode=order → bots.bus.inbox reply_for_scope=pending"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.orders.get", "bots.acl.list", "bots.order_manager_bootstrap", "bots.bus.inbox"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_orders_list", "semantic_input_mode": "inherit_workflow", "summary": "Read-model list of manager DM orders (TG1692 C20 projection).", "title": "Bots Orders List", "when_blocked": {"chat_key_required": "Pass chat_key bot:provider:external_chat_id before listing orders.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "order_routing_unscoped": "order_routing_live without responsible_handle — bots.acl.list grant responsible_handle or pin conversation_id before bots.orders.list.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_mode_not_order": "U15 session_mode is not order — bots.acl.list then bots.order_manager_bootstrap.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Manager DM order projection. Pass chat_key as bot:provider:external_chat_id. Optional env_uuid for sandbox slice; reply_for_scope pending|history when routing live. Does not call Telegram. session_mod", "write_mode": null}, {"action": "bots.orders.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not send replies from get — trail is read-only; use bots.staff_reply or bots.bus.reply.", "Do not omit bot_uuid — get requires bot_uuid with order_id (conversation thread).", "Pass chat_key when session_mode guard is required — mirrors list fail-closed contract.", "Do not invent commerce SKU orders — order_id is the bus conversation_id."], "bots_atoms": ["BOTS_ORDERS_READ"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.manager_dm.gen1", "core.mcp.self_description.gen1"], "id": "bots.orders.get", "related_tools": ["bots.orders.list", "bots.acl.list", "bots.order_manager_bootstrap"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Orders Get", "when_blocked": {"bot_uuid_required": "Pass bot_uuid to load the conversation thread.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "No thread for order_id — verify bots.bus.inbox or conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "order_id_required": "order_id is required.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_mode_not_order": "Pass chat_key for ACL guard — session_mode is not order (bots.acl.list first).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One conversation thread. Pass order_id plus bot_uuid. Trail is capped; does not send a reply."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.manager_dm.gen1", "core.mcp.self_description.gen1"], "id": "bots.orders.get", "related_tools": ["bots.orders.list", "bots.acl.list", "bots.order_manager_bootstrap"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Orders Get", "when_blocked": {"bot_uuid_required": "Pass bot_uuid to load the conversation thread.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "No thread for order_id — verify bots.bus.inbox or conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "order_id_required": "order_id is required.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_mode_not_order": "Pass chat_key for ACL guard — session_mode is not order (bots.acl.list first).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One conversation thread. Pass order_id plus bot_uuid. Trail is capped; does not send a reply."}, "domain": "bots", "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "One conversation thread. Pass order_id plus bot_uuid. Trail is capped; does not send a reply.", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["conversation_not_found → bots.bus.inbox or verify order_id / bot_uuid", "After bootstrap → bots.acl.list for routing_gates"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.orders.list", "bots.acl.list", "bots.order_manager_bootstrap"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_orders_get", "semantic_input_mode": "inherit_workflow", "summary": "Read one manager order by id (TG1692 C20).", "title": "Bots Orders Get", "when_blocked": {"bot_uuid_required": "Pass bot_uuid to load the conversation thread.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "No thread for order_id — verify bots.bus.inbox or conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "order_id_required": "order_id is required.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_mode_not_order": "Pass chat_key for ACL guard — session_mode is not order (bots.acl.list first).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One conversation thread. Pass order_id plus bot_uuid. Trail is capped; does not send a reply.", "write_mode": null}, {"action": "ai.providers.list", "aliases": ["ai.provider.list", "ai.providers", "free.ai.list", "freeai.list", "llm.providers", "llm.providers.list", "providers.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not invent provider_id outside the catalog items[].", "anti_patterns": ["Do not invent provider_id outside the catalog items[].", "Do not expect error_code energy_low — use free_calls.mode=energy_low for ranking hints."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.ai.gen1"], "id": "ai.providers.list", "related_tools": ["ai.providers.probe", "ai.providers.connect", "ai.providers.free_calls_set", "energy.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Ai Providers List", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "energy_low": "builder_energy low — buy pack or wait daily pool; Free.ai still debits energy. Next: energy.get_balance."}, "when_to_use": "Before agents.run when choosing llm.provider. Free.ai is platform_supply — users spend builder_energy; Free.ai fulfills COGS. Keywords: freeai, platform_supply, llm_free_calls, energy. Policy mode ene"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.ai.gen1"], "id": "ai.providers.list", "related_tools": ["ai.providers.probe", "ai.providers.connect", "ai.providers.free_calls_set", "energy.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Ai Providers List", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "energy_low": "builder_energy low — buy pack or wait daily pool; Free.ai still debits energy. Next: energy.get_balance."}, "when_to_use": "Before agents.run when choosing llm.provider. Free.ai is platform_supply — users spend builder_energy; Free.ai fulfills COGS. Keywords: freeai, platform_supply, llm_free_calls, energy. Policy mode ene"}, "domain": "ai", "domain_title": "Ai Providers MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "energy_low": "builder_energy low — buy pack or wait daily pool; Free.ai still debits energy. Next: energy.get_balance."}, "examples": [{"enabled_only": true}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.ai_providers.gen1", "core.llm.partner_providers.gen1", "core.economy.llm_energy.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Before agents.run when choosing llm.provider. Free.ai is platform_supply — users spend builder_ener…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["ai.providers.connect", "ai.providers.probe", "energy.get_balance", "agents.run"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_providers", "owner_gene": "core.mcp.ai_providers.gen1", "related_tools": ["ai.providers.probe", "ai.providers.connect", "ai.providers.free_calls_set", "energy.get_balance"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_providers_list", "semantic_input_mode": "inherit_workflow", "summary": "List LLM providers from the partner registry (openai/anthropic/gemini + OpenAI-compatible partners like freeai). Free.ai is platform_supply (debit_energy=true — users spend builder_energy). Includes d", "title": "Ai Providers List", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "energy_low": "builder_energy low — buy pack or wait daily pool; Free.ai still debits energy. Next: energy.get_balance."}, "when_to_use": "Before agents.run when choosing llm.provider. Free.ai is platform_supply — users spend builder_energy; Free.ai fulfills COGS. Keywords: freeai, platform_supply, llm_free_calls, energy. Policy mode ene", "write_mode": null}, {"action": "ai.providers.probe", "aliases": ["ai.provider.probe", "free.ai.probe", "freeai.probe", "llm.providers.probe"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not treat probe as a billed completion — energy is not debited.", "anti_patterns": ["Do not treat probe as a billed completion — energy is not debited."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.ai.gen1"], "id": "ai.providers.probe", "related_tools": ["ai.providers.connect", "ai.providers.list", "agents.run", "agents.provider_preflight", "energy.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Ai Providers Probe", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "key_missing": "No BYOK for provider — ai.providers.connect with api_key (ecosystem or project). Next: ai.providers.connect.", "probe_failed": "Credential/quota probe failed — reconnect key or pick another provider. Next: ai.providers.connect.", "provider_quota_exceeded": "Upstream quota/rate limit — wait, switch provider, or check energy.get_balance. Next: energy.get_balance.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "when_to_use": "After ai.providers.connect or before agents.run with preflight_required. Probes Free.ai / openai / anthropic / gemini credentials (no energy debit)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.ai.gen1"], "id": "ai.providers.probe", "related_tools": ["ai.providers.connect", "ai.providers.list", "agents.run", "agents.provider_preflight", "energy.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Ai Providers Probe", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "key_missing": "No BYOK for provider — ai.providers.connect with api_key (ecosystem or project). Next: ai.providers.connect.", "probe_failed": "Credential/quota probe failed — reconnect key or pick another provider. Next: ai.providers.connect.", "provider_quota_exceeded": "Upstream quota/rate limit — wait, switch provider, or check energy.get_balance. Next: energy.get_balance.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "when_to_use": "After ai.providers.connect or before agents.run with preflight_required. Probes Free.ai / openai / anthropic / gemini credentials (no energy debit)."}, "domain": "ai", "domain_title": "Ai Providers MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "key_missing": "No BYOK for provider — ai.providers.connect with api_key (ecosystem or project). Next: ai.providers.connect.", "probe_failed": "Credential/quota probe failed — reconnect key or pick another provider. Next: ai.providers.connect.", "provider_quota_exceeded": "Upstream quota/rate limit — wait, switch provider, or check energy.get_balance. Next: energy.get_balance.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "examples": [{"model": "qwen7b", "provider_id": "freeai"}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.ai_providers.gen1", "core.llm.partner_providers.gen1", "core.economy.llm_energy.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "After ai.providers.connect or before agents.run with preflight_required. Probes Free.ai / openai / …", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.run", "agents.provider_preflight", "ai.providers.connect", "ai.providers.list"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_providers", "owner_gene": "core.mcp.ai_providers.gen1", "related_tools": ["ai.providers.connect", "ai.providers.list", "agents.run", "agents.provider_preflight", "energy.get_balance"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_providers_probe", "semantic_input_mode": "inherit_workflow", "summary": "Lightweight LLM credential/quota probe for a provider (Agents preflight).", "title": "Ai Providers Probe", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "key_missing": "No BYOK for provider — ai.providers.connect with api_key (ecosystem or project). Next: ai.providers.connect.", "probe_failed": "Credential/quota probe failed — reconnect key or pick another provider. Next: ai.providers.connect.", "provider_quota_exceeded": "Upstream quota/rate limit — wait, switch provider, or check energy.get_balance. Next: energy.get_balance.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "when_to_use": "After ai.providers.connect or before agents.run with preflight_required. Probes Free.ai / openai / anthropic / gemini credentials (no energy debit).", "write_mode": null}, {"action": "ai.providers.connect", "aliases": ["ai.provider.connect", "free.ai.connect", "freeai.connect", "llm.providers.connect"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Never put API keys in treasury.credits or projects.patch_data public leaves.", "anti_patterns": ["Never put API keys in treasury.credits or projects.patch_data public leaves."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.ai.gen1"], "id": "ai.providers.connect", "related_tools": ["ai.providers.probe", "ai.providers.free_calls_set", "energy.get_balance", "ai.providers.list"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Ai Providers Connect", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "not_found": "Ecosystem project or treasury credit row missing — check project_id. Next: projects.get_data.", "service_cap_denied": "API key lacks mcp_read/project_admin — widen caps or use Device Code full. Next: auth.get_profile.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "when_to_use": "Store Free.ai or partner API key in protected service_keys (ecosystem or project). Never writes secrets into treasury.credits."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.ai.gen1"], "id": "ai.providers.connect", "related_tools": ["ai.providers.probe", "ai.providers.free_calls_set", "energy.get_balance", "ai.providers.list"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Ai Providers Connect", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "not_found": "Ecosystem project or treasury credit row missing — check project_id. Next: projects.get_data.", "service_cap_denied": "API key lacks mcp_read/project_admin — widen caps or use Device Code full. Next: auth.get_profile.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "when_to_use": "Store Free.ai or partner API key in protected service_keys (ecosystem or project). Never writes secrets into treasury.credits."}, "domain": "ai", "domain_title": "Ai Providers MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "not_found": "Ecosystem project or treasury credit row missing — check project_id. Next: projects.get_data.", "service_cap_denied": "API key lacks mcp_read/project_admin — widen caps or use Device Code full. Next: auth.get_profile.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "examples": [{"api_key": "sk-free-…", "provider_id": "freeai", "scope": "ecosystem"}], "execution_class": "cheap", "genetic_tags": ["core.mcp.ai_providers.gen1", "core.llm.partner_providers.gen1", "core.economy.llm_energy.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Store Free.ai or partner API key in protected service_keys (ecosystem or project). Never writes sec…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["ai.providers.probe", "ai.providers.free_calls_set", "energy.get_balance", "ai.providers.list"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_providers", "owner_gene": "core.mcp.ai_providers.gen1", "related_tools": ["ai.providers.probe", "ai.providers.free_calls_set", "energy.get_balance", "ai.providers.list"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "ai_providers_connect", "semantic_input_mode": "inherit_workflow", "summary": "Store an LLM provider API key in protected service_keys (ecosystem or project). Never writes secrets into treasury.credits.", "title": "Ai Providers Connect", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "not_found": "Ecosystem project or treasury credit row missing — check project_id. Next: projects.get_data.", "service_cap_denied": "API key lacks mcp_read/project_admin — widen caps or use Device Code full. Next: auth.get_profile.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "when_to_use": "Store Free.ai or partner API key in protected service_keys (ecosystem or project). Never writes secrets into treasury.credits.", "write_mode": null}, {"action": "ai.providers.free_calls_set", "aliases": ["ai.free_calls.set", "freeai.free_calls_set", "llm.free_calls.set", "llm.providers.free_calls_set"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not treat Free.ai as billing_exempt — platform_supply still debits builder_energy.", "anti_patterns": ["Do not treat Free.ai as billing_exempt — platform_supply still debits builder_energy."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.ai.gen1"], "id": "ai.providers.free_calls_set", "related_tools": ["ai.providers.list", "ai.providers.probe", "ai.providers.connect", "energy.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Ai Providers Free Calls Set", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "service_cap_denied": "API key lacks mcp_read/project_admin — widen caps or use Device Code full. Next: auth.get_profile.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "when_to_use": "Enable/prefer platform_supply routing (Free.ai) for catalogs, Agent defaults, and KeySelector fallback. Users still debit builder_energy."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.ai.gen1"], "id": "ai.providers.free_calls_set", "related_tools": ["ai.providers.list", "ai.providers.probe", "ai.providers.connect", "energy.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Ai Providers Free Calls Set", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "service_cap_denied": "API key lacks mcp_read/project_admin — widen caps or use Device Code full. Next: auth.get_profile.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "when_to_use": "Enable/prefer platform_supply routing (Free.ai) for catalogs, Agent defaults, and KeySelector fallback. Users still debit builder_energy."}, "domain": "ai", "domain_title": "Ai Providers MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "service_cap_denied": "API key lacks mcp_read/project_admin — widen caps or use Device Code full. Next: auth.get_profile.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "examples": [{"enabled": true, "mode": "always", "prefer": true}], "execution_class": "cheap", "genetic_tags": ["core.mcp.ai_providers.gen1", "core.llm.partner_providers.gen1", "core.economy.llm_energy.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Enable/prefer platform_supply routing (Free.ai) for catalogs, Agent defaults, and KeySelector fallb…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["ai.providers.list", "ai.providers.connect", "ai.providers.probe", "agents.run"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_providers", "owner_gene": "core.mcp.ai_providers.gen1", "related_tools": ["ai.providers.list", "ai.providers.probe", "ai.providers.connect", "energy.get_balance"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "ai_providers_free_calls_set", "semantic_input_mode": "inherit_workflow", "summary": "Set ecosystem (or project) llm_free_calls policy — enable/prefer platform_supply providers (Free.ai) that fulfill builder_energy calls.", "title": "Ai Providers Free Calls Set", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "service_cap_denied": "API key lacks mcp_read/project_admin — widen caps or use Device Code full. Next: auth.get_profile.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "when_to_use": "Enable/prefer platform_supply routing (Free.ai) for catalogs, Agent defaults, and KeySelector fallback. Users still debit builder_energy.", "write_mode": null}, {"action": "ai.chat.settings.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not poll on every user keystroke — cache per project in UI.", "Do not use settings.get to probe LLM keys — use ai.providers.probe."], "capability_descriptor": {"complexity": "simple", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.llm.partner_providers.gen1"], "id": "ai.chat.settings.get", "related_tools": ["ai.chat.settings.set", "bots.reply_source.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Chat Settings Get", "when_to_use": "Before tuning hosted chat or bus reply routing (TG 2421)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.llm.partner_providers.gen1"], "id": "ai.chat.settings.get", "related_tools": ["ai.chat.settings.set", "bots.reply_source.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Chat Settings Get", "when_to_use": "Before tuning hosted chat or bus reply routing (TG 2421)."}, "domain": "ai", "domain_title": "Ai Chat MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.ai_chat.gen1", "frontend.ai_chat.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Before tuning hosted chat or bus reply routing (TG 2421).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_chat", "owner_gene": "core.mcp.ai_chat.gen1", "related_tools": ["ai.chat.settings.set", "bots.reply_source.get"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_chat_settings_get", "semantic_input_mode": "inherit_workflow", "summary": "Read project light-chat LLM settings for /chat and studio (surface light_chat). Returns settings (mode, limits.messages_per_user_day, on_limit, fallback_provider) and free_ai_available for the caller.", "title": "Ai Chat Settings Get", "when_to_use": "Before tuning hosted chat or bus reply routing (TG 2421).", "write_mode": null}, {"action": "ai.chat.settings.set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not bypass RBAC by writing 8DNA directly for ecosystem.ai chat leaves."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.llm.partner_providers.gen1"], "id": "ai.chat.settings.set", "mutation_risk": "low", "related_tools": ["ai.chat.settings.get", "ai.providers.free_calls_set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Chat Settings Set", "when_to_use": "Operator chat defaults; pair with bots.reply_source.set for TG 2428."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.llm.partner_providers.gen1"], "id": "ai.chat.settings.set", "mutation_risk": "low", "related_tools": ["ai.chat.settings.get", "ai.providers.free_calls_set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Chat Settings Set", "when_to_use": "Operator chat defaults; pair with bots.reply_source.set for TG 2428."}, "domain": "ai", "domain_title": "Ai Chat MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.ai_chat.gen1", "frontend.ai_chat.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Operator chat defaults; pair with bots.reply_source.set for TG 2428.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_chat", "owner_gene": "core.mcp.ai_chat.gen1", "related_tools": ["ai.chat.settings.get", "ai.providers.free_calls_set"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "ai_chat_settings_set", "semantic_input_mode": "inherit_workflow", "summary": "Write project light-chat LLM policy: mode auto|freeai|own_key, limits.messages_per_user_day (0=unlimited), on_limit fallback|manager|stop, fallback_provider, max_tokens_per_reply. Owner/admin only (fo", "title": "Ai Chat Settings Set", "when_to_use": "Operator chat defaults; pair with bots.reply_source.set for TG 2428.", "write_mode": null}, {"action": "genetic.snapshot.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "genetic", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.genetic.project_genome.gen1"], "id": "genetic.snapshot.get", "related_tools": ["genetic.search", "hosting.git.status", "genetic.reindex"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Genetic Snapshot Get", "when_not_to_use": "Platform TAG_CATALOG / docs_nav — substrate navigation only.", "when_to_use": "After git push with philosophy/ or AI_INDEX; verify meta.sha matches journal HEAD."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "genetic", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.genetic.project_genome.gen1"], "id": "genetic.snapshot.get", "related_tools": ["genetic.search", "hosting.git.status", "genetic.reindex"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Genetic Snapshot Get", "when_not_to_use": "Platform TAG_CATALOG / docs_nav — substrate navigation only.", "when_to_use": "After git push with philosophy/ or AI_INDEX; verify meta.sha matches journal HEAD."}, "do_not_use_when": "Platform TAG_CATALOG / docs_nav — substrate navigation only.", "domain": "genetic", "domain_title": "Genetic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "empty_graph_ladder": {"kind": "empty_graph", "message": "Snapshot has no genetic nodes — commit philosophy/ or AI_INDEX and push the journal.", "next_actions": ["hosting.git.status", "hosting.git.log", "genetic.reindex"]}, "execution_class": "plain_read", "genetic_tags": ["core.genetic.project_genome.gen1"], "instruction_hint": "After git push with philosophy/ or AI_INDEX; verify meta.sha matches journal HEAD.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.genetic", "owner_gene": "core.genetic.project_genome.gen1", "plane_chooser": "Monorepo docs-nav (TAG_CATALOG, docs_nav.*) is platform navigation — not the tenant map. Tenant genetic graph lives in git (philosophy/, **/AI_INDEX.md, AGENTS.md) and caches in 8DNA ecosystem.genetic after hosting git push. Read: genetic.snapshot.get. After push verify meta.sha. Manual rebuild: genetic.reindex with journal_root from hosting.git.status — not projects.patch_data on ecosystem.genetic.", "related_tools": ["genetic.search", "hosting.git.status", "genetic.reindex"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "genetic_snapshot_get", "semantic_input_mode": "inherit_workflow", "summary": "Read derived genetic navigation graph for a project (ecosystem.genetic 8DNA leaves). Text SoT is in git; this is the cached graph for UI and agents.", "title": "Genetic Snapshot Get", "when_not_to_use": "Platform TAG_CATALOG / docs_nav — substrate navigation only.", "when_to_use": "After git push with philosophy/ or AI_INDEX; verify meta.sha matches journal HEAD.", "write_mode": null}, {"action": "genetic.search", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "genetic", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.genetic.project_genome.gen1"], "id": "genetic.search", "related_tools": ["genetic.snapshot.get", "hosting.git.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Genetic Search", "when_not_to_use": "docs_nav.search on platform repo.", "when_to_use": "Find a genetic tag or index path within this project's genome snapshot."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "genetic", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.genetic.project_genome.gen1"], "id": "genetic.search", "related_tools": ["genetic.snapshot.get", "hosting.git.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Genetic Search", "when_not_to_use": "docs_nav.search on platform repo.", "when_to_use": "Find a genetic tag or index path within this project's genome snapshot."}, "do_not_use_when": "docs_nav.search on platform repo.", "domain": "genetic", "domain_title": "Genetic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.genetic.project_genome.gen1"], "instruction_hint": "Find a genetic tag or index path within this project's genome snapshot.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.genetic", "owner_gene": "core.genetic.project_genome.gen1", "plane_chooser": "Monorepo docs-nav (TAG_CATALOG, docs_nav.*) is platform navigation — not the tenant map. Tenant genetic graph lives in git (philosophy/, **/AI_INDEX.md, AGENTS.md) and caches in 8DNA ecosystem.genetic after hosting git push. Read: genetic.snapshot.get. After push verify meta.sha. Manual rebuild: genetic.reindex with journal_root from hosting.git.status — not projects.patch_data on ecosystem.genetic.", "related_tools": ["genetic.snapshot.get", "hosting.git.status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "genetic_search", "semantic_input_mode": "inherit_workflow", "summary": "Search tenant genome nodes by tokenized query (tag, title, paths).", "title": "Genetic Search", "when_not_to_use": "docs_nav.search on platform repo.", "when_to_use": "Find a genetic tag or index path within this project's genome snapshot.", "write_mode": null}, {"action": "genetic.reindex", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "genetic", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.genetic.project_genome.gen1"], "id": "genetic.reindex", "mutation_risk": "low", "next_actions": ["genetic.snapshot.get", "generation.diff_vs_prod"], "related_tools": ["genetic.snapshot.get", "hosting.git.status", "generation.diff_vs_prod", "generation.gates"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Genetic Reindex", "when_blocked": {"missing_journal": "Set journal_root from hosting.git.status before reindex."}, "when_not_to_use": "Do not patch ecosystem.genetic via projects.patch_data — use this or hosting push.", "when_to_use": "Manual refresh after external git or when hook indexing failed. Paid tenants: auto-fork then generation.diff_vs_prod on ecosystem.genetic before promote."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "genetic", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.genetic.project_genome.gen1"], "id": "genetic.reindex", "mutation_risk": "low", "next_actions": ["genetic.snapshot.get", "generation.diff_vs_prod"], "related_tools": ["genetic.snapshot.get", "hosting.git.status", "generation.diff_vs_prod", "generation.gates"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Genetic Reindex", "when_blocked": {"missing_journal": "Set journal_root from hosting.git.status before reindex."}, "when_not_to_use": "Do not patch ecosystem.genetic via projects.patch_data — use this or hosting push.", "when_to_use": "Manual refresh after external git or when hook indexing failed. Paid tenants: auto-fork then generation.diff_vs_prod on ecosystem.genetic before promote."}, "do_not_use_when": "Do not patch ecosystem.genetic via projects.patch_data — use this or hosting push.", "domain": "genetic", "domain_title": "Genetic MCP domain", "effect": {"execution_class": "heavy", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "error_hints": {"missing_journal": "Set journal_root from hosting.git.status before reindex."}, "execution_class": "heavy", "genetic_tags": ["core.genetic.project_genome.gen1"], "instruction_hint": "Manual refresh after external git or when hook indexing failed. Paid tenants: auto-fork then genera…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["hosting.git.status", "hosting.project.status", "genetic.snapshot.get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.genetic", "owner_gene": "core.genetic.project_genome.gen1", "plane_chooser": "Monorepo docs-nav (TAG_CATALOG, docs_nav.*) is platform navigation — not the tenant map. Tenant genetic graph lives in git (philosophy/, **/AI_INDEX.md, AGENTS.md) and caches in 8DNA ecosystem.genetic after hosting git push. Read: genetic.snapshot.get. After push verify meta.sha. Manual rebuild: genetic.reindex with journal_root from hosting.git.status — not projects.patch_data on ecosystem.genetic.", "related_tools": ["genetic.snapshot.get", "hosting.git.status", "generation.diff_vs_prod", "generation.gates"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "genetic_reindex", "safe_cycle_ladder": "Paid tenants: genetic.reindex mutates 8DNA — use recipe mcp_universal_safe_change / agentstack_safe_project_cycle when auto_generation_mode is on (auto-fork → generation.diff_vs_prod path ecosystem.genetic.meta → generation.gates → generation.promote). Hosting push index writes prod journal head directly (indexed cache, not sandbox).", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Rebuild genetic snapshot leaves from git journal paths. Respects generation sandbox when env_uuid is set or auto_generation forks active.", "title": "Genetic Reindex", "when_blocked": {"missing_journal": "Set journal_root from hosting.git.status before reindex."}, "when_not_to_use": "Do not patch ecosystem.genetic via projects.patch_data — use this or hosting push.", "when_to_use": "Manual refresh after external git or when hook indexing failed. Paid tenants: auto-fork then generation.diff_vs_prod on ecosystem.genetic before promote.", "write_mode": null}, {"action": "payments.create", "aliases": ["payments.create_payment"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not use payments.create for wallet deposit — wallets.deposit moves internal balance.", "anti_patterns": ["Do not use payments.create for wallet deposit — wallets.deposit moves internal balance.", "Do not call payments.create intent=currency_pack on tenant PID without shop.checkout.create order_id.", "Hosted /s/ buyers: shop.checkout.create — not bare currency_pack metadata grants."], "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "execution_class": "cheap", "genetic_tags": ["core.mcp.payments.gen1", "core.commerce.soft_currency_grant.gen1"], "id": "payments.create", "mutation_risk": "low", "related_tools": ["payments.get", "payments.get_balance", "payments.list_transactions"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments Create", "when_blocked": {"catalog_auth_required": "IAP catalog is owner-only — auth.get_profile then shop.products.list; or enable iap_public_catalog in commerce DNA for hosted buyers", "client_amount_forbidden": "Omit amount/amount_minor — server prices from SKU; shop.checkout.create or payments metadata from catalog", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "payments.get_balance then retry same idempotency_key; diagnose if repeats", "feature_gate_denied": "buffs.get_effective_limits — plan tier blocks checkout; upgrade_url or buffs grant", "forbidden_for_visitor": "Hosted visitor — provision auth or use shop.checkout.create for IAP; not wallets.deposit from anon cookie", "iap_order_required": "shop.checkout.create — order_id only on currency_pack from that checkout; intent sale with metadata.order_id is rejected (iap_order_required)", "idempotency_conflict": "Same idempotency_key with different amount, currency, or intent — use a new key", "insufficient_permissions": "project membership read + payments cap for scope=user buyer checkout; project write only for scope=project treasury charges", "invalid_amount": "payments.get_balance — amount must be positive major units", "invalid_currency": "payments.list_methods — currency code from supported methods", "invalid_order": "IAP order row missing price — shop.checkout.create again", "invalid_parameters": "payments.get_balance first — amount, currency, method_id required for AgentPay", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "order_already_fulfilled": "shop.orders.get — do not replay payments.create for fulfilled orders", "order_amount_mismatch": "currency_pack with metadata.order_id — amount must match shop.checkout.create server price (shared.commerce.iap_payment_bind)", "order_currency_mismatch": "currency must match IAP order snapshot from shop.checkout.create", "order_not_found": "shop.checkout.create first — metadata.order_id must be a live IAP order", "order_not_payable": "shop.orders.get — order status must be pending_payment or created", "order_project_mismatch": "recipient_project_id must match order project_id — context.project_id for tenant IAP", "order_sku_mismatch": "metadata.sku_id must match order sku_id from checkout", "order_user_mismatch": "Payer user_id must match order.user_id — auth.get_profile", "payment_create_in_progress": "Another create is in flight for this idempotency_key — poll payments.get or wait", "payment_order_mismatch": "payments.create metadata.order_id must match checkout order_id before shop.fulfill", "preferred_method_required": "payments.list_methods — pass preferred_method from catalog", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with payments in service_caps — operator key lacks payments cap", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "treasury_lane_required": "Tenant treasury sale needs metadata.funding_lane=treasury — personal L0 uses AgentPay recipient", "unsupported_payment_method": "payments.list_methods — pick a method enabled for this PID", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "AgentPay card/treasury — not hosted game IAP (shop.checkout.create). Poll payments.get until wallet_credit=ok. Tenant currency_pack only with metadata.order_id from shop checkout."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "payments", "execution_class": "cheap", "genetic_tags": ["core.mcp.payments.gen1", "core.commerce.soft_currency_grant.gen1"], "id": "payments.create", "mutation_risk": "low", "related_tools": ["payments.get", "payments.get_balance", "payments.list_transactions"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments Create", "when_blocked": {"catalog_auth_required": "IAP catalog is owner-only — auth.get_profile then shop.products.list; or enable iap_public_catalog in commerce DNA for hosted buyers", "client_amount_forbidden": "Omit amount/amount_minor — server prices from SKU; shop.checkout.create or payments metadata from catalog", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "payments.get_balance then retry same idempotency_key; diagnose if repeats", "feature_gate_denied": "buffs.get_effective_limits — plan tier blocks checkout; upgrade_url or buffs grant", "forbidden_for_visitor": "Hosted visitor — provision auth or use shop.checkout.create for IAP; not wallets.deposit from anon cookie", "iap_order_required": "shop.checkout.create — order_id only on currency_pack from that checkout; intent sale with metadata.order_id is rejected (iap_order_required)", "idempotency_conflict": "Same idempotency_key with different amount, currency, or intent — use a new key", "insufficient_permissions": "project membership read + payments cap for scope=user buyer checkout; project write only for scope=project treasury charges", "invalid_amount": "payments.get_balance — amount must be positive major units", "invalid_currency": "payments.list_methods — currency code from supported methods", "invalid_order": "IAP order row missing price — shop.checkout.create again", "invalid_parameters": "payments.get_balance first — amount, currency, method_id required for AgentPay", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "order_already_fulfilled": "shop.orders.get — do not replay payments.create for fulfilled orders", "order_amount_mismatch": "currency_pack with metadata.order_id — amount must match shop.checkout.create server price (shared.commerce.iap_payment_bind)", "order_currency_mismatch": "currency must match IAP order snapshot from shop.checkout.create", "order_not_found": "shop.checkout.create first — metadata.order_id must be a live IAP order", "order_not_payable": "shop.orders.get — order status must be pending_payment or created", "order_project_mismatch": "recipient_project_id must match order project_id — context.project_id for tenant IAP", "order_sku_mismatch": "metadata.sku_id must match order sku_id from checkout", "order_user_mismatch": "Payer user_id must match order.user_id — auth.get_profile", "payment_create_in_progress": "Another create is in flight for this idempotency_key — poll payments.get or wait", "payment_order_mismatch": "payments.create metadata.order_id must match checkout order_id before shop.fulfill", "preferred_method_required": "payments.list_methods — pass preferred_method from catalog", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with payments in service_caps — operator key lacks payments cap", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "treasury_lane_required": "Tenant treasury sale needs metadata.funding_lane=treasury — personal L0 uses AgentPay recipient", "unsupported_payment_method": "payments.list_methods — pick a method enabled for this PID", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "AgentPay card/treasury — not hosted game IAP (shop.checkout.create). Poll payments.get until wallet_credit=ok. Tenant currency_pack only with metadata.order_id from shop checkout."}, "commerce_atoms": {"CHECKOUT_TIER_GATE": "payments.create blocked by feature gate — buffs.get_effective_limits; payments.get_balance and payments.list_methods before retry.", "COMMERCE_BUFFS_LINK": "Tenant subscription checkout auto-grants via webhook/C24 — not buffs.apply_buff after payments.create.", "COMMERCE_SOFT_CURRENCY": "Hosted /s/{pid}/ game IAP: shop.products.list → shop.checkout.create (server price). Operator/direct: payments.create intent=currency_pack with metadata.order_id when bound. Not wallets.deposit or commerce.participant.grant_holding for buyers.", "WALLET_VS_CHECKOUT": "Wallet moves: wallets.deposit / wallets.transfer. Hosted IAP checkout: shop.checkout.create. AgentPay card/treasury: payments.create."}, "do_not_use_when": "Not buyer-facing IAP on /s/{pid}/ — use shop.checkout.create. Tenant subscription checkout auto-grants via webhook/C24 — not buffs.apply_buff after create. Hosted /s/ game IAP: shop.checkout.create only — not bare payments.create currency_pack. Internal bind after checkout may carry metadata.order_id + server grant_amount (PAY-01). Platform operator (PID=1): buffs.grant_subscription. Tenant manual (PID>1, write): buffs.grant_tenant_subscription. Tenant paid: webhook/C24 auto-grant. Inventory: commerce.participant.grant_holding.", "domain": "payments", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Creates AgentPay charge; idempotency_key enables safe replay — poll payments.get until wallet_credit=ok.", "execution_class": "cheap", "kind": "mutate", "mutates_when": "always", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Create a payment with minimal required information", "name": "Create a simple payment", "request": {"amount": 100.0, "currency": "USD", "description": "Payment for premium subscription", "payment_method": "card"}, "response": {"data": {"amount": 100.0, "created_at": "2025-01-20T10:00:00Z", "currency": "USD", "description": "Payment for premium subscription", "payment_id": "550e8400-e29b-41d4-a716-446655440000", "status": "pending"}, "success": true}}, {"description": "Create a payment with a specific payment method", "name": "Create payment with specific method", "request": {"amount": 250.5, "currency": "EUR", "description": "Monthly service fee", "payment_method": "card"}, "response": {"data": {"amount": 250.5, "created_at": "2025-01-20T10:00:00Z", "currency": "EUR", "description": "Monthly service fee", "payment_id": "550e8400-e29b-41d4-a716-446655440001", "status": "pending"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "AgentPay card/treasury — not hosted game IAP (shop.checkout.create). Poll payments.get until wallet…", "listable": false, "mutation_kind": "entity", "navigation": ["shop.products.list", "shop.checkout.create", "payments.get"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"amount": {"description": "float - Payment amount in specified currency", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "checkout_url": {"description": "string, optional — IAP resume URL for hosted shop flows", "type": "string"}, "client_secret": {"description": "string, optional — Stripe Elements when card/stripe PSP selected", "type": "string"}, "created_at": {"description": "string - ISO 8601 timestamp when payment was created", "type": "string"}, "currency": {"description": "string - Currency code used for payment", "type": "string"}, "description": {"description": "string - Payment description if provided", "type": "string"}, "external_id": {"description": "string, optional — PSP order/payment intent id", "type": "string"}, "payment_id": {"description": "string - Unique payment identifier (UUID format). Use this ID to track payment status or retrieve payment details later", "type": "string"}, "payment_url": {"description": "string, optional — redirect checkout (Tochka/SBP)", "type": "string"}, "psp_fallback_reason": {"description": "string, optional — why redirect PSP replaced card", "type": "string"}, "psp_selected": {"description": "string, optional — stripe | tochka | sbp after capability matrix", "type": "string"}, "status": {"description": "string - Current payment status. Values: 'pending' (created, waiting for processing), 'processing' (payment is being processed), 'completed' (paid only when payments.get shows wallet_credit=ok), 'failed' (payment failed), 'cancelled' (payment was cancelled)", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Fiat is AgentPay. On-chain AGNT is agentnet.balance, not a second checkout. An empty balance is valid. Do not open a second checkout.", "receipt_rule": "Poll payments.get until wallet_credit=ok; for currency_pack also soft_currency_grant.status=ok.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.get", "payments.get_balance", "payments.list_transactions"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "rollback": [], "safe_action": "payments_create", "semantic_input_mode": "inherit_workflow", "summary": "Create a new payment transaction.", "title": "Payments Create", "tool_chains": ["payment_to_subscription", "trial_to_paid_tier", "trial_to_premium"], "verification": ["payments.get"], "verify": [{"action": "payments.get", "predicate": "named resource is visible"}], "when_blocked": {"catalog_auth_required": "IAP catalog is owner-only — auth.get_profile then shop.products.list; or enable iap_public_catalog in commerce DNA for hosted buyers", "client_amount_forbidden": "Omit amount/amount_minor — server prices from SKU; shop.checkout.create or payments metadata from catalog", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "payments.get_balance then retry same idempotency_key; diagnose if repeats", "feature_gate_denied": "buffs.get_effective_limits — plan tier blocks checkout; upgrade_url or buffs grant", "forbidden_for_visitor": "Hosted visitor — provision auth or use shop.checkout.create for IAP; not wallets.deposit from anon cookie", "iap_order_required": "shop.checkout.create — order_id only on currency_pack from that checkout; intent sale with metadata.order_id is rejected (iap_order_required)", "idempotency_conflict": "Same idempotency_key with different amount, currency, or intent — use a new key", "insufficient_permissions": "project membership read + payments cap for scope=user buyer checkout; project write only for scope=project treasury charges", "invalid_amount": "payments.get_balance — amount must be positive major units", "invalid_currency": "payments.list_methods — currency code from supported methods", "invalid_order": "IAP order row missing price — shop.checkout.create again", "invalid_parameters": "payments.get_balance first — amount, currency, method_id required for AgentPay", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "order_already_fulfilled": "shop.orders.get — do not replay payments.create for fulfilled orders", "order_amount_mismatch": "currency_pack with metadata.order_id — amount must match shop.checkout.create server price (shared.commerce.iap_payment_bind)", "order_currency_mismatch": "currency must match IAP order snapshot from shop.checkout.create", "order_not_found": "shop.checkout.create first — metadata.order_id must be a live IAP order", "order_not_payable": "shop.orders.get — order status must be pending_payment or created", "order_project_mismatch": "recipient_project_id must match order project_id — context.project_id for tenant IAP", "order_sku_mismatch": "metadata.sku_id must match order sku_id from checkout", "order_user_mismatch": "Payer user_id must match order.user_id — auth.get_profile", "payment_create_in_progress": "Another create is in flight for this idempotency_key — poll payments.get or wait", "payment_order_mismatch": "payments.create metadata.order_id must match checkout order_id before shop.fulfill", "preferred_method_required": "payments.list_methods — pass preferred_method from catalog", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with payments in service_caps — operator key lacks payments cap", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "treasury_lane_required": "Tenant treasury sale needs metadata.funding_lane=treasury — personal L0 uses AgentPay recipient", "unsupported_payment_method": "payments.list_methods — pick a method enabled for this PID", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Not buyer-facing IAP on /s/{pid}/ — use shop.checkout.create. Tenant subscription checkout auto-grants via webhook/C24 — not buffs.apply_buff after create. Hosted /s/ game IAP: shop.checkout.create only — not bare payments.create currency_pack. Internal bind after checkout may carry metadata.order_id + server grant_amount (PAY-01). Platform operator (PID=1): buffs.grant_subscription. Tenant manual (PID>1, write): buffs.grant_tenant_subscription. Tenant paid: webhook/C24 auto-grant. Inventory: commerce.participant.grant_holding.", "when_to_use": "AgentPay card/treasury — not hosted game IAP (shop.checkout.create). Poll payments.get until wallet_credit=ok. Tenant currency_pack only with metadata.order_id from shop checkout.", "write_mode": null}, {"action": "payments.list_methods", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "payments.list_methods", "related_tools": ["shop.checkout.create", "shop.products.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments List Methods", "visitor_callable": true, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Visitor-safe card/Pix probe before shop.checkout.create."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "payments.list_methods", "related_tools": ["shop.checkout.create", "shop.products.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments List Methods", "visitor_callable": true, "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Visitor-safe card/Pix probe before shop.checkout.create."}, "do_not_use_when": "AgentPay treasury checkout — hosted visitors use shop.checkout.create on /s/{pid}/.", "domain": "payments", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Visitor-safe card/Pix probe before shop.checkout.create.", "listable": false, "mutation_kind": "none", "navigation": ["shop.products.list", "shop.checkout.create", "payments.get"], "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["shop.checkout.create", "shop.products.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "payments_list_methods", "semantic_input_mode": "inherit_workflow", "summary": "Region-aware checkout methods (card, Pix probe) for hosted IAP UI. Empty methods = no PSP for that currency.", "title": "Payments List Methods", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"project_scope_mismatch": {"en-US": "context.project_id must match checkout project — auth.get_profile then bind session.", "pt-BR": "context.project_id deve bater com o checkout — auth.get_profile e bind session.", "ru-RU": "context.project_id должен совпадать с checkout — auth.get_profile и bind session."}}, "when_not_to_use": "AgentPay treasury checkout — hosted visitors use shop.checkout.create on /s/{pid}/.", "when_to_use": "Visitor-safe card/Pix probe before shop.checkout.create.", "write_mode": null}, {"action": "payments.get", "aliases": ["payments.get_status", "payments.status"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Hosted /s/ game IAP: poll shop.orders.get and checkout resume BFF — not payments.get.", "anti_patterns": ["Hosted /s/ game IAP: poll shop.orders.get and checkout resume BFF — not payments.get.", "Do not treat wallet_credit=ok alone as fulfilled IAP — wait for soft_currency_grant.status=ok (L1)."], "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.payments.gen1", "core.commerce.soft_currency_grant.gen1"], "id": "payments.get", "related_tools": ["payments.refund", "payments.list_transactions", "payments.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project membership with payments:read", "invalid_parameters": "payment_id UUID required — not order slug or asset id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "payment_id from payments.create receipt — payments.list_transactions audit", "payment_not_found": "payments.list_transactions — payment_id from payments.create receipt", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator L1 poll after AgentPay or shop-bound payment_id — wallet_credit=ok then soft_currency_grant.status=ok for IAP packs. Hosted /s/ visitors: shop.orders.get + GET /api/commerce/iap/checkout/resu"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.payments.gen1", "core.commerce.soft_currency_grant.gen1"], "id": "payments.get", "related_tools": ["payments.refund", "payments.list_transactions", "payments.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project membership with payments:read", "invalid_parameters": "payment_id UUID required — not order slug or asset id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "payment_id from payments.create receipt — payments.list_transactions audit", "payment_not_found": "payments.list_transactions — payment_id from payments.create receipt", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator L1 poll after AgentPay or shop-bound payment_id — wallet_credit=ok then soft_currency_grant.status=ok for IAP packs. Hosted /s/ visitors: shop.orders.get + GET /api/commerce/iap/checkout/resu"}, "commerce_atoms": {"CHECKOUT_TIER_GATE": "payments.create blocked by feature gate — buffs.get_effective_limits; payments.get_balance and payments.list_methods before retry.", "IAP_PAYMENT_RAILS": "Track A tenant IAP: shop.checkout.create (server price). Track B marketplace: commerce.sell.activate. Track C AgentPay subscriptions: payments.create + webhook. Track D stackscript fuel: payments.create intent stackscript_fuel_pack. See docs/operations/COMMERCE_PAYMENT_RAILS.md.", "SHOP_AGENT_CHECKLIST": "15-step shop/IAP agent checklist — enablement, server price, idempotency, effective_project_id on reads, simulate-only QA. Full text in shop_instruction_atoms.", "WALLET_VS_CHECKOUT": "Wallet moves: wallets.deposit / wallets.transfer. Hosted IAP checkout: shop.checkout.create. AgentPay card/treasury: payments.create."}, "do_not_use_when": "payments.list does not exist — use payments.get_balance or wallets.list", "domain": "payments", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve complete payment information using payment ID", "name": "Get payment by ID", "request": {"payment_id": "550e8400-e29b-41d4-a716-446655440000"}, "response": {"data": {"amount": 100.0, "created_at": "2025-01-20T10:00:00Z", "currency": "USD", "description": "Payment for premium subscription", "payment_id": "550e8400-e29b-41d4-a716-446655440000", "project_id": 1, "soft_currency_grant": {"amount": "500", "currency_code": "GOO", "status": "ok"}, "status": "completed", "updated_at": "2025-01-20T10:05:00Z", "user_id": 1, "wallet_credit": "ok"}, "success": true}}], "execution_class": "plain_read", "hosted_poll_tool": "shop.orders.get", "instruction_hint": "Operator L1 poll after AgentPay or shop-bound payment_id — wallet_credit=ok then soft_currency_gran…", "listable": false, "mutation_kind": "none", "navigation": ["payments.get_balance", "payments.get", "wallets.list"], "onboarding_tier": "domain_playbook", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Fiat is AgentPay. On-chain AGNT is agentnet.balance, not a second checkout. An empty balance is valid. Do not open a second checkout.", "receipt_rule": "Poll after payments.create. wallet_credit=ok = fiat capture (L0/L2). For GOO/IAP also require soft_currency_grant.status=ok (L1); shop checkout may show wallet_credit first — keep polling until grant ok. Provider redirect ≠ paid.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.refund", "payments.list_transactions", "payments.get_balance"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "payments_get", "semantic_input_mode": "inherit_workflow", "summary": "Payment row by payment_id — status, wallet_credit, soft_currency_grant (IAP L1), amount/currency. Hosted /s/ game buyers: shop.orders.get + checkout resume, not this tool.", "title": "Payments Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project membership with payments:read", "invalid_parameters": "payment_id UUID required — not order slug or asset id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "payment_id from payments.create receipt — payments.list_transactions audit", "payment_not_found": "payments.list_transactions — payment_id from payments.create receipt", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "payments.list does not exist — use payments.get_balance or wallets.list", "when_to_use": "Operator L1 poll after AgentPay or shop-bound payment_id — wallet_credit=ok then soft_currency_grant.status=ok for IAP packs. Hosted /s/ visitors: shop.orders.get + GET /api/commerce/iap/checkout/resu", "write_mode": null}, {"action": "payments.list_transactions", "aliases": ["wallets.list_transactions"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.list_transactions", "related_tools": ["payments.get", "payments.get_balance", "payments.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments List Transactions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project membership with payments:read", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "context.project_id bound — projects.list for a valid PID", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ledger audit for the session project — optional user_id/limit/offset. When ledger_scan_capped use next_offset (not blind offset++); total_is_lower_bound when scan cap applies. status=completed is not "}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.list_transactions", "related_tools": ["payments.get", "payments.get_balance", "payments.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments List Transactions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project membership with payments:read", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "context.project_id bound — projects.list for a valid PID", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ledger audit for the session project — optional user_id/limit/offset. When ledger_scan_capped use next_offset (not blind offset++); total_is_lower_bound when scan cap applies. status=completed is not "}, "commerce_atoms": {"IAP_PAYMENT_RAILS": "Track A tenant IAP: shop.checkout.create (server price). Track B marketplace: commerce.sell.activate. Track C AgentPay subscriptions: payments.create + webhook. Track D stackscript fuel: payments.create intent stackscript_fuel_pack. See docs/operations/COMMERCE_PAYMENT_RAILS.md.", "PAYMENTS_LIST_PAGINATION": "payments.list_transactions: use limit/offset until ledger_scan_capped; then pass next_offset from the prior response. total_is_lower_bound when scan cap applies — do not assume exact total on large ledgers.", "PAYMENTS_NO_LIST": "payments.list does not exist — use payments.get_balance, payments.get, or wallets.list."}, "do_not_use_when": "payments.list does not exist — use payments.get_balance or wallets.list", "domain": "payments", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Get all payment transactions for the current project", "name": "List transactions for current project", "request": {}, "response": {"data": {"count": 1, "project_id": 1, "transactions": [{"amount": 100.0, "created_at": "2025-01-20T10:00:00Z", "currency": "USD", "description": "Payment for premium subscription", "id": "550e8400-e29b-41d4-a716-446655440000", "method": "wallet", "status": "completed", "transaction_id": "550e8400-e29b-41d4-a716-446655440000", "type": "payment", "updated_at": "2025-01-20T10:00:00Z", "wallet_credit": "ok"}]}, "success": true}}, {"description": "Get all payment transactions for a specific project", "name": "List transactions for specific project", "request": {"project_id": 123}, "response": {"data": {"count": 0, "project_id": 123, "transactions": []}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Ledger audit for the session project — optional user_id/limit/offset. When ledger_scan_capped use n…", "listable": false, "mutation_kind": "none", "navigation": ["payments.get_balance", "payments.get", "wallets.list"], "onboarding_tier": "domain_playbook", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "receipt_rule": "status=completed is not paid until wallet_credit=ok on each row (use id as payment_id).", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.get", "payments.get_balance", "payments.create"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "payments_list_transactions", "semantic_input_mode": "inherit_workflow", "summary": "List all payment transactions for a project.", "title": "Payments List Transactions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project membership with payments:read", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "context.project_id bound — projects.list for a valid PID", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "payments.list does not exist — use payments.get_balance or wallets.list", "when_to_use": "Ledger audit for the session project — optional user_id/limit/offset. When ledger_scan_capped use next_offset (not blind offset++); total_is_lower_bound when scan cap applies. status=completed is not", "write_mode": null}, {"action": "payments.get_balance", "aliases": ["wallets.get_balance"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.get_balance", "related_tools": ["payments.create", "wallets.list", "wallets.transfer"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Payments Get Balance", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project membership with payments:read", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "context.project_id bound — projects.list for a valid PID", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "payments cap on API key — widen service_caps or use session auth", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_not_found": "wallets.list — create wallet via wallets.create before reading balance"}, "when_to_use": "Read a balance before pay or refund. Personal funds are project 1. Treasury is data.ecosystem.money. A tenant wallet is custom currency only."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.get_balance", "related_tools": ["payments.create", "wallets.list", "wallets.transfer"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Payments Get Balance", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project membership with payments:read", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "context.project_id bound — projects.list for a valid PID", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "payments cap on API key — widen service_caps or use session auth", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_not_found": "wallets.list — create wallet via wallets.create before reading balance"}, "when_to_use": "Read a balance before pay or refund. Personal funds are project 1. Treasury is data.ecosystem.money. A tenant wallet is custom currency only."}, "commerce_atoms": {"IAP_PAYMENT_RAILS": "Track A tenant IAP: shop.checkout.create (server price). Track B marketplace: commerce.sell.activate. Track C AgentPay subscriptions: payments.create + webhook. Track D stackscript fuel: payments.create intent stackscript_fuel_pack. See docs/operations/COMMERCE_PAYMENT_RAILS.md.", "PAYMENTS_NO_LIST": "payments.list does not exist — use payments.get_balance, payments.get, or wallets.list.", "SHOP_AGENT_CHECKLIST": "15-step shop/IAP agent checklist — enablement, server price, idempotency, effective_project_id on reads, simulate-only QA. Full text in shop_instruction_atoms.", "WALLET_VS_CHECKOUT": "Wallet moves: wallets.deposit / wallets.transfer. Hosted IAP checkout: shop.checkout.create. AgentPay card/treasury: payments.create."}, "do_not_use_when": "payments.list does not exist — use payments.get_balance or wallets.list", "domain": "payments", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve current wallet balance for the current project", "name": "Get balance for current project", "request": {}, "response": {"data": {"balance": 1000.0, "currency": "USD", "project_id": 1, "wallet_id": "wal_1"}, "success": true}}, {"description": "Retrieve current wallet balance for a specific project", "name": "Get balance for specific project", "request": {"project_id": 123}, "response": {"data": {"balance": 500.5, "currency": "EUR", "project_id": 123, "wallet_id": "wal_1"}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Read a balance before pay or refund. Personal funds are project 1. Treasury is data.ecosystem.money…", "listable": false, "mutation_kind": "none", "navigation": ["payments.get_balance", "payments.get", "wallets.list"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"balance": {"description": "float - Available wallet amount", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "currency": {"description": "string - Currency code", "type": "string"}, "project_id": {"description": "int - Project this balance belongs to", "type": "integer"}, "wallet_id": {"description": "id of the default wallet", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Fiat is AgentPay. On-chain AGNT is agentnet.balance, not a second checkout. An empty balance is valid. Do not open a second checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.create", "wallets.list", "wallets.transfer"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "payments_get_balance", "semantic_input_mode": "inherit_workflow", "summary": "Get current wallet balance for a project.", "title": "Payments Get Balance", "tool_chains": ["economy_setup"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project membership with payments:read", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "context.project_id bound — projects.list for a valid PID", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "payments cap on API key — widen service_caps or use session auth", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_not_found": "wallets.list — create wallet via wallets.create before reading balance"}, "when_not_to_use": "payments.list does not exist — use payments.get_balance or wallets.list", "when_to_use": "Read a balance before pay or refund. Personal funds are project 1. Treasury is data.ecosystem.money. A tenant wallet is custom currency only.", "write_mode": null}, {"action": "payments.refund", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.refund", "mutation_risk": "low", "related_tools": ["payments.create", "payments.get", "payments.list_transactions"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments Refund", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "payments write cap + project admin", "invalid_parameters": "payment_id + amount from payments.get status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "payments.get with payment_id — reverse only after wallet_credit=ok", "payment_not_found": "payments.get with payment_id from checkout receipt", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "refund_exceeds_capture": "payments.get — partial amount must be ≤ captured major units", "refund_in_progress": "Retry with same idempotency_key or poll payments.get", "refund_not_allowed": "payments.get status — refund only after capture succeeded", "refund_seller_debit_required": "commerce.refund.status — seller debit plane before refund", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reverse capture after payments.get shows wallet_credit=ok — partial refund ≤ captured major units. Debit the same lane as the credit (L0 project 1 or L2 treasury). Overlapping calls return refund_in_p"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.refund", "mutation_risk": "low", "related_tools": ["payments.create", "payments.get", "payments.list_transactions"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments Refund", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "payments write cap + project admin", "invalid_parameters": "payment_id + amount from payments.get status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "payments.get with payment_id — reverse only after wallet_credit=ok", "payment_not_found": "payments.get with payment_id from checkout receipt", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "refund_exceeds_capture": "payments.get — partial amount must be ≤ captured major units", "refund_in_progress": "Retry with same idempotency_key or poll payments.get", "refund_not_allowed": "payments.get status — refund only after capture succeeded", "refund_seller_debit_required": "commerce.refund.status — seller debit plane before refund", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reverse capture after payments.get shows wallet_credit=ok — partial refund ≤ captured major units. Debit the same lane as the credit (L0 project 1 or L2 treasury). Overlapping calls return refund_in_p"}, "do_not_use_when": "payments.list does not exist — use payments.get_balance or wallets.list", "domain": "payments", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "idempotency": "Optional idempotency_key replays cached refund; without key, 409 refund_in_progress or duplicate=true after waiter.", "instruction_hint": "Reverse capture after payments.get shows wallet_credit=ok — partial refund ≤ captured major units. …", "listable": false, "mutation_kind": "none", "navigation": ["payments.get_balance", "payments.get", "wallets.list"], "next_actions": ["payments.get"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"duplicate": {"description": "bool, when refund_in_progress waiter saw ledger payment_refunded", "type": "boolean"}, "message": {"description": "string", "type": "string"}, "payment_id": {"description": "string", "type": "string"}, "refund_amount": {"description": "number", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "status": {"description": "refunded or completed when partial", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "bool", "type": "boolean"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.create", "payments.get", "payments.list_transactions"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "rollback": [], "safe_action": "payments_refund", "semantic_input_mode": "inherit_workflow", "summary": "Reverse only after payments.get shows wallet_credit=ok. Debit that lane before any card provider.", "title": "Payments Refund", "verification": ["payments.get", "shop.orders.get"], "verify": [{"action": "payments.get", "predicate": "named resource is visible"}, {"action": "shop.orders.get", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "payments write cap + project admin", "invalid_parameters": "payment_id + amount from payments.get status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "payments.get with payment_id — reverse only after wallet_credit=ok", "payment_not_found": "payments.get with payment_id from checkout receipt", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "refund_exceeds_capture": "payments.get — partial amount must be ≤ captured major units", "refund_in_progress": "Retry with same idempotency_key or poll payments.get", "refund_not_allowed": "payments.get status — refund only after capture succeeded", "refund_seller_debit_required": "commerce.refund.status — seller debit plane before refund", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "payments.list does not exist — use payments.get_balance or wallets.list", "when_to_use": "Reverse capture after payments.get shows wallet_credit=ok — partial refund ≤ captured major units. Debit the same lane as the credit (L0 project 1 or L2 treasury). Overlapping calls return refund_in_p", "write_mode": null}, {"action": "payments.admin.put_keys", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.admin.put_keys", "related_tools": ["payments.admin.keys_preflight", "payments.list_methods"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments Admin Put Keys", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Platform ecosystem owner only — auth.get_profile on hub project 1", "insufficient_permissions": "Ecosystem admin — not tenant BYOK project keys", "invalid_parameters": "Pass stripe.secret_key and/or tochka.terminal_id+password objects", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem owner: merge Stripe/Tochka secrets into AgentPay protected.keys.payments. Same body as PUT /api/payments/admin/payments/keys."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.admin.put_keys", "related_tools": ["payments.admin.keys_preflight", "payments.list_methods"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments Admin Put Keys", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Platform ecosystem owner only — auth.get_profile on hub project 1", "insufficient_permissions": "Ecosystem admin — not tenant BYOK project keys", "invalid_parameters": "Pass stripe.secret_key and/or tochka.terminal_id+password objects", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem owner: merge Stripe/Tochka secrets into AgentPay protected.keys.payments. Same body as PUT /api/payments/admin/payments/keys."}, "do_not_use_when": "payments.list does not exist — use payments.get_balance or wallets.list", "domain": "payments", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Ecosystem owner: merge Stripe/Tochka secrets into AgentPay protected.keys.payments. Same body as PU…", "listable": false, "mutation_kind": "entity", "navigation": ["payments.get_balance", "payments.get", "wallets.list"], "onboarding_tier": "domain_playbook", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.admin.keys_preflight", "payments.list_methods"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "payments_admin_put_keys", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem-only: merge Stripe/Tochka secrets into AgentPay protected.keys.payments.", "title": "Payments Admin Put Keys", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Platform ecosystem owner only — auth.get_profile on hub project 1", "insufficient_permissions": "Ecosystem admin — not tenant BYOK project keys", "invalid_parameters": "Pass stripe.secret_key and/or tochka.terminal_id+password objects", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "payments.list does not exist — use payments.get_balance or wallets.list", "when_to_use": "Ecosystem owner: merge Stripe/Tochka secrets into AgentPay protected.keys.payments. Same body as PUT /api/payments/admin/payments/keys.", "write_mode": null}, {"action": "payments.admin.keys_preflight", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.admin.keys_preflight", "related_tools": ["payments.admin.put_keys", "payments.list_methods"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments Admin Keys Preflight", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Platform ecosystem owner only — auth.get_profile on hub project 1", "insufficient_permissions": "Ecosystem admin — probes AgentPay slice only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem owner: probe stored AgentPay PSP credentials (Stripe balance, Tochka configured) without creating a charge."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.admin.keys_preflight", "related_tools": ["payments.admin.put_keys", "payments.list_methods"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments Admin Keys Preflight", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Platform ecosystem owner only — auth.get_profile on hub project 1", "insufficient_permissions": "Ecosystem admin — probes AgentPay slice only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem owner: probe stored AgentPay PSP credentials (Stripe balance, Tochka configured) without creating a charge."}, "do_not_use_when": "payments.list does not exist — use payments.get_balance or wallets.list", "domain": "payments", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Ecosystem owner: probe stored AgentPay PSP credentials (Stripe balance, Tochka configured) without …", "listable": false, "mutation_kind": "entity", "navigation": ["payments.get_balance", "payments.get", "wallets.list"], "onboarding_tier": "domain_playbook", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.admin.put_keys", "payments.list_methods"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "payments_admin_keys_preflight", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem-only: probe stored AgentPay PSP keys (Stripe Balance.retrieve, Tochka configured).", "title": "Payments Admin Keys Preflight", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Platform ecosystem owner only — auth.get_profile on hub project 1", "insufficient_permissions": "Ecosystem admin — probes AgentPay slice only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "payments.list does not exist — use payments.get_balance or wallets.list", "when_to_use": "Ecosystem owner: probe stored AgentPay PSP credentials (Stripe balance, Tochka configured) without creating a charge.", "write_mode": null}, {"action": "scheduler.create_task", "aliases": ["scheduler.schedule_task"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not create_task to cancel — use scheduler.cancel_task."], "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.create_task", "mutation_risk": "low", "related_tools": ["scheduler.list_tasks", "scheduler.get_task", "scheduler.cancel_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Create Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; scheduler.list_tasks then scheduler.get_task receipt id", "insufficient_permissions": "rbac.check_permission or widen service_caps scheduler", "invalid_cron": "Five-field cron (minute hour day month weekday) — not interval prose", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "name_required": "Pass non-empty name before cron or execute_at", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Recurring cron or one execute_at. Timezone only shifts the next cron fire. Not Celery/BullMQ."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.create_task", "mutation_risk": "low", "related_tools": ["scheduler.list_tasks", "scheduler.get_task", "scheduler.cancel_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Create Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; scheduler.list_tasks then scheduler.get_task receipt id", "insufficient_permissions": "rbac.check_permission or widen service_caps scheduler", "invalid_cron": "Five-field cron (minute hour day month weekday) — not interval prose", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "name_required": "Pass non-empty name before cron or execute_at", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Recurring cron or one execute_at. Timezone only shifts the next cron fire. Not Celery/BullMQ."}, "channel_pass_sweep_task_example": {"cron": "15 * * * *", "enabled": true, "name": "channel_pass_sweep", "payload": {"action": "commerce.channel_pass.sweep", "project_id": "<context.project_id>"}}, "domain": "scheduler", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Create a task that runs daily at midnight", "name": "Create daily task", "request": {"command": "backup_database", "cron": "0 0 * * *", "enabled": true, "name": "Daily Backup"}, "response": {"data": {"command": "backup_database", "committed": true, "created_at": "2025-01-20T10:00:00Z", "created_by": 1, "cron": "0 0 * * *", "enabled": true, "id": "task_20250120_100000_000000", "name": "Daily Backup", "project_id": 123, "state": "ready", "task_id": "task_20250120_100000_000000"}, "success": true}}, {"description": "Create a task that runs every Monday at 9 AM", "name": "Create weekly task", "request": {"command": "generate_weekly_report", "cron": "0 9 * * 1", "enabled": true, "name": "Weekly Report"}, "response": {"data": {"command": "generate_weekly_report", "committed": true, "created_at": "2025-01-20T10:00:00Z", "created_by": 1, "cron": "0 9 * * 1", "enabled": true, "id": "task_20250120_100100_000000", "name": "Weekly Report", "project_id": 123, "state": "ready", "task_id": "task_20250120_100100_000000"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Recurring cron or one execute_at. Timezone only shifts the next cron fire. Not Celery/BullMQ.", "mutation_kind": "entity", "next_actions": ["scheduler.get_task"], "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"action_registered": {"description": "bool", "type": "boolean"}, "command": {"description": "string", "type": "string"}, "committed": {"description": "bool - true", "type": "boolean"}, "created_at": {"description": "string", "type": "string"}, "created_by": {"description": "int - creator. There is no user_id", "type": "integer"}, "cron": {"description": "string", "type": "string"}, "enabled": {"description": "bool", "type": "boolean"}, "id": {"description": "string - task_YYYYMMDD_HHMMSS_ffffff, not a UUID", "type": "string"}, "name": {"description": "string", "type": "string"}, "next_actions": {"description": "array", "items": {"type": "string"}, "type": "array"}, "project_id": {"description": "int", "type": "integer"}, "projection": {"additionalProperties": true, "description": "object - verification_action scheduler.get_task", "type": "object"}, "runnable": {"description": "bool", "type": "boolean"}, "state": {"description": "string - ready", "type": "string"}, "task_id": {"description": "string - same value as id", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_commerce_actions": ["commerce.channel_pass.configure", "commerce.channel_pass.sweep"], "related_tools": ["scheduler.list_tasks", "scheduler.get_task", "scheduler.cancel_task"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "low_write", "rollback": ["scheduler.cancel_task", "scheduler.delete_task"], "safe_action": "scheduler_create_task", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a new scheduled task for automated execution.", "title": "Create Scheduled Task", "tool_chains": ["scheduled_rewards", "payment_to_subscription", "project_bootstrap"], "verification": ["scheduler.list_tasks", "scheduler.get_task"], "verify": [{"action": "scheduler.list_tasks", "predicate": "named resource is visible"}, {"action": "scheduler.get_task", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; scheduler.list_tasks then scheduler.get_task receipt id", "insufficient_permissions": "rbac.check_permission or widen service_caps scheduler", "invalid_cron": "Five-field cron (minute hour day month weekday) — not interval prose", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "name_required": "Pass non-empty name before cron or execute_at", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Recurring cron or one execute_at. Timezone only shifts the next cron fire. Not Celery/BullMQ.", "write_mode": null}, {"action": "scheduler.get_task", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.get_task", "related_tools": ["scheduler.list_tasks", "scheduler.create_task", "scheduler.execute_task", "scheduler.update_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Get Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Current user does not have permission to view this task", "invalid_parameters": "Task ID is missing or invalid format", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task with specified ID does not exist or is not accessible", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect one task schedule and payload."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.get_task", "related_tools": ["scheduler.list_tasks", "scheduler.create_task", "scheduler.execute_task", "scheduler.update_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Get Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Current user does not have permission to view this task", "invalid_parameters": "Task ID is missing or invalid format", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task with specified ID does not exist or is not accessible", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect one task schedule and payload."}, "domain": "scheduler", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve complete task information using task ID", "name": "Get task by ID", "request": {"task_id": "task_20251230_125227_681021"}, "response": {"data": {"action": "backup_database", "command": "backup_database", "created_at": "2025-01-20T10:00:00Z", "created_by": 1, "cron": "0 0 * * *", "description": "", "effective_scope": {"env_uuid": null, "plane": "scheduler", "project_id": 123, "selection_source": "prod", "visibility": "committed"}, "enabled": true, "execute_at": "2025-01-21T00:00:00Z", "id": "task_20251230_125227_681021", "is_active": true, "name": "Daily Backup", "not_runnable_reason": null, "payload": {}, "project_id": 123, "runnable": true, "saved": true, "schedule": "0 0 * * *", "status": "created", "task_type": "recurring", "timezone": "UTC"}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Inspect one task schedule and payload.", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.list_tasks", "scheduler.create_task", "scheduler.execute_task", "scheduler.update_task"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "read", "safe_action": "scheduler_get_task", "semantic_input_mode": "inherit_workflow", "summary": "Get detailed information about a scheduled task by ID.", "title": "Scheduler Get Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Current user does not have permission to view this task", "invalid_parameters": "Task ID is missing or invalid format", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task with specified ID does not exist or is not accessible", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect one task schedule and payload.", "write_mode": null}, {"action": "scheduler.update_task", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.update_task", "mutation_risk": "low", "related_tools": ["scheduler.get_task", "scheduler.create_task", "scheduler.cancel_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Update Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions for task update", "invalid_parameters": "task_id, project_id, or task_data missing or invalid", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task not found", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Change cron or payload on existing task."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.update_task", "mutation_risk": "low", "related_tools": ["scheduler.get_task", "scheduler.create_task", "scheduler.cancel_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Update Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions for task update", "invalid_parameters": "task_id, project_id, or task_data missing or invalid", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task not found", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Change cron or payload on existing task."}, "domain": "scheduler", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Change cron or payload on existing task.", "mutation_kind": "entity", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.get_task", "scheduler.create_task", "scheduler.cancel_task"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "low_write", "safe_action": "scheduler_update_task", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Update an existing scheduler task (requires write permission).", "title": "Scheduler Update Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions for task update", "invalid_parameters": "task_id, project_id, or task_data missing or invalid", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task not found", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Change cron or payload on existing task.", "write_mode": null}, {"action": "scheduler.list_tasks", "aliases": ["scheduler.list", "scheduler.status"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.list_tasks", "related_tools": ["scheduler.get_task", "scheduler.cancel_task", "scheduler.update_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler List Tasks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Need scheduler cap on API key or project membership", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Bind context.project_id — projects.get_project", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit scheduled tasks before cancel or update."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.list_tasks", "related_tools": ["scheduler.get_task", "scheduler.cancel_task", "scheduler.update_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler List Tasks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Need scheduler cap on API key or project membership", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Bind context.project_id — projects.get_project", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit scheduled tasks before cancel or update."}, "domain": "scheduler", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Get all scheduled tasks for the current project", "name": "List tasks for current project", "request": {}, "response": {"data": {"count": 1, "effective_scope": {"env_uuid": null, "plane": "scheduler", "project_id": 123, "selection_source": "prod", "visibility": "committed"}, "has_more": false, "project_id": 123, "readiness": "ready", "tasks": [{"command": "backup_database", "created_at": "2025-01-20T10:00:00Z", "created_by": 1, "cron": "0 0 * * *", "enabled": true, "execute_at": "2025-01-21T00:00:00Z", "id": "task_20251230_125227_681021", "name": "Daily Backup", "project_id": 123, "status": "created"}], "timestamp": "2025-01-20T10:00:00Z", "total": 1}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Audit scheduled tasks before cancel or update.", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.get_task", "scheduler.cancel_task", "scheduler.update_task"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "read", "safe_action": "scheduler_list_tasks", "semantic_input_mode": "inherit_workflow", "summary": "List all scheduled tasks for a project.", "title": "Scheduler List Tasks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Need scheduler cap on API key or project membership", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Bind context.project_id — projects.get_project", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit scheduled tasks before cancel or update.", "write_mode": null}, {"action": "scheduler.execute_task", "aliases": ["scheduler.run_now"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.execute_task", "mutation_risk": "low", "related_tools": ["scheduler.get_task", "scheduler.create_task", "scheduler.list_tasks", "scheduler.get_pool_tasks", "scheduler.cancel_task"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Scheduler Execute Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Task execution failed. Check error message for details", "insufficient_permissions": "Current user does not have permission to execute this task", "invalid_parameters": "task_id or project_id missing or invalid", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_disabled": "Task is disabled and cannot be executed. Enable the task first", "task_not_found": "Task with specified ID does not exist or is not accessible", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Manual fire of scheduled task (ops/debug)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.execute_task", "mutation_risk": "low", "related_tools": ["scheduler.get_task", "scheduler.create_task", "scheduler.list_tasks", "scheduler.get_pool_tasks", "scheduler.cancel_task"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Scheduler Execute Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Task execution failed. Check error message for details", "insufficient_permissions": "Current user does not have permission to execute this task", "invalid_parameters": "task_id or project_id missing or invalid", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_disabled": "Task is disabled and cannot be executed. Enable the task first", "task_not_found": "Task with specified ID does not exist or is not accessible", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Manual fire of scheduled task (ops/debug)."}, "domain": "scheduler", "effect": {"audit_batch_allowed": true, "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Trigger immediate execution of a scheduled task", "name": "Execute task immediately", "request": {"task_id": "task_20250120_100000_000000"}, "response": {"data": {"execution": {"executed_at": "2026-10-08T12:00:00+00:00", "executed_by": 7, "result": "Task executed successfully", "status": "executed", "task_id": "task_20250120_100000_000000", "task_name": "Nightly sync"}, "success": true, "timestamp": "2026-10-08T12:00:00+00:00"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Manual fire of scheduled task (ops/debug).", "mutation_kind": "none", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"execution": {"additionalProperties": true, "description": "object - task_id, task_name, status executed, executed_at, executed_by, result string", "type": "object"}, "success": {"description": "bool - Endpoint accepted the run", "type": "boolean"}, "timestamp": {"description": "string - ISO time of this response", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.get_task", "scheduler.create_task", "scheduler.list_tasks", "scheduler.get_pool_tasks", "scheduler.cancel_task"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "low_write", "safe_action": "scheduler_execute_task", "semantic_input_mode": "inherit_workflow", "summary": "Execute a scheduled task immediately, bypassing the cron schedule.", "title": "Scheduler Execute Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Task execution failed. Check error message for details", "insufficient_permissions": "Current user does not have permission to execute this task", "invalid_parameters": "task_id or project_id missing or invalid", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_disabled": "Task is disabled and cannot be executed. Enable the task first", "task_not_found": "Task with specified ID does not exist or is not accessible", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Manual fire of scheduled task (ops/debug).", "write_mode": null}, {"action": "scheduler.get_pool_tasks", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.get_pool_tasks", "related_tools": ["scheduler.get_pool_task_details", "scheduler.delete_pool_task", "scheduler.clear_pool_tasks", "scheduler.refresh_pool"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Get Pool Tasks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Failed to retrieve pool tasks", "insufficient_permissions": "Current user does not have permission to view pool tasks", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Scheduler pool queue — ops visibility."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.get_pool_tasks", "related_tools": ["scheduler.get_pool_task_details", "scheduler.delete_pool_task", "scheduler.clear_pool_tasks", "scheduler.refresh_pool"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Get Pool Tasks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Failed to retrieve pool tasks", "insufficient_permissions": "Current user does not have permission to view pool tasks", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Scheduler pool queue — ops visibility."}, "domain": "scheduler", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve all tasks currently in the execution pool", "name": "Get all pool tasks", "request": {}, "response": {"data": {"stats": {"future_count": 0, "last_refill_time": 1737360000.0, "max_pool_size": 10000, "pool_size": 1, "ready_count": 0, "refill_interval": 1200, "upcoming_count": 1, "window_minutes": 30}, "success": true, "tasks": [{"created_at": "2025-01-20T10:00:00Z", "description": "Backup database daily", "execute_at": "2025-01-20T10:30:00Z", "logic_id": "logic-1", "name": "Daily Backup", "priority": 5, "project_id": 123, "scheduler_id": "sched-1", "task_id": "scheduler_123_abc", "task_type": "scheduler"}], "timestamp": "2025-01-20T10:00:00Z", "total": 1}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Scheduler pool queue — ops visibility.", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.get_pool_task_details", "scheduler.delete_pool_task", "scheduler.clear_pool_tasks", "scheduler.refresh_pool"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "read", "safe_action": "scheduler_get_pool_tasks", "semantic_input_mode": "inherit_workflow", "summary": "Get all tasks from the execution pool (in-memory task queue).", "title": "Scheduler Get Pool Tasks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Failed to retrieve pool tasks", "insufficient_permissions": "Current user does not have permission to view pool tasks", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Scheduler pool queue — ops visibility.", "write_mode": null}, {"action": "scheduler.get_pool_task_details", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.get_pool_task_details", "related_tools": ["scheduler.get_pool_tasks", "scheduler.delete_pool_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Get Pool Task Details", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Current user does not have permission to view this task", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task with specified ID not found in pool", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Deep inspect one pooled task."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.get_pool_task_details", "related_tools": ["scheduler.get_pool_tasks", "scheduler.delete_pool_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Get Pool Task Details", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Current user does not have permission to view this task", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task with specified ID not found in pool", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Deep inspect one pooled task."}, "domain": "scheduler", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve detailed information about a task in the execution pool", "name": "Get pool task details", "request": {"task_id": "scheduler_123_abc"}, "response": {"data": {"task": {"created_at": "2025-01-20T10:00:00Z", "execute_at": "2025-01-20T10:30:00Z", "logic_id": "123", "priority": 5, "project_id": 123, "scheduler": {"id": "abc", "name": "Daily Backup", "schedule": {"cron": "0 0 * * *"}}, "scheduler_id": "abc", "task_id": "scheduler_123_abc", "task_type": "scheduler"}}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Deep inspect one pooled task.", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.get_pool_tasks", "scheduler.delete_pool_task"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "read", "safe_action": "scheduler_get_pool_task_details", "semantic_input_mode": "inherit_workflow", "summary": "Get detailed information about a specific task from the execution pool.", "title": "Scheduler Get Pool Task Details", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Current user does not have permission to view this task", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task with specified ID not found in pool", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Deep inspect one pooled task.", "write_mode": null}, {"action": "scheduler.delete_pool_task", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.delete_pool_task", "mutation_risk": "low", "related_tools": ["scheduler.get_pool_tasks", "scheduler.clear_pool_tasks", "scheduler.cancel_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Delete Pool Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Current user does not have permission to remove this task", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task with specified ID not found in pool", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove task from scheduler pool."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.delete_pool_task", "mutation_risk": "low", "related_tools": ["scheduler.get_pool_tasks", "scheduler.clear_pool_tasks", "scheduler.cancel_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Delete Pool Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Current user does not have permission to remove this task", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task with specified ID not found in pool", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove task from scheduler pool."}, "domain": "scheduler", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Remove a task from the execution pool", "name": "Delete pool task", "request": {"task_id": "scheduler_123_abc"}, "response": {"data": {"message": "Task scheduler_123_abc removed from pool", "success": true}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Remove task from scheduler pool.", "mutation_kind": "entity", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.get_pool_tasks", "scheduler.clear_pool_tasks", "scheduler.cancel_task"], "required_cap": "scheduler", "requires_preflight": true, "risk_class": "destructive", "safe_action": "scheduler_delete_pool_task", "semantic_input_mode": "inherit_workflow", "summary": "Remove a specific task from the execution pool (does not delete from database).", "title": "Scheduler Delete Pool Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Current user does not have permission to remove this task", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task with specified ID not found in pool", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove task from scheduler pool.", "write_mode": null}, {"action": "scheduler.clear_pool_tasks", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.clear_pool_tasks", "mutation_risk": "low", "related_tools": ["scheduler.refresh_pool", "scheduler.delete_pool_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Clear Pool Tasks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Failed to clear pool", "insufficient_permissions": "Current user does not have permission to clear pool", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk clear pool — ops only."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.clear_pool_tasks", "mutation_risk": "low", "related_tools": ["scheduler.refresh_pool", "scheduler.delete_pool_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Clear Pool Tasks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Failed to clear pool", "insufficient_permissions": "Current user does not have permission to clear pool", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk clear pool — ops only."}, "domain": "scheduler", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "examples": [{"description": "Remove all tasks from the execution pool", "name": "Clear pool tasks", "request": {}, "response": {"data": {"message": "Pool cleared: 10 tasks removed", "removed_count": 10, "success": true, "timestamp": "2025-01-20T10:00:00Z"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Bulk clear pool — ops only.", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_tools": ["scheduler.refresh_pool", "scheduler.delete_pool_task"], "required_cap": "scheduler", "requires_preflight": true, "risk_class": "destructive", "safe_action": "scheduler_clear_pool_tasks", "semantic_input_mode": "inherit_workflow", "summary": "Clear all tasks from the execution pool (does not delete from database).", "title": "Scheduler Clear Pool Tasks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Failed to clear pool", "insufficient_permissions": "Current user does not have permission to clear pool", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk clear pool — ops only.", "write_mode": null}, {"action": "scheduler.refresh_pool", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.refresh_pool", "mutation_risk": "low", "related_tools": ["scheduler.get_pool_tasks", "scheduler.clear_pool_tasks", "scheduler.create_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Refresh Pool", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Failed to refresh pool", "insufficient_permissions": "Current user does not have permission to refresh pool", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Use this tool after creating new scheduled tasks, when you need to immediately see tasks in pool, or to force pool refresh without waiting for automatic refill"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.refresh_pool", "mutation_risk": "low", "related_tools": ["scheduler.get_pool_tasks", "scheduler.clear_pool_tasks", "scheduler.create_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Refresh Pool", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Failed to refresh pool", "insufficient_permissions": "Current user does not have permission to refresh pool", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Use this tool after creating new scheduled tasks, when you need to immediately see tasks in pool, or to force pool refresh without waiting for automatic refill"}, "domain": "scheduler", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Force immediate refresh of scheduler pool from database", "name": "Refresh pool", "request": {}, "response": {"data": {"message": "Pool refreshed successfully", "stats": {"future_count": 1, "last_refill_time": 1737360000.0, "max_pool_size": 1000, "pool_size": 4, "ready_count": 1, "refill_interval": 300, "upcoming_count": 2, "window_minutes": 30}, "success": true, "timestamp": "2025-01-20T10:00:00Z"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Use this tool after creating new scheduled tasks, when you need to immediately see tasks in pool, o…", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.get_pool_tasks", "scheduler.clear_pool_tasks", "scheduler.create_task"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "low_write", "safe_action": "scheduler_refresh_pool", "semantic_input_mode": "inherit_workflow", "summary": "Force a refresh of the scheduler pool from the database.", "title": "Scheduler Refresh Pool", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Failed to refresh pool", "insufficient_permissions": "Current user does not have permission to refresh pool", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Use this tool after creating new scheduled tasks, when you need to immediately see tasks in pool, or to force pool refresh without waiting for automatic refill", "write_mode": null}, {"action": "scheduler.get_all_db_tasks", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.get_all_db_tasks", "related_tools": ["scheduler.list_tasks", "scheduler.get_pool_tasks"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Get All Db Tasks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Failed to retrieve tasks", "insufficient_permissions": "Current user does not have permission to view all tasks", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "DB-backed scheduler rows for migration audit."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.get_all_db_tasks", "related_tools": ["scheduler.list_tasks", "scheduler.get_pool_tasks"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Get All Db Tasks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Failed to retrieve tasks", "insufficient_permissions": "Current user does not have permission to view all tasks", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "DB-backed scheduler rows for migration audit."}, "domain": "scheduler", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve tasks with pagination", "name": "Get all tasks with pagination", "request": {"limit": 100, "offset": 0}, "response": {"data": {"limit": 100, "offset": 0, "success": true, "tasks": [{"enabled": true, "execute_at": "2025-01-20T10:30:00Z", "name": "Daily Backup", "project_id": 123, "task_id": "scheduler_123_abc", "task_type": "scheduler"}], "timestamp": "2025-01-20T10:00:00Z", "total": 1}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "DB-backed scheduler rows for migration audit.", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.list_tasks", "scheduler.get_pool_tasks"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "read", "safe_action": "scheduler_get_all_db_tasks", "semantic_input_mode": "inherit_workflow", "summary": "Get all scheduler and standalone tasks from the database (heavy operation).", "title": "Scheduler Get All Db Tasks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Failed to retrieve tasks", "insufficient_permissions": "Current user does not have permission to view all tasks", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "DB-backed scheduler rows for migration audit.", "write_mode": null}, {"action": "scheduler.cancel_task", "aliases": ["scheduler.delete"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.cancel_task", "mutation_risk": "low", "related_tools": ["scheduler.delete_pool_task", "scheduler.list_tasks"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Cancel Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin or scheduler write cap required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "scheduler.get_task with task_id from create receipt — not UUID", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Stop future runs. Then scheduler.get_task. committed=true and next_run_eligible=false means the row is stopped, not a pending projection. Do not follow cancel with scheduler.create_task."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.cancel_task", "mutation_risk": "low", "related_tools": ["scheduler.delete_pool_task", "scheduler.list_tasks"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Cancel Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin or scheduler write cap required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "scheduler.get_task with task_id from create receipt — not UUID", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Stop future runs. Then scheduler.get_task. committed=true and next_run_eligible=false means the row is stopped, not a pending projection. Do not follow cancel with scheduler.create_task."}, "domain": "scheduler", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Cancel a scheduler task", "name": "Cancel task", "request": {"project_id": 123, "task_id": "task_20250120_100000_000000"}, "response": {"data": {"committed": true, "disabled_in_db": true, "eligible": false, "enabled": false, "message": "Task task_20250120_100000_000000 cancelled (disabled)", "next_run_eligible": false, "success": true}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Stop future runs. Then scheduler.get_task. committed=true and next_run_eligible=false means the row…", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.delete_pool_task", "scheduler.list_tasks"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "low_write", "safe_action": "scheduler_cancel_task", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Cancel/remove a scheduler task (removes from pool and disables in database).", "title": "Cancel Scheduled Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin or scheduler write cap required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "scheduler.get_task with task_id from create receipt — not UUID", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Stop future runs. Then scheduler.get_task. committed=true and next_run_eligible=false means the row is stopped, not a pending projection. Do not follow cancel with scheduler.create_task.", "write_mode": null}, {"action": "scheduler.delete_task", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.delete_task", "mutation_risk": "high", "related_tools": ["scheduler.cancel_task", "scheduler.list_tasks"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Delete Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "No permission to cancel this task", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task with specified ID not found", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Same as scheduler.cancel_task — prefer cancel_task in new integrations."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.delete_task", "mutation_risk": "high", "related_tools": ["scheduler.cancel_task", "scheduler.list_tasks"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Delete Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "No permission to cancel this task", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task with specified ID not found", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Same as scheduler.cancel_task — prefer cancel_task in new integrations."}, "deprecated": "true", "domain": "scheduler", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Same as scheduler.cancel_task — prefer cancel_task in new integrations.", "mutation_kind": "entity", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preferred_action": "scheduler.cancel_task", "preflight_action": "preflight.check", "reason": "Use scheduler.cancel_task — delete_task is a legacy alias.", "related_tools": ["scheduler.cancel_task", "scheduler.list_tasks"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "scheduler_delete_task", "semantic_input_mode": "inherit_workflow", "summary": "Soft-disable alias for scheduler.cancel_task (sets enabled=false; row remains). Prefer scheduler.cancel_task for new agents.", "title": "Scheduler Delete Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "No permission to cancel this task", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task with specified ID not found", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Same as scheduler.cancel_task — prefer cancel_task in new integrations.", "write_mode": null}, {"action": "apikeys.create", "aliases": ["projects.create_api_key"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not leave service_caps null in prod.", "Do not paste operator Bearer into hosted /s/ pages."], "capability_descriptor": {"complexity": "intermediate", "domain": "apikeys", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.apikeys.gen1"], "id": "apikeys.create", "mutation_risk": "low", "related_tools": ["apikeys.list", "apikeys.delete"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Apikeys Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Internal error during key creation", "insufficient_permissions": "Caller does not have admin/owner/write role on the project", "internal_error": "Unexpected failure in PAT mint", "invalid_caps": "List required caps from discovery.describe on target domain actions", "invalid_parameters": "service_caps must be a list or comma-separated string", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "limit_exceeded": "Revoke unused keys (apikeys.delete) — max_user_api_keys", "project_required": "Pass project_id or bind context.project_id for agent PAT", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps on create — or use operator session", "service_caps_required_in_prod": "apikeys.create with preset user_full / mcp_write or explicit service_caps", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Bearer operator session or auth.login — not anonymous", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Use to provision API keys for programmatic/AI-agent access. Always set service_caps when creating keys for AI agents to limit blast radius."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "apikeys", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.apikeys.gen1"], "id": "apikeys.create", "mutation_risk": "low", "related_tools": ["apikeys.list", "apikeys.delete"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Apikeys Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Internal error during key creation", "insufficient_permissions": "Caller does not have admin/owner/write role on the project", "internal_error": "Unexpected failure in PAT mint", "invalid_caps": "List required caps from discovery.describe on target domain actions", "invalid_parameters": "service_caps must be a list or comma-separated string", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "limit_exceeded": "Revoke unused keys (apikeys.delete) — max_user_api_keys", "project_required": "Pass project_id or bind context.project_id for agent PAT", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps on create — or use operator session", "service_caps_required_in_prod": "apikeys.create with preset user_full / mcp_write or explicit service_caps", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Bearer operator session or auth.login — not anonymous", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Use to provision API keys for programmatic/AI-agent access. Always set service_caps when creating keys for AI agents to limit blast radius."}, "domain": "apikeys", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"execution_error": "Internal error during key creation", "insufficient_permissions": "Caller does not have admin/owner/write role on the project", "internal_error": "Unexpected failure in PAT mint", "invalid_parameters": "service_caps must be a list or comma-separated string", "limit_exceeded": "max_user_api_keys", "project_required": "agent PAT needs project_id", "service_caps_required_in_prod": "Explicit preset or service_caps required in production", "unauthorized": "No user on the credential"}, "examples": [{"description": "User key with explicit user_full L1 caps (never null in prod)", "name": "Full-access user PAT", "request": {"actor_kind": "user", "name": "Production Key"}, "response": {"data": {"actor_kind": "user", "api_key": "<jwt-pat>", "key_id": "550e8400-e29b-41d4-a716-446655440000", "preset": "user_full", "project_id": 123, "user_id": 1}, "success": true}}, {"description": "Safe key for an AI payment agent — blocks scheduler and analytics", "name": "Payments-only key", "request": {"name": "Payment Agent Key", "service_caps": ["payments"]}, "response": {"data": {"api_key": "<jwt-pat>", "key_id": "550e8400-e29b-41d4-a716-446655440001", "project_id": 123, "service_caps": ["payments"], "user_id": 1}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Use to provision API keys for programmatic/AI-agent access. Always set service_caps when creating k…", "mutation_kind": "entity", "next_actions": ["apikeys.list"], "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"actor_kind": {"description": "string — agent (this alias) or user", "type": "string"}, "api_key": {"description": "string — JWT PAT shown once", "type": "string"}, "created_at": {"description": "string — ISO 8601", "type": "string"}, "key_id": {"description": "string — UUID to manage/delete this key", "type": "string"}, "project_id": {"description": "int", "type": "integer"}, "service_caps": {"description": "array|null — L1 caps stored on the key", "items": {"type": "string"}, "type": "array"}, "user_id": {"description": "int", "type": "integer"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "related_tools": ["apikeys.list", "apikeys.delete"], "required_cap": "api_keys|apikeys.write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "apikeys_create", "semantic_input_mode": "inherit_workflow", "summary": "Create an **agent PAT** (unified user PAT). Postel alias of `user.apikeys.create` with actor_kind=agent.", "title": "Apikeys Create", "tool_chains": ["project_bootstrap", "multi_tenant_onboarding", "multi_tenant_onboarding"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Internal error during key creation", "insufficient_permissions": "Caller does not have admin/owner/write role on the project", "internal_error": "Unexpected failure in PAT mint", "invalid_caps": "List required caps from discovery.describe on target domain actions", "invalid_parameters": "service_caps must be a list or comma-separated string", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "limit_exceeded": "Revoke unused keys (apikeys.delete) — max_user_api_keys", "project_required": "Pass project_id or bind context.project_id for agent PAT", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps on create — or use operator session", "service_caps_required_in_prod": "apikeys.create with preset user_full / mcp_write or explicit service_caps", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Bearer operator session or auth.login — not anonymous", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Use to provision API keys for programmatic/AI-agent access. Always set service_caps when creating keys for AI agents to limit blast radius.", "write_mode": null}, {"action": "apikeys.list", "aliases": ["api_keys.list", "projects.get_api_keys"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "apikeys", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.apikeys.gen1"], "id": "apikeys.list", "related_tools": ["apikeys.create", "apikeys.delete", "auth.get_profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Apikeys List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Connect MCP (G-A174) or Device Code — PAT list is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit PATs before create/delete rotation (requires api_keys cap)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "apikeys", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.apikeys.gen1"], "id": "apikeys.list", "related_tools": ["apikeys.create", "apikeys.delete", "auth.get_profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Apikeys List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Connect MCP (G-A174) or Device Code — PAT list is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit PATs before create/delete rotation (requires api_keys cap)."}, "domain": "apikeys", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"unauthorized": "No user on the credential"}, "examples": [{"description": "Get all API keys for the current project", "name": "List keys for current project", "request": {}, "response": {"data": {"count": 1, "keys": [{"actor_kind": "agent", "created_at": "2025-01-20T10:00:00Z", "key_id": "550e8400-e29b-41d4-a716-446655440000", "key_preview": "abcd1234...", "last_used_at": "2025-01-20T09:00:00Z", "name": "Production API Key", "resource_scope": {"mode": "projects", "project_ids": [123]}, "rotatable": true, "secret_exposed": false, "service_caps": ["mcp_read"], "status": "active"}], "project_id": 123}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Audit PATs before create/delete rotation (requires api_keys cap).", "mutation_kind": "none", "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "related_tools": ["apikeys.create", "apikeys.delete", "auth.get_profile"], "required_cap": "api_keys|apikeys.read", "requires_preflight": false, "risk_class": "read", "safe_action": "apikeys_list", "semantic_input_mode": "inherit_workflow", "summary": "List personal and agent PATs (alias of user.apikeys.list).", "title": "Apikeys List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Connect MCP (G-A174) or Device Code — PAT list is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit PATs before create/delete rotation (requires api_keys cap).", "write_mode": null}, {"action": "apikeys.delete", "aliases": ["apikeys.revoke", "projects.delete_api_key"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not delete before minting replacement — secret is one-time."], "capability_descriptor": {"complexity": "intermediate", "domain": "apikeys", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.apikeys.gen1"], "id": "apikeys.delete", "mutation_risk": "high", "related_tools": ["apikeys.list", "apikeys.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Apikeys Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Current user does not have permission to delete this API key", "invalid_parameters": "Pass non-empty key_id UUID", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_not_found": "key_id from apikeys.list — user-owned PAT only", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Same session that created the PAT", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke compromised key — cannot undo."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "apikeys", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.apikeys.gen1"], "id": "apikeys.delete", "mutation_risk": "high", "related_tools": ["apikeys.list", "apikeys.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Apikeys Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Current user does not have permission to delete this API key", "invalid_parameters": "Pass non-empty key_id UUID", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_not_found": "key_id from apikeys.list — user-owned PAT only", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Same session that created the PAT", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke compromised key — cannot undo."}, "domain": "apikeys", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "errors": {"insufficient_permissions": "Current user does not have permission to delete this API key", "invalid_parameters": "key_id is required", "key_not_found": "API key with specified ID does not exist or is not accessible", "unauthorized": "No user"}, "examples": [{"description": "Permanently delete an API key", "name": "Delete API key", "request": {"key_id": "550e8400-e29b-41d4-a716-446655440000"}, "response": {"data": {"deleted": true, "key_id": "550e8400-e29b-41d4-a716-446655440000"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Revoke compromised key — cannot undo.", "mutation_kind": "entity", "next_actions": ["apikeys.list"], "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_tools": ["apikeys.list", "apikeys.create"], "required_cap": "api_keys|apikeys.write", "requires_preflight": true, "risk_class": "destructive", "safe_action": "apikeys_delete", "semantic_input_mode": "inherit_workflow", "summary": "Delete an API key permanently.", "title": "Apikeys Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Current user does not have permission to delete this API key", "invalid_parameters": "Pass non-empty key_id UUID", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_not_found": "key_id from apikeys.list — user-owned PAT only", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Same session that created the PAT", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke compromised key — cannot undo.", "write_mode": null}, {"action": "apikeys.update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.apikeys.gen1"], "id": "apikeys.update", "mutation_risk": "low", "related_tools": ["user.apikeys.update", "apikeys.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Apikeys Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Same as user.apikeys.update."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.apikeys.gen1"], "id": "apikeys.update", "mutation_risk": "low", "related_tools": ["user.apikeys.update", "apikeys.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Apikeys Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Same as user.apikeys.update."}, "domain": "apikeys", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Same as user.apikeys.update.", "mutation_kind": "entity", "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "related_tools": ["user.apikeys.update", "apikeys.list"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "apikeys_update", "semantic_input_mode": "inherit_workflow", "summary": "Alias of user.apikeys.update — update PAT name/status.", "title": "Apikeys Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Same as user.apikeys.update.", "write_mode": null}, {"action": "admin.data.health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.data.health", "related_tools": ["admin.data.people", "admin.data.dna_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Data Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Diagnose empty admin lists vs live DB without opening the SPA."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.data.health", "related_tools": ["admin.data.people", "admin.data.dna_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Data Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Diagnose empty admin lists vs live DB without opening the SPA."}, "domain": "admin", "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Diagnose empty admin lists vs live DB without opening the SPA.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "plane_chooser": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "related_tools": ["admin.data.people", "admin.data.dna_list"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "admin_data_health", "semantic_input_mode": "inherit_workflow", "summary": "Cheap counts for platform admin data plane (projects/users DNA slices).", "title": "Admin Data Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Diagnose empty admin lists vs live DB without opening the SPA.", "write_mode": null}, {"action": "admin.data.people", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.data.people", "related_tools": ["admin.data.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Data People", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify Access hub users/projects payloads for ecosystem owner."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.data.people", "related_tools": ["admin.data.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Data People", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify Access hub users/projects payloads for ecosystem owner."}, "domain": "admin", "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Verify Access hub users/projects payloads for ecosystem owner.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "plane_chooser": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "related_tools": ["admin.data.health"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "admin_data_people", "semantic_input_mode": "inherit_workflow", "summary": "Admin people bundle: projects (list shape) + users for a project.", "title": "Admin Data People", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify Access hub users/projects payloads for ecosystem owner.", "write_mode": null}, {"action": "admin.data.dna_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.data.dna_list", "related_tools": ["admin.data.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Data Dna List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compare dna-list totals with UI table row counts."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.data.dna_list", "related_tools": ["admin.data.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Data Dna List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compare dna-list totals with UI table row counts."}, "domain": "admin", "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Compare dna-list totals with UI table row counts.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "plane_chooser": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "related_tools": ["admin.data.health"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "admin_data_dna_list", "semantic_input_mode": "inherit_workflow", "summary": "Paginated DNA list with unified_8dna_role filters for admin Data hub.", "title": "Admin Data Dna List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compare dna-list totals with UI table row counts.", "write_mode": null}, {"action": "admin.database.schema_inventory", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.database.schema_inventory", "related_tools": ["admin.database.integrity_8dna", "admin.database.migrations_ledger"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Database Schema Inventory", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Diagnose canonical drift without opening Ops database tab."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.database.schema_inventory", "related_tools": ["admin.database.integrity_8dna", "admin.database.migrations_ledger"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Database Schema Inventory", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Diagnose canonical drift without opening Ops database tab."}, "doc_audience": "operator", "domain": "admin", "domain_title": "Admin Database MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_database.gen1"], "instruction_hint": "Diagnose canonical drift without opening Ops database tab.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_database", "owner_gene": "core.mcp.admin_database.gen1", "plane": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "plane_chooser": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "related_tools": ["admin.database.integrity_8dna", "admin.database.migrations_ledger"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "admin_database_schema_inventory", "semantic_input_mode": "inherit_workflow", "summary": "Full schema health report (static drift + live inventory + registry).", "title": "Admin Database Schema Inventory", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Diagnose canonical drift without opening Ops database tab.", "write_mode": null}, {"action": "admin.database.integrity_8dna", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.database.integrity_8dna", "related_tools": ["admin.database.schema_inventory"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Database Integrity 8Dna", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify unified 8DNA graph health after migrations."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.database.integrity_8dna", "related_tools": ["admin.database.schema_inventory"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Database Integrity 8Dna", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify unified 8DNA graph health after migrations."}, "domain": "admin", "domain_title": "Admin Database MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_database.gen1"], "instruction_hint": "Verify unified 8DNA graph health after migrations.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_database", "owner_gene": "core.mcp.admin_database.gen1", "plane": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "plane_chooser": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "related_tools": ["admin.database.schema_inventory"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "admin_database_integrity_8dna", "semantic_input_mode": "inherit_workflow", "summary": "Live 8DNA integrity scan (orphans, cycles, legacy parity).", "title": "Admin Database Integrity 8Dna", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify unified 8DNA graph health after migrations.", "write_mode": null}, {"action": "admin.database.migration_flags", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.database.migration_flags", "related_tools": ["admin.database.schema_inventory", "admin.database.migrations_ledger"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Database Migration Flags", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Check migrate_013 / migrate_018 toggles before schema sync."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.database.migration_flags", "related_tools": ["admin.database.schema_inventory", "admin.database.migrations_ledger"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Database Migration Flags", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Check migrate_013 / migrate_018 toggles before schema sync."}, "domain": "admin", "domain_title": "Admin Database MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_database.gen1"], "instruction_hint": "Check migrate_013 / migrate_018 toggles before schema sync.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_database", "owner_gene": "core.mcp.admin_database.gen1", "plane": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "plane_chooser": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "related_tools": ["admin.database.schema_inventory", "admin.database.migrations_ledger"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "admin_database_migration_flags", "semantic_input_mode": "inherit_workflow", "summary": "Read opt-in platform_db_init flags from data.config.database_migrations.", "title": "Admin Database Migration Flags", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Check migrate_013 / migrate_018 toggles before schema sync.", "write_mode": null}, {"action": "admin.database.migrations_ledger", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.database.migrations_ledger", "related_tools": ["admin.database.schema_inventory"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Database Migrations Ledger", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Confirm which migrate_* steps applied on this environment."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.database.migrations_ledger", "related_tools": ["admin.database.schema_inventory"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Database Migrations Ledger", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Confirm which migrate_* steps applied on this environment."}, "domain": "admin", "domain_title": "Admin Database MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_database.gen1"], "instruction_hint": "Confirm which migrate_* steps applied on this environment.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_database", "owner_gene": "core.mcp.admin_database.gen1", "plane": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "plane_chooser": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "related_tools": ["admin.database.schema_inventory"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "admin_database_migrations_ledger", "semantic_input_mode": "inherit_workflow", "summary": "Recent platform_schema_migrations ledger rows.", "title": "Admin Database Migrations Ledger", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Confirm which migrate_* steps applied on this environment.", "write_mode": null}, {"action": "agentnet.balance", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.balance", "related_tools": ["wallets.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Balance", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "AGNT balance read needs project membership — not a substitute for payments.get_balance.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "When an agent must read an on-ledger AGNT balance (L0 ledger). For JSON wallet balances use wallets.* / finance hub — not agentnet.balance."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.balance", "related_tools": ["wallets.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Balance", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "AGNT balance read needs project membership — not a substitute for payments.get_balance.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "When an agent must read an on-ledger AGNT balance (L0 ledger). For JSON wallet balances use wallets.* / finance hub — not agentnet.balance."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "AGNT balance read needs project membership — not a substitute for payments.get_balance.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "When an agent must read an on-ledger AGNT balance (L0 ledger). For JSON wallet balances use wallets…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "related_tools": ["wallets.list"], "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_balance", "semantic_input_mode": "inherit_workflow", "summary": "Read AGNT balance from the L0 PostgreSQL ledger for a project slice (not JSON 8DNA wallets).", "title": "Agentnet Balance", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "AGNT balance read needs project membership — not a substitute for payments.get_balance.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "When an agent must read an on-ledger AGNT balance (L0 ledger). For JSON wallet balances use wallets.* / finance hub — not agentnet.balance.", "write_mode": null}, {"action": "agentnet.batch_proof", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.batch_proof", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Batch Proof", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "batch_id from agentnet.post_batch or checkpoint list — confirm project_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "entry_sort_index out of range for batch."}, "when_to_use": "Receipts, audits, or clients verifying a batch leg against the stored Merkle root."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.batch_proof", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Batch Proof", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "batch_id from agentnet.post_batch or checkpoint list — confirm project_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "entry_sort_index out of range for batch."}, "when_to_use": "Receipts, audits, or clients verifying a batch leg against the stored Merkle root."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "batch_id from agentnet.post_batch or checkpoint list — confirm project_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "entry_sort_index out of range for batch."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Receipts, audits, or clients verifying a batch leg against the stored Merkle root.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_batch_proof", "semantic_input_mode": "inherit_workflow", "summary": "Merkle inclusion paths for a posted AGNT ledger batch (read-only).", "title": "Agentnet Batch Proof", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "batch_id from agentnet.post_batch or checkpoint list — confirm project_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "entry_sort_index out of range for batch."}, "when_to_use": "Receipts, audits, or clients verifying a batch leg against the stored Merkle root.", "write_mode": null}, {"action": "agentnet.checkpoint.covering_batch", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.checkpoint.covering_batch", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Checkpoint Covering Batch", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id and batch_id must be positive integers.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "No checkpoint epoch covers batch_id — list_recent or post_batch first.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator diagnostics: which epoch/checkpoint anchors a given batch without building a full proof."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.checkpoint.covering_batch", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Checkpoint Covering Batch", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id and batch_id must be positive integers.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "No checkpoint epoch covers batch_id — list_recent or post_batch first.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator diagnostics: which epoch/checkpoint anchors a given batch without building a full proof."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id and batch_id must be positive integers.", "not_found": "No checkpoint epoch covers batch_id — list_recent or post_batch first.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Operator diagnostics: which epoch/checkpoint anchors a given batch without building a full proof.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_checkpoint_covering_batch", "semantic_input_mode": "inherit_workflow", "summary": "Resolve the newest checkpoint epoch that covers a ledger ``batch_id`` (read-only).", "title": "Agentnet Checkpoint Covering Batch", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id and batch_id must be positive integers.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "No checkpoint epoch covers batch_id — list_recent or post_batch first.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator diagnostics: which epoch/checkpoint anchors a given batch without building a full proof.", "write_mode": null}, {"action": "agentnet.checkpoint.list_recent", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.checkpoint.list_recent", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Checkpoint List Recent", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id required; limit capped at 200.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator dashboards: epoch, batch id range, anchor status without downloading full batch root JSON."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.checkpoint.list_recent", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Checkpoint List Recent", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id required; limit capped at 200.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator dashboards: epoch, batch id range, anchor status without downloading full batch root JSON."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id required; limit capped at 200.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Operator dashboards: epoch, batch id range, anchor status without downloading full batch root JSON.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_checkpoint_list_recent", "semantic_input_mode": "inherit_workflow", "summary": "List recent AGNT ledger checkpoint epochs for a project (newest first; no ``batch_roots_json``).", "title": "Agentnet Checkpoint List Recent", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id required; limit capped at 200.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator dashboards: epoch, batch id range, anchor status without downloading full batch root JSON.", "write_mode": null}, {"action": "agentnet.checkpoint.by_epoch", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.checkpoint.by_epoch", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Checkpoint By Epoch", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id and non-negative epoch required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown epoch — agentnet.checkpoint.list_recent for valid epochs.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Auditor random access to a specific epoch without scanning list_recent."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.checkpoint.by_epoch", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Checkpoint By Epoch", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id and non-negative epoch required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown epoch — agentnet.checkpoint.list_recent for valid epochs.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Auditor random access to a specific epoch without scanning list_recent."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id and non-negative epoch required.", "not_found": "Unknown epoch — agentnet.checkpoint.list_recent for valid epochs.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Auditor random access to a specific epoch without scanning list_recent.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_checkpoint_by_epoch", "semantic_input_mode": "inherit_workflow", "summary": "Fetch one checkpoint row by epoch (includes ``batch_roots_json`` when stored).", "title": "Agentnet Checkpoint By Epoch", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id and non-negative epoch required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown epoch — agentnet.checkpoint.list_recent for valid epochs.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Auditor random access to a specific epoch without scanning list_recent.", "write_mode": null}, {"action": "agentnet.post_batch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.post_batch", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Post Batch", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Lines must balance — agentnet.compute_credits.quote before purchase."}, "when_to_use": "Treasury mint / internal settlement robots that must hit L0, not JSON wallets."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.post_batch", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Post Batch", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Lines must balance — agentnet.compute_credits.quote before purchase."}, "when_to_use": "Treasury mint / internal settlement robots that must hit L0, not JSON wallets."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "Lines must balance — agentnet.compute_credits.quote before purchase."}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Treasury mint / internal settlement robots that must hit L0, not JSON wallets.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin_post|project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agentnet_post_batch", "semantic_input_mode": "inherit_workflow", "summary": "Post a double-entry AGNT ledger batch (idempotent per ``idempotency_key``).", "title": "Agentnet Post Batch", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Lines must balance — agentnet.compute_credits.quote before purchase."}, "when_to_use": "Treasury mint / internal settlement robots that must hit L0, not JSON wallets.", "write_mode": null}, {"action": "agentnet.compute_credits.quote", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.compute_credits.quote", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Compute Credits Quote", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "credits_atomic must be positive — check buyer_user_id scope."}, "when_to_use": "Before purchasing compute credits; pairs with ``agentnet.compute_credits.purchase``."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.compute_credits.quote", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Compute Credits Quote", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "credits_atomic must be positive — check buyer_user_id scope."}, "when_to_use": "Before purchasing compute credits; pairs with ``agentnet.compute_credits.purchase``."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "credits_atomic must be positive — check buyer_user_id scope."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Before purchasing compute credits; pairs with ``agentnet.compute_credits.purchase``.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_compute_credits_quote", "semantic_input_mode": "inherit_workflow", "summary": "Deterministic quote for AGNT cost of compute credits (demo v1 rate table).", "title": "Agentnet Compute Credits Quote", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "credits_atomic must be positive — check buyer_user_id scope."}, "when_to_use": "Before purchasing compute credits; pairs with ``agentnet.compute_credits.purchase``.", "write_mode": null}, {"action": "agentnet.compute_credits.purchase", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.compute_credits.purchase", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Compute Credits Purchase", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Quote expired or credits mismatch — re-run compute_credits.quote."}, "when_to_use": "Demo purchase path for AGNT-backed runtime credits. When ECONOMY_CRYPTO_MODE=off, prefer builder_energy / payments rails for fiat-first deploys."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.compute_credits.purchase", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Compute Credits Purchase", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Quote expired or credits mismatch — re-run compute_credits.quote."}, "when_to_use": "Demo purchase path for AGNT-backed runtime credits. When ECONOMY_CRYPTO_MODE=off, prefer builder_energy / payments rails for fiat-first deploys."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "Quote expired or credits mismatch — re-run compute_credits.quote."}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Demo purchase path for AGNT-backed runtime credits. When ECONOMY_CRYPTO_MODE=off, prefer builder_en…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin_post|project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agentnet_compute_credits_purchase", "semantic_input_mode": "inherit_workflow", "summary": "Purchase compute credits: AGNT user→treasury batch + idempotent ``builder_energy`` top-up.", "title": "Agentnet Compute Credits Purchase", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Quote expired or credits mismatch — re-run compute_credits.quote."}, "when_to_use": "Demo purchase path for AGNT-backed runtime credits. When ECONOMY_CRYPTO_MODE=off, prefer builder_energy / payments rails for fiat-first deploys.", "write_mode": null}, {"action": "agentnet.receipt.verify", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.receipt.verify", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Receipt Verify", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "receipt must be a JSON object; optional declared_hash hex.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Offline-ish verification of purchase or run receipts returned by the platform."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.receipt.verify", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Receipt Verify", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "receipt must be a JSON object; optional declared_hash hex.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Offline-ish verification of purchase or run receipts returned by the platform."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "receipt must be a JSON object; optional declared_hash hex.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Offline-ish verification of purchase or run receipts returned by the platform.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_receipt_verify", "semantic_input_mode": "inherit_workflow", "summary": "Verify an AGNT receipt JSON (canonical hash + optional Merkle proof + optional Ed25519).", "title": "Agentnet Receipt Verify", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "receipt must be a JSON object; optional declared_hash hex.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Offline-ish verification of purchase or run receipts returned by the platform.", "write_mode": null}, {"action": "agentnet.evidence_receipt", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.evidence_receipt", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Evidence Receipt", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id and batch_id must be positive integers.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "batch_id not found for project — confirm agentnet.post_batch.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Batch missing Merkle proof data — batch_proof first."}, "when_to_use": "Operator or auditor needs checkpoint-linked proof bundle for a batch."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.evidence_receipt", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Evidence Receipt", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id and batch_id must be positive integers.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "batch_id not found for project — confirm agentnet.post_batch.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Batch missing Merkle proof data — batch_proof first."}, "when_to_use": "Operator or auditor needs checkpoint-linked proof bundle for a batch."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id and batch_id must be positive integers.", "not_found": "batch_id not found for project — confirm agentnet.post_batch.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "Batch missing Merkle proof data — batch_proof first."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Operator or auditor needs checkpoint-linked proof bundle for a batch.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_evidence_receipt", "semantic_input_mode": "inherit_workflow", "summary": "Build a self-contained evidence receipt (batch proof + checkpoint prefix witness).", "title": "Agentnet Evidence Receipt", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id and batch_id must be positive integers.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "batch_id not found for project — confirm agentnet.post_batch.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Batch missing Merkle proof data — batch_proof first."}, "when_to_use": "Operator or auditor needs checkpoint-linked proof bundle for a batch.", "write_mode": null}, {"action": "agentnet.bridge.intents", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bridge.intents", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Bridge Intents", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id required; limit capped at 500.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator monitors bridge backlog."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bridge.intents", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Bridge Intents", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id required; limit capped at 500.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator monitors bridge backlog."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id required; limit capped at 500.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Operator monitors bridge backlog.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_bridge_intents", "semantic_input_mode": "inherit_workflow", "summary": "List bridge settlement intents for a project slice.", "title": "Agentnet Bridge Intents", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id required; limit capped at 500.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator monitors bridge backlog.", "write_mode": null}, {"action": "agentnet.bridge.events", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bridge.events", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Bridge Events", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id required; optional chain_id filter.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator or indexer audits on-chain events mirrored for bridge."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bridge.events", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Bridge Events", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id required; optional chain_id filter.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator or indexer audits on-chain events mirrored for bridge."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id required; optional chain_id filter.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Operator or indexer audits on-chain events mirrored for bridge.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_bridge_events", "semantic_input_mode": "inherit_workflow", "summary": "List normalized bridge chain events (relay idempotency log).", "title": "Agentnet Bridge Events", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id required; optional chain_id filter.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator or indexer audits on-chain events mirrored for bridge.", "write_mode": null}, {"action": "agentnet.bridge.supply_snapshot", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bridge.supply_snapshot", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Bridge Supply Snapshot", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id must be positive.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator supply parity / bridge health checks."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bridge.supply_snapshot", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Bridge Supply Snapshot", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id must be positive.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator supply parity / bridge health checks."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id must be positive.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Operator supply parity / bridge health checks.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agentnet_bridge_supply_snapshot", "semantic_input_mode": "inherit_workflow", "summary": "L0 AGNT balance sum + in-flight bridge intents + optional EVM ``totalSupply`` (agUSD vault when enabled).", "title": "Agentnet Bridge Supply Snapshot", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id must be positive.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator supply parity / bridge health checks.", "write_mode": null}, {"action": "agentnet.vault.nav", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.vault.nav", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Vault Nav", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id must be positive.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator vault liquidity / share supply checks."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.vault.nav", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Vault Nav", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id must be positive.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator vault liquidity / share supply checks."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id must be positive.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Operator vault liquidity / share supply checks.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_vault_nav", "semantic_input_mode": "inherit_workflow", "summary": "ERC-4626 vault NAV (totalAssets, totalSupply). REST: GET /api/agentnet/{project_id}/vault/nav", "title": "Agentnet Vault Nav", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id must be positive.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Operator vault liquidity / share supply checks.", "write_mode": null}, {"action": "agentnet.vault.deposit_confirm", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.vault.deposit_confirm", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Vault Deposit Confirm", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project write + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "user_id, shares_atomic, underlying_usdt_atomic, idempotency_key required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Vault ledger rejected deposit — verify on-chain event."}, "when_to_use": "After vault Deposit event observed on L2."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.vault.deposit_confirm", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Vault Deposit Confirm", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project write + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "user_id, shares_atomic, underlying_usdt_atomic, idempotency_key required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Vault ledger rejected deposit — verify on-chain event."}, "when_to_use": "After vault Deposit event observed on L2."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project write + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "user_id, shares_atomic, underlying_usdt_atomic, idempotency_key required.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "Vault ledger rejected deposit — verify on-chain event."}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "After vault Deposit event observed on L2.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": true, "risk_class": "financial", "safe_action": "agentnet_vault_deposit_confirm", "semantic_input_mode": "inherit_workflow", "summary": "Credit L0 agUSD shares after ERC-4626 deposit (operator/indexer).", "title": "Agentnet Vault Deposit Confirm", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project write + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "user_id, shares_atomic, underlying_usdt_atomic, idempotency_key required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Vault ledger rejected deposit — verify on-chain event."}, "when_to_use": "After vault Deposit event observed on L2.", "write_mode": null}, {"action": "agentnet.proof_to_task", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.proof_to_task", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Proof To Task", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "agent_uuid, run_uuid, receipt_hash required from agents.run.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Portable trust anchor for agent run receipts."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.proof_to_task", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Proof To Task", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "agent_uuid, run_uuid, receipt_hash required from agents.run.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Portable trust anchor for agent run receipts."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "agent_uuid, run_uuid, receipt_hash required from agents.run.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Portable trust anchor for agent run receipts.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_proof_to_task", "semantic_input_mode": "inherit_workflow", "summary": "Build ERC-8004 proof-to-task bundle; optional on-chain validation submit.", "title": "Agentnet Proof To Task", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "agent_uuid, run_uuid, receipt_hash required from agents.run.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Portable trust anchor for agent run receipts.", "write_mode": null}, {"action": "agentnet.chain.finality_probe", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.chain.finality_probe", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Chain Finality Probe", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Unknown chain_kind or adapter error — use base | bsc_testnet | solana.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Solana tooling grant — finality mapping without production relayer."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.chain.finality_probe", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Chain Finality Probe", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Unknown chain_kind or adapter error — use base | bsc_testnet | solana.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Solana tooling grant — finality mapping without production relayer."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "solana_tool_error": "Unknown chain_kind or adapter error — use base | bsc_testnet | solana.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Solana tooling grant — finality mapping without production relayer.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_chain_finality_probe", "semantic_input_mode": "inherit_workflow", "summary": "Read-only finality label probe (Solana adapter stub + Base chain id).", "title": "Agentnet Chain Finality Probe", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Unknown chain_kind or adapter error — use base | bsc_testnet | solana.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Solana tooling grant — finality mapping without production relayer.", "write_mode": null}, {"action": "agentnet.bridge.create_intent", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bridge.create_intent", "mutation_risk": "low", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Bridge Create Intent", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project write + agentcoin_post cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "direction/chain_id/amount_atomic invalid — read bridge docs."}, "when_to_use": "Start AGNT bridge flow."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bridge.create_intent", "mutation_risk": "low", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Bridge Create Intent", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project write + agentcoin_post cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "direction/chain_id/amount_atomic invalid — read bridge docs."}, "when_to_use": "Start AGNT bridge flow."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project write + agentcoin_post cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "direction/chain_id/amount_atomic invalid — read bridge docs."}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Start AGNT bridge flow.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin_post", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agentnet_bridge_create_intent", "semantic_input_mode": "inherit_workflow", "summary": "Create bridge intent (in|out). REST: POST /api/agentnet/{project_id}/bridge/intents", "title": "Agentnet Bridge Create Intent", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project write + agentcoin_post cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "direction/chain_id/amount_atomic invalid — read bridge docs."}, "when_to_use": "Start AGNT bridge flow.", "write_mode": null}, {"action": "agentnet.funding.offer", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.funding.offer", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Funding Offer", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id and payment_id required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "payment_id has no funding offer — confirm payment_completed.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "After payment_completed to show convert-to-agUSD offer."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.funding.offer", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Funding Offer", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id and payment_id required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "payment_id has no funding offer — confirm payment_completed.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "After payment_completed to show convert-to-agUSD offer."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id and payment_id required.", "not_found": "payment_id has no funding offer — confirm payment_completed.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "After payment_completed to show convert-to-agUSD offer.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin_post", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_funding_offer", "semantic_input_mode": "inherit_workflow", "summary": "Get funding offer after R1 USDT payment (opt-in R2 vault). REST: GET funding/offer", "title": "Agentnet Funding Offer", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id and payment_id required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "payment_id has no funding offer — confirm payment_completed.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "After payment_completed to show convert-to-agUSD offer.", "write_mode": null}, {"action": "agentnet.funding.start_vault_deposit", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.funding.start_vault_deposit", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Funding Start Vault Deposit", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use fiat wallet path.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project write + agentcoin_post cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "payment_id and wallet_address required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "User explicitly converts R1 payment path to R2 vault deposit."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.funding.start_vault_deposit", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Funding Start Vault Deposit", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use fiat wallet path.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project write + agentcoin_post cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "payment_id and wallet_address required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "User explicitly converts R1 payment path to R2 vault deposit."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use fiat wallet path.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project write + agentcoin_post cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "payment_id and wallet_address required.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "User explicitly converts R1 payment path to R2 vault deposit.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin_post", "requires_preflight": true, "risk_class": "financial", "safe_action": "agentnet_funding_start_vault_deposit", "semantic_input_mode": "inherit_workflow", "summary": "Start opt-in vault deposit intent linked to payment.", "title": "Agentnet Funding Start Vault Deposit", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use fiat wallet path.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project write + agentcoin_post cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "payment_id and wallet_address required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "User explicitly converts R1 payment path to R2 vault deposit.", "write_mode": null}, {"action": "agentnet.admin.schema_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.admin.schema_status", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Admin Schema Status", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Ops verify 9/9 M+ tables without false legacy Missing alarms."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.admin.schema_status", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Admin Schema Status", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Ops verify 9/9 M+ tables without false legacy Missing alarms."}, "domain": "agentnet", "domain_title": "Agentnet Admin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Ops verify 9/9 M+ tables without false legacy Missing alarms.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_admin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_admin_schema_status", "semantic_input_mode": "inherit_workflow", "summary": "Substrate M+ schema snapshot (required / deprecated / packed_in_8dna tiers).", "title": "Agentnet Admin Schema Status", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Ops verify 9/9 M+ tables without false legacy Missing alarms.", "write_mode": null}, {"action": "agentnet.admin.launch_readiness", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.admin.launch_readiness", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Admin Launch Readiness", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Grant submit gate and weekly evidence export."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.admin.launch_readiness", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Admin Launch Readiness", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Grant submit gate and weekly evidence export."}, "domain": "agentnet", "domain_title": "Agentnet Admin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Grant submit gate and weekly evidence export.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_admin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_admin_launch_readiness", "semantic_input_mode": "inherit_workflow", "summary": "Grant Readiness Score (GRS v2), blockers, and submit_ready flag.", "title": "Agentnet Admin Launch Readiness", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Grant submit gate and weekly evidence export.", "write_mode": null}, {"action": "agentnet.admin.grant_metrics", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.admin.grant_metrics", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Admin Grant Metrics", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Attach counters to grant applications."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.admin.grant_metrics", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Admin Grant Metrics", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Attach counters to grant applications."}, "domain": "agentnet", "domain_title": "Agentnet Admin MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Attach counters to grant applications.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_admin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agentnet_admin_grant_metrics", "semantic_input_mode": "inherit_workflow", "summary": "Weekly grant metrics slice from ecosystem 8DNA (read-only).", "title": "Agentnet Admin Grant Metrics", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Attach counters to grant applications.", "write_mode": null}, {"action": "agentnet.arb.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.arb.status", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Arb Status", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "arb_tool_error": "Arbitrum Sepolia unreachable — read status before proof bundle.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Check Arbitrum grant rail before proof bundle."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.arb.status", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Arb Status", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "arb_tool_error": "Arbitrum Sepolia unreachable — read status before proof bundle.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Check Arbitrum grant rail before proof bundle."}, "domain": "agentnet", "domain_title": "Agentnet Arb MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "arb_tool_error": "Arbitrum Sepolia unreachable — read status before proof bundle.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Check Arbitrum grant rail before proof bundle.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_arb", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_arb_status", "semantic_input_mode": "inherit_workflow", "summary": "Arbitrum Sepolia rail status (RPC ping, registries).", "title": "Agentnet Arb Status", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "arb_tool_error": "Arbitrum Sepolia unreachable — read status before proof bundle.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Check Arbitrum grant rail before proof bundle.", "write_mode": null}, {"action": "agentnet.arb.proof_bundle_for_run", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.arb.proof_bundle_for_run", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Arb Proof Bundle For Run", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "arb_tool_error": "Pass agent_uuid, run_uuid, receipt_hash from agents.run output.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Arbitrum Foundation grant evidence."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.arb.proof_bundle_for_run", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Arb Proof Bundle For Run", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "arb_tool_error": "Pass agent_uuid, run_uuid, receipt_hash from agents.run output.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Arbitrum Foundation grant evidence."}, "domain": "agentnet", "domain_title": "Agentnet Arb MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "arb_tool_error": "Pass agent_uuid, run_uuid, receipt_hash from agents.run output.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Arbitrum Foundation grant evidence.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_arb", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_arb_proof_bundle_for_run", "semantic_input_mode": "inherit_workflow", "summary": "Build ERC-8004 proof-to-task bundle for a Fleet run (Arbitrum narrative).", "title": "Agentnet Arb Proof Bundle For Run", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "arb_tool_error": "Pass agent_uuid, run_uuid, receipt_hash from agents.run output.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Arbitrum Foundation grant evidence.", "write_mode": null}, {"action": "agentnet.bnb.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bnb.status", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agentnet Bnb Status", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "bnb_tool_error": "BSC testnet RPC/registry fault — read status fields before retry.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap — bind context.project_id.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Check BNBAgent integration before register or APEX jobs."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bnb.status", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agentnet Bnb Status", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "bnb_tool_error": "BSC testnet RPC/registry fault — read status fields before retry.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap — bind context.project_id.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Check BNBAgent integration before register or APEX jobs."}, "domain": "agentnet", "domain_title": "Agentnet Bnb MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "bnb_tool_error": "BSC testnet RPC/registry fault — read status fields before retry.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap — bind context.project_id.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Check BNBAgent integration before register or APEX jobs.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_bnb", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"chain_id": {"description": "EVM chain id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "enabled": {"description": "Rail enabled", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "identity_registry": {"description": "Registry contract status", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "network": {"description": "Network name", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Logical project id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "rpc_ok": {"description": "RPC health", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_bnb_status", "semantic_input_mode": "inherit_workflow", "summary": "BSC testnet rail status (RPC ping, registries).", "title": "Agentnet Bnb Status", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "bnb_tool_error": "BSC testnet RPC/registry fault — read status fields before retry.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read + agentcoin cap — bind context.project_id.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Check BNBAgent integration before register or APEX jobs.", "write_mode": null}, {"action": "agentnet.bnb.register_identity", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bnb.register_identity", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Bnb Register Identity", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "bnb_tool_error": "Call agentnet.bnb.status first; confirm agent_uuid from Fleet.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project_admin + agentcoin cap required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "On-chain discoverability for BNB grant demo."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bnb.register_identity", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Bnb Register Identity", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "bnb_tool_error": "Call agentnet.bnb.status first; confirm agent_uuid from Fleet.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project_admin + agentcoin cap required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "On-chain discoverability for BNB grant demo."}, "domain": "agentnet", "domain_title": "Agentnet Bnb MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "bnb_tool_error": "Call agentnet.bnb.status first; confirm agent_uuid from Fleet.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project_admin + agentcoin cap required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "On-chain discoverability for BNB grant demo.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_bnb", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agentnet_bnb_register_identity", "semantic_input_mode": "inherit_workflow", "summary": "Register Fleet agent on BSC ERC-8004 via BNBAgent SDK.", "title": "Agentnet Bnb Register Identity", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "bnb_tool_error": "Call agentnet.bnb.status first; confirm agent_uuid from Fleet.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project_admin + agentcoin cap required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "On-chain discoverability for BNB grant demo.", "write_mode": null}, {"action": "agentnet.bnb.proof_bundle_for_run", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bnb.proof_bundle_for_run", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Bnb Proof Bundle For Run", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "bnb_tool_error": "Run must be terminal or adapter failed — check run receipt.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "run_uuid not in Fleet — agents.run_get then retry.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "L0 proof-to-task bundle for agent run audit."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bnb.proof_bundle_for_run", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Bnb Proof Bundle For Run", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "bnb_tool_error": "Run must be terminal or adapter failed — check run receipt.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "run_uuid not in Fleet — agents.run_get then retry.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "L0 proof-to-task bundle for agent run audit."}, "domain": "agentnet", "domain_title": "Agentnet Bnb MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "bnb_tool_error": "Run must be terminal or adapter failed — check run receipt.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "run_uuid not in Fleet — agents.run_get then retry.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "L0 proof-to-task bundle for agent run audit.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_bnb", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_bnb_proof_bundle_for_run", "semantic_input_mode": "inherit_workflow", "summary": "L0 proof-to-task bundle for an agent run (read-only).", "title": "Agentnet Bnb Proof Bundle For Run", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "bnb_tool_error": "Run must be terminal or adapter failed — check run receipt.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "run_uuid not in Fleet — agents.run_get then retry.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "L0 proof-to-task bundle for agent run audit.", "write_mode": null}, {"action": "agentnet.bnb.apex_jobs_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bnb.apex_jobs_list", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Bnb Apex Jobs List", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "bnb_tool_error": "APEX index read failed — retry with lower limit.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "List runs with completed BNB APEX proof jobs."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bnb.apex_jobs_list", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Bnb Apex Jobs List", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "bnb_tool_error": "APEX index read failed — retry with lower limit.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "List runs with completed BNB APEX proof jobs."}, "domain": "agentnet", "domain_title": "Agentnet Bnb MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "bnb_tool_error": "APEX index read failed — retry with lower limit.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "List runs with completed BNB APEX proof jobs.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_bnb", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_bnb_apex_jobs_list", "semantic_input_mode": "inherit_workflow", "summary": "List agent runs with completed BNB APEX jobs (L0 events).", "title": "Agentnet Bnb Apex Jobs List", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "bnb_tool_error": "APEX index read failed — retry with lower limit.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "List runs with completed BNB APEX proof jobs.", "write_mode": null}, {"action": "agentnet.chain.rails", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.chain.rails", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Chain Rails", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "chain_control_error": "CCM rail registry fault — retry or agentnet.admin.schema_status.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Discover chain control rails before submitting intents."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.chain.rails", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Chain Rails", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "chain_control_error": "CCM rail registry fault — retry or agentnet.admin.schema_status.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Discover chain control rails before submitting intents."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "chain_control_error": "CCM rail registry fault — retry or agentnet.admin.schema_status.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Discover chain control rails before submitting intents.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_chain_rails", "semantic_input_mode": "inherit_workflow", "summary": "List enabled chain control rails (CCM).", "title": "Agentnet Chain Rails", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "chain_control_error": "CCM rail registry fault — retry or agentnet.admin.schema_status.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Discover chain control rails before submitting intents.", "write_mode": null}, {"action": "agentnet.chain.submit_intent", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.chain.submit_intent", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Chain Submit Intent", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "chain_control_error": "Gateway rejected intent — agentnet.chain.rails then unique nonce.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project_admin + agentcoin cap — bind context.project_id.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id, agent_uuid, caip2, and nonce are required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Chain-triggered Fleet run via CCM gateway."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.chain.submit_intent", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Chain Submit Intent", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "chain_control_error": "Gateway rejected intent — agentnet.chain.rails then unique nonce.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project_admin + agentcoin cap — bind context.project_id.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id, agent_uuid, caip2, and nonce are required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Chain-triggered Fleet run via CCM gateway."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "chain_control_error": "Gateway rejected intent — agentnet.chain.rails then unique nonce.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project_admin + agentcoin cap — bind context.project_id.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id, agent_uuid, caip2, and nonce are required.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Chain-triggered Fleet run via CCM gateway.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agentnet_chain_submit_intent", "semantic_input_mode": "inherit_workflow", "summary": "Submit a chain control intent (Fleet run by default).", "title": "Agentnet Chain Submit Intent", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "chain_control_error": "Gateway rejected intent — agentnet.chain.rails then unique nonce.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project_admin + agentcoin cap — bind context.project_id.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id, agent_uuid, caip2, and nonce are required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Chain-triggered Fleet run via CCM gateway.", "write_mode": null}, {"action": "agentnet.chain.intent_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.chain.intent_status", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Chain Intent Status", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "chain_control_error": "Deduplicate store read failed — retry with trace_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "intent_id unknown or wrong project — agentnet.chain.submit_intent first.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Poll intent execution after submit."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.chain.intent_status", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Chain Intent Status", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "chain_control_error": "Deduplicate store read failed — retry with trace_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "intent_id unknown or wrong project — agentnet.chain.submit_intent first.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Poll intent execution after submit."}, "domain": "agentnet", "domain_title": "Agentcoin MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "chain_control_error": "Deduplicate store read failed — retry with trace_id.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "intent_id unknown or wrong project — agentnet.chain.submit_intent first.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Poll intent execution after submit.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_chain_intent_status", "semantic_input_mode": "inherit_workflow", "summary": "Get chain intent status by intent_id.", "title": "Agentnet Chain Intent Status", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "chain_control_error": "Deduplicate store read failed — retry with trace_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "intent_id unknown or wrong project — agentnet.chain.submit_intent first.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Poll intent execution after submit.", "write_mode": null}, {"action": "agentnet.genome.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.genome.get", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Genome Get", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "internal_error": "Lineage read failed — agentnet.genome.verify for tag-only checks.", "invalid_parameters": "entity_id required (e.g. agent:{uuid}).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Verify stored lineage before on-chain commit or proof bundle."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.genome.get", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Genome Get", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "internal_error": "Lineage read failed — agentnet.genome.verify for tag-only checks.", "invalid_parameters": "entity_id required (e.g. agent:{uuid}).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Verify stored lineage before on-chain commit or proof bundle."}, "domain": "agentnet", "domain_title": "Agentnet Genome MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "internal_error": "Lineage read failed — agentnet.genome.verify for tag-only checks.", "invalid_parameters": "entity_id required (e.g. agent:{uuid}).", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Verify stored lineage before on-chain commit or proof bundle.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_genome", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_genome_get", "semantic_input_mode": "inherit_workflow", "summary": "Read L0 genome lineage entry for an entity (ecosystem.genome_lineage).", "title": "Agentnet Genome Get", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "internal_error": "Lineage read failed — agentnet.genome.verify for tag-only checks.", "invalid_parameters": "entity_id required (e.g. agent:{uuid}).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Verify stored lineage before on-chain commit or proof bundle.", "write_mode": null}, {"action": "agentnet.genome.verify", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.genome.verify", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Genome Verify", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "internal_error": "Hash verification failed — canonical JSON mismatch.", "invalid_parameters": "tag object required with GenomeTag fields.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Verify GenomeTag commit_hash matches canonical JSON."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.genome.verify", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Genome Verify", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "internal_error": "Hash verification failed — canonical JSON mismatch.", "invalid_parameters": "tag object required with GenomeTag fields.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Verify GenomeTag commit_hash matches canonical JSON."}, "domain": "agentnet", "domain_title": "Agentnet Genome MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "internal_error": "Hash verification failed — canonical JSON mismatch.", "invalid_parameters": "tag object required with GenomeTag fields.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Verify GenomeTag commit_hash matches canonical JSON.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_genome", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_genome_verify", "semantic_input_mode": "inherit_workflow", "summary": "Verify commit_hash matches canonical GenomeTag JSON.", "title": "Agentnet Genome Verify", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "internal_error": "Hash verification failed — canonical JSON mismatch.", "invalid_parameters": "tag object required with GenomeTag fields.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Verify GenomeTag commit_hash matches canonical JSON.", "write_mode": null}, {"action": "agentnet.solana.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.solana.status", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Solana Status", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required — bind context.project_id and agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Rail misconfigured or devnet unreachable — read status fields before retry.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Check Solana PTR rail before register or validation submit."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.solana.status", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Solana Status", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required — bind context.project_id and agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Rail misconfigured or devnet unreachable — read status fields before retry.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Check Solana PTR rail before register or validation submit."}, "domain": "agentnet", "domain_title": "Agentnet Solana MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required — bind context.project_id and agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "solana_tool_error": "Rail misconfigured or devnet unreachable — read status fields before retry.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Check Solana PTR rail before register or validation submit.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_solana", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_solana_status", "semantic_input_mode": "inherit_workflow", "summary": "Solana devnet PTR attestation rail status.", "title": "Agentnet Solana Status", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required — bind context.project_id and agentcoin cap.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Rail misconfigured or devnet unreachable — read status fields before retry.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Check Solana PTR rail before register or validation submit.", "write_mode": null}, {"action": "agentnet.solana.register_identity", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.solana.register_identity", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Solana Register Identity", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project_admin + agentcoin cap required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Register agentnet.solana.status first; verify agent_uuid from Fleet.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Solana grant demo identity registration."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.solana.register_identity", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Solana Register Identity", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project_admin + agentcoin cap required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Register agentnet.solana.status first; verify agent_uuid from Fleet.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Solana grant demo identity registration."}, "domain": "agentnet", "domain_title": "Agentnet Solana MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project_admin + agentcoin cap required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "solana_tool_error": "Register agentnet.solana.status first; verify agent_uuid from Fleet.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Solana grant demo identity registration.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_solana", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agentnet_solana_register_identity", "semantic_input_mode": "inherit_workflow", "summary": "Register Fleet agent metadata on Solana attestation program (devnet).", "title": "Agentnet Solana Register Identity", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "project_admin + agentcoin cap required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Register agentnet.solana.status first; verify agent_uuid from Fleet.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Solana grant demo identity registration.", "write_mode": null}, {"action": "agentnet.solana.proof_bundle_for_run", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.solana.proof_bundle_for_run", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Solana Proof Bundle For Run", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "run_uuid not found in Fleet — confirm project_id scope.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Run must be terminal — agents.run_get then retry proof_bundle_for_run.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Grant reviewer bundle reconstruction for Solana rail."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.solana.proof_bundle_for_run", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Solana Proof Bundle For Run", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "run_uuid not found in Fleet — confirm project_id scope.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Run must be terminal — agents.run_get then retry proof_bundle_for_run.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Grant reviewer bundle reconstruction for Solana rail."}, "domain": "agentnet", "domain_title": "Agentnet Solana MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "run_uuid not found in Fleet — confirm project_id scope.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "solana_tool_error": "Run must be terminal — agents.run_get then retry proof_bundle_for_run.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Grant reviewer bundle reconstruction for Solana rail.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_solana", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_solana_proof_bundle_for_run", "semantic_input_mode": "inherit_workflow", "summary": "Build proof-to-task v2 bundle for a Fleet run (Solana PTR).", "title": "Agentnet Solana Proof Bundle For Run", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Project read access required.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "run_uuid not found in Fleet — confirm project_id scope.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Run must be terminal — agents.run_get then retry proof_bundle_for_run.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Grant reviewer bundle reconstruction for Solana rail.", "write_mode": null}, {"action": "agentnet.solana.submit_validation", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.solana.submit_validation", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Solana Submit Validation", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "Missing run_id or bundle fields — re-read proof_bundle output.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Build proof via agentnet.solana.proof_bundle_for_run for the run id.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Anchor devnet tx after Fleet run completes."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.solana.submit_validation", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Solana Submit Validation", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "Missing run_id or bundle fields — re-read proof_bundle output.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Build proof via agentnet.solana.proof_bundle_for_run for the run id.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Anchor devnet tx after Fleet run completes."}, "domain": "agentnet", "domain_title": "Agentnet Solana MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "Missing run_id or bundle fields — re-read proof_bundle output.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "solana_tool_error": "Build proof via agentnet.solana.proof_bundle_for_run for the run id.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Anchor devnet tx after Fleet run completes.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_solana", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agentnet_solana_submit_validation", "semantic_input_mode": "inherit_workflow", "summary": "Submit task validation to Solana attestation program (best-effort).", "title": "Agentnet Solana Submit Validation", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "Missing run_id or bundle fields — re-read proof_bundle output.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Build proof via agentnet.solana.proof_bundle_for_run for the run id.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Anchor devnet tx after Fleet run completes.", "write_mode": null}, {"action": "agentnet.ptr.list_rails", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.ptr.list_rails", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Ptr List Rails", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Read cap on project — session_ready + project_id.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "ptr_list_error": "PTR kernel unavailable — retry; check platform agentnet config.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Discovery before multi-rail PTR anchor."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.ptr.list_rails", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Ptr List Rails", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Read cap on project — session_ready + project_id.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "ptr_list_error": "PTR kernel unavailable — retry; check platform agentnet config.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Discovery before multi-rail PTR anchor."}, "domain": "agentnet", "domain_title": "Agentnet Solana MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Read cap on project — session_ready + project_id.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "ptr_list_error": "PTR kernel unavailable — retry; check platform agentnet config.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Discovery before multi-rail PTR anchor.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_solana", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_ptr_list_rails", "semantic_input_mode": "inherit_workflow", "summary": "List enabled PTR rails (Base, BNB, Arb, Solana) with strategies.", "title": "Agentnet Ptr List Rails", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "Read cap on project — session_ready + project_id.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "ptr_list_error": "PTR kernel unavailable — retry; check platform agentnet config.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Discovery before multi-rail PTR anchor.", "write_mode": null}, {"action": "agentnet.solana.submit_intent", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.solana.submit_intent", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Solana Submit Intent", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id, agent_uuid, and nonce are required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Gateway rejected intent — agentnet.solana.status then unique nonce.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Solana CCM intent → Fleet (evidence_tier=none default)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.solana.submit_intent", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Solana Submit Intent", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id, agent_uuid, and nonce are required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Gateway rejected intent — agentnet.solana.status then unique nonce.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Solana CCM intent → Fleet (evidence_tier=none default)."}, "domain": "agentnet", "domain_title": "Agentnet Solana MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id, agent_uuid, and nonce are required.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "solana_tool_error": "Gateway rejected intent — agentnet.solana.status then unique nonce.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Solana CCM intent → Fleet (evidence_tier=none default).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_solana", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agentnet_solana_submit_intent", "semantic_input_mode": "inherit_workflow", "summary": "Submit Solana chain control intent (CCM) via gateway.", "title": "Agentnet Solana Submit Intent", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id, agent_uuid, and nonce are required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "solana_tool_error": "Gateway rejected intent — agentnet.solana.status then unique nonce.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Solana CCM intent → Fleet (evidence_tier=none default).", "write_mode": null}, {"action": "agentnet.testnet.list_profiles", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.testnet.list_profiles", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Testnet List Profiles", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Before running grant testnet scenarios or faucet mint."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.testnet.list_profiles", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Testnet List Profiles", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Before running grant testnet scenarios or faucet mint."}, "domain": "agentnet", "domain_title": "Agentnet Testnet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Before running grant testnet scenarios or faucet mint.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_testnet", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_testnet_list_profiles", "semantic_input_mode": "inherit_workflow", "summary": "List AgentNet testnet chain profiles (lanes, faucet policy).", "title": "Agentnet Testnet List Profiles", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Before running grant testnet scenarios or faucet mint.", "write_mode": null}, {"action": "agentnet.testnet.run_scenario", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.testnet.run_scenario", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Testnet Run Scenario", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Ops grant E2E from MCP without shell scripts."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.testnet.run_scenario", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Testnet Run Scenario", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Ops grant E2E from MCP without shell scripts."}, "domain": "agentnet", "domain_title": "Agentnet Testnet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Ops grant E2E from MCP without shell scripts.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_testnet", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "agentnet_testnet_run_scenario", "semantic_input_mode": "inherit_workflow", "summary": "Run a registered testnet scenario (grant demo, bridge smoke, etc.).", "title": "Agentnet Testnet Run Scenario", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Ops grant E2E from MCP without shell scripts.", "write_mode": null}, {"action": "agentnet.testnet.faucet_mint", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "L0 testnet faucet credits AGNT (rate-limited).", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.testnet.faucet_mint", "mutation_risk": "low", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Testnet Faucet Mint", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Fund buyer before grant_demo_full scenario."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "L0 testnet faucet credits AGNT (rate-limited).", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.testnet.faucet_mint", "mutation_risk": "low", "related_tools": [], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agentnet Testnet Faucet Mint", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Fund buyer before grant_demo_full scenario."}, "domain": "agentnet", "domain_title": "Agentnet Testnet MCP domain", "effect": {"conditional_mutate": "L0 testnet faucet credits AGNT (rate-limited).", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "L0 testnet faucet credits AGNT (rate-limited).", "kind": "mutate", "read_only_hint": false}, "errors": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Fund buyer before grant_demo_full scenario.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_testnet", "owner_gene": "core.agentnet.ptr_rails.gen1", "plane": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "plane_chooser": "L0 AGNT ledger (agentnet.balance, batches): not JSON wallets (wallets.*) or Finance Hub. When ECONOMY_CRYPTO_MODE=off, fiat/multi-wallet paths stay payments.* / wallets.*; bridge copy is informational only.", "platform_atoms": {"AGENTNET_PLANE_CHOOSER": "On-chain AGNT rails: agentnet.solana.status before register_identity or submit_validation. Fiat checkout stays payments.* — not agentnet.balance for marketplace card flow."}, "required_cap": "agentcoin_post", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agentnet_testnet_faucet_mint", "semantic_input_mode": "inherit_workflow", "summary": "Mint AGNT on L0 via testnet faucet (rate-limited).", "title": "Agentnet Testnet Faucet Mint", "when_blocked": {"agentcoin_schema_missing": "agentnet.admin.schema_status — migrate Substrate M+ before ledger I/O.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "Platform crypto off — use wallet_internal / payments_fiat alternatives; do not retry on-chain mutate.", "execution_error": "Retry post_batch once with same idempotency_key — else admin.launch_readiness.", "forbidden": "apikeys.create with agentcoin in service_caps — agentnet.admin.* needs ecosystem admin.", "idempotency_conflict": "Same idempotency_key with different batch body — use a new key or match prior lines.", "invalid_parameters": "project_id + account_key on balance; batch_id from agentnet.post_batch.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Confirm id from prior success — batch_proof needs posted batch_id.", "rate_limit_exceeded": "Backoff ledger writes — prefer balance/batch_proof reads.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "agentnet.post_batch lines must balance — quote before compute_credits.purchase."}, "when_to_use": "Fund buyer before grant_demo_full scenario.", "write_mode": null}, {"action": "ai_builder.manifest.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.manifest.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Manifest Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load UAM v1 manifest before compose or validate."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.manifest.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Manifest Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load UAM v1 manifest before compose or validate."}, "domain": "ai_builder", "domain_title": "Ai Builder MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Load UAM v1 manifest before compose or validate.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_builder_manifest_get", "semantic_input_mode": "inherit_workflow", "summary": "Load Unified Application Manifest (UAM v1) for the current project.", "title": "Ai Builder Manifest Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load UAM v1 manifest before compose or validate.", "write_mode": null}, {"action": "ai_builder.manifest.validate", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.manifest.validate", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Manifest Validate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Validate UAM JSON before agents.fleet bind."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.manifest.validate", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Manifest Validate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Validate UAM JSON before agents.fleet bind."}, "domain": "ai_builder", "domain_title": "Ai Builder MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Validate UAM JSON before agents.fleet bind.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_builder_manifest_validate", "semantic_input_mode": "inherit_workflow", "summary": "Validate a UAM v1 JSON object (structure + catalog + logic templates).", "title": "Ai Builder Manifest Validate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Validate UAM JSON before agents.fleet bind.", "write_mode": null}, {"action": "ai_builder.compose.preview", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.compose.preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Compose Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Deterministic compose preview (sha256 + paths)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.compose.preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Compose Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Deterministic compose preview (sha256 + paths)."}, "domain": "ai_builder", "domain_title": "Ai Builder MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Deterministic compose preview (sha256 + paths).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_builder_compose_preview", "semantic_input_mode": "inherit_workflow", "summary": "Deterministic compose preview: returns content_sha256 and file paths.", "title": "Ai Builder Compose Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Deterministic compose preview (sha256 + paths).", "write_mode": null}, {"action": "ai_builder.source.list", "ai_builder_atoms": {"AI_BUILDER_LIST_ALIAS": "ai_builder.project.list aliases to ai_builder.source.list — list App Studio src/** paths, not hosting bucket bytes.", "AI_BUILDER_SOURCE_NOT_FOUND": "not_found: ai_builder.source.list first — response may include suggested_paths. New file under src/: source.patch with content= (no prior GET). Patch ladder: source.get → copy exact find substring → expected_sha256 → replacements.", "AI_BUILDER_SOURCE_VS_HOSTING": "App Studio source tree is ai_builder.source.* under src/** — static /s/ bytes are hosting.bucket.file.patch, not ai_builder.source.patch on the live bucket."}, "aliases": ["ai_builder.project.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.source.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Source List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read the editable React tree (src/**) before patching. Does not list /s/ bucket files."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.source.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Source List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read the editable React tree (src/**) before patching. Does not list /s/ bucket files."}, "domain": "ai_builder", "domain_title": "Ai Builder MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Read the editable React tree (src/**) before patching. Does not list /s/ bucket files.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_builder_source_list", "semantic_input_mode": "inherit_workflow", "summary": "List React source files under the project App Studio tree (src/** and related). Not hosting /s/ bucket bytes.", "title": "List App Studio Source", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read the editable React tree (src/**) before patching. Does not list /s/ bucket files.", "write_mode": null}, {"action": "ai_builder.source.get", "ai_builder_atoms": {"AI_BUILDER_SOURCE_NOT_FOUND": "not_found: ai_builder.source.list first — response may include suggested_paths. New file under src/: source.patch with content= (no prior GET). Patch ladder: source.get → copy exact find substring → expected_sha256 → replacements.", "AI_BUILDER_SOURCE_VS_HOSTING": "App Studio source tree is ai_builder.source.* under src/** — static /s/ bytes are hosting.bucket.file.patch, not ai_builder.source.patch on the live bucket."}, "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.source.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Source Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id and path required (path=src/…). view=skeleton defaults to src/main.tsx.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "File missing — ai_builder.source.list; use suggested_paths when present. Create with source.patch content=.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "view=skeleton lists names. view=symbol returns matching bodies whole until 64000 characters; a longer body is truncated and is not the span to replace. A file past 64000 characters is a window; pass o"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.source.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Source Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id and path required (path=src/…). view=skeleton defaults to src/main.tsx.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "File missing — ai_builder.source.list; use suggested_paths when present. Create with source.patch content=.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "view=skeleton lists names. view=symbol returns matching bodies whole until 64000 characters; a longer body is truncated and is not the span to replace. A file past 64000 characters is a window; pass o"}, "domain": "ai_builder", "domain_title": "Ai Builder MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "view=skeleton lists names. view=symbol returns matching bodies whole until 64000 characters; a long…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_builder_source_get", "semantic_input_mode": "inherit_workflow", "summary": "Read one UTF-8 source file and its sha256.", "title": "Read App Studio Source", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id and path required (path=src/…). view=skeleton defaults to src/main.tsx.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "File missing — ai_builder.source.list; use suggested_paths when present. Create with source.patch content=.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "view=skeleton lists names. view=symbol returns matching bodies whole until 64000 characters; a longer body is truncated and is not the span to replace. A file past 64000 characters is a window; pass o", "write_mode": null}, {"action": "ai_builder.source.put", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.source.put", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Source Put", "when_blocked": {"content_shrink_blocked": "The body is one text window of a longer file. Re-read until truncated is false, or pass allow_shrink.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "digest_mismatch": "Re-read with source.get; pass current sha256.", "file_too_large": "Split file, use storage.upload, or symbols — max 2MB per App Studio path.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "literal_escape": "JSON content with \\\\n triggers literal_escape — use symbols:[{name, replace}] with real newlines or a single \\n escape in JSON.", "path_protected": "App Studio protected entry scaffolds — for Vite journal ship use hosting.workspace.init profile=node_vite, hosting.workspace.file.put, hosting.git.init then git push agentstack HEAD:dev (not ai_builder.source.* on package.json/vite.config).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "slot_marker_missing": "Keep @slot: and @endslot in src/routes/* files.", "syntax_rejected": "Fix syntax before write; prefer symbols for multi-line bodies.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create or replace one src/** file. Multi-line bodies: symbols[] or real newlines — not \\\\n in JSON (literal_escape). Call ai_builder.build.enqueue afterwards."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.source.put", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Source Put", "when_blocked": {"content_shrink_blocked": "The body is one text window of a longer file. Re-read until truncated is false, or pass allow_shrink.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "digest_mismatch": "Re-read with source.get; pass current sha256.", "file_too_large": "Split file, use storage.upload, or symbols — max 2MB per App Studio path.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "literal_escape": "JSON content with \\\\n triggers literal_escape — use symbols:[{name, replace}] with real newlines or a single \\n escape in JSON.", "path_protected": "App Studio protected entry scaffolds — for Vite journal ship use hosting.workspace.init profile=node_vite, hosting.workspace.file.put, hosting.git.init then git push agentstack HEAD:dev (not ai_builder.source.* on package.json/vite.config).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "slot_marker_missing": "Keep @slot: and @endslot in src/routes/* files.", "syntax_rejected": "Fix syntax before write; prefer symbols for multi-line bodies.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create or replace one src/** file. Multi-line bodies: symbols[] or real newlines — not \\\\n in JSON (literal_escape). Call ai_builder.build.enqueue afterwards."}, "domain": "ai_builder", "domain_title": "Ai Builder MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Create or replace one src/** file. Multi-line bodies: symbols[] or real newlines — not \\\\n in JSON …", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "ai_builder_source_put", "semantic_input_mode": "inherit_workflow", "summary": "Create or replace one source file. Does not start Vite.", "title": "Ai Builder Source Put", "when_blocked": {"content_shrink_blocked": "The body is one text window of a longer file. Re-read until truncated is false, or pass allow_shrink.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "digest_mismatch": "Re-read with source.get; pass current sha256.", "file_too_large": "Split file, use storage.upload, or symbols — max 2MB per App Studio path.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "literal_escape": "JSON content with \\\\n triggers literal_escape — use symbols:[{name, replace}] with real newlines or a single \\n escape in JSON.", "path_protected": "App Studio protected entry scaffolds — for Vite journal ship use hosting.workspace.init profile=node_vite, hosting.workspace.file.put, hosting.git.init then git push agentstack HEAD:dev (not ai_builder.source.* on package.json/vite.config).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "slot_marker_missing": "Keep @slot: and @endslot in src/routes/* files.", "syntax_rejected": "Fix syntax before write; prefer symbols for multi-line bodies.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create or replace one src/** file. Multi-line bodies: symbols[] or real newlines — not \\\\n in JSON (literal_escape). Call ai_builder.build.enqueue afterwards.", "write_mode": null}, {"action": "ai_builder.source.patch", "ai_builder_atoms": {"AI_BUILDER_LITERAL_ESCAPE": "literal_escape: use symbols:[{name, replace}] with real newlines in replace bodies — not \\\\n in JSON strings. Prefer symbol edits over full-file content rewrites.", "AI_BUILDER_MAIN_REWIRE": "Rewiring src/main.tsx imports: allow_shrink=true when removing blocks; fix syntax_rejected with smaller find/replace (one import line). Route shell lives in src/routes/Route0.tsx — not ./routes/Route0 from wrong folder.", "AI_BUILDER_SOURCE_VS_HOSTING": "App Studio source tree is ai_builder.source.* under src/** — static /s/ bytes are hosting.bucket.file.patch, not ai_builder.source.patch on the live bucket.", "AI_BUILDER_VS_GENERATION": "generation.* forks 8DNA config (bots, knowledge, project data) on paid tiers — not the hosting workspace. A browser game ships with hosting.git + hosting.site.build, not ai_builder.source.patch. sandbox_not_available on Free means upgrade for 8DNA sandbox — not a blocker for hosting workspace writes."}, "aliases": ["app.patch"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not patch assets/index-*.js — that is build output.", "Do not use hosting.bucket.file.patch for App Studio source paths.", "Do not send full-file content for large App.tsx — use symbols to avoid syntax_rejected loops.", "Do not call mcp_app_studio_create_v1 as an MCP action — it is a recipe id."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.source.patch", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Source Patch", "when_blocked": {"content_shrink_blocked": "find/replace removed too many lines — pass allow_shrink:true for intentional entrypoint shrinks, or split into smaller replacements.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "digest_mismatch": "Re-read with source.get; pass current sha256.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "literal_escape": "Use real newlines in replace bodies, not \\n literals.", "patch_apply_failed": "unified diff did not apply — source.get and retry", "path_protected": "App Studio protected entry scaffolds — for Vite journal ship use hosting.workspace.init profile=node_vite, hosting.workspace.file.put, hosting.git.init then git push agentstack HEAD:dev (not ai_builder.source.* on package.json/vite.config).", "replacement_not_found": "search_replace needs find and replace. ai_builder.source.get and confirm the substring.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "slot_marker_missing": "Keep @slot: and @endslot in src/routes/* files.", "symbol_not_found": "source.get view=skeleton to list names, then retry.", "syntax_rejected": "Fix syntax before write; try symbols or smaller replacements.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One find/replace or symbols:[{name, replace}] for a whole function. Pass expected_sha256; digest_mismatch writes nothing. A truncated source.get window is refused unless allow_shrink is true. Do not p"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.source.patch", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Source Patch", "when_blocked": {"content_shrink_blocked": "find/replace removed too many lines — pass allow_shrink:true for intentional entrypoint shrinks, or split into smaller replacements.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "digest_mismatch": "Re-read with source.get; pass current sha256.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "literal_escape": "Use real newlines in replace bodies, not \\n literals.", "patch_apply_failed": "unified diff did not apply — source.get and retry", "path_protected": "App Studio protected entry scaffolds — for Vite journal ship use hosting.workspace.init profile=node_vite, hosting.workspace.file.put, hosting.git.init then git push agentstack HEAD:dev (not ai_builder.source.* on package.json/vite.config).", "replacement_not_found": "search_replace needs find and replace. ai_builder.source.get and confirm the substring.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "slot_marker_missing": "Keep @slot: and @endslot in src/routes/* files.", "symbol_not_found": "source.get view=skeleton to list names, then retry.", "syntax_rejected": "Fix syntax before write; try symbols or smaller replacements.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One find/replace or symbols:[{name, replace}] for a whole function. Pass expected_sha256; digest_mismatch writes nothing. A truncated source.get window is refused unless allow_shrink is true. Do not p"}, "do_not_use_when": "Use this for App Studio source. Static buckets use hosting.bucket.file.patch.", "domain": "ai_builder", "domain_title": "Ai Builder MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Pass expected_sha256 from source.get. Use symbols for whole-function edits; replacements for slot text.", "name": "Symbol replace after skeleton read", "request": {"params": {"expected_sha256": "abc123…", "path": "src/routes/Route0.tsx", "symbols": [{"name": "Route0Page", "replace": "function Route0Page() {\n  return <main>@slot:page</main>;\n}\n"}]}, "tool": "ai_builder.source.patch"}, "response": {"data": {"agent_completion": {"done": true, "phase": "source"}, "path": "src/routes/Route0.tsx", "sha256": "def456…"}, "success": true}}, {"name": "Find/replace in @slot:page", "request": {"params": {"expected_sha256": "abc123…", "path": "src/routes/Route0.tsx", "replacements": [{"find": "<h1>Welcome</h1>", "replace": "<h1>Hello Studio</h1>"}]}, "tool": "ai_builder.source.patch"}, "response": {"data": {"path": "src/routes/Route0.tsx", "sha256": "…"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "One find/replace or symbols:[{name, replace}] for a whole function. Pass expected_sha256; digest_mi…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "ai_builder_source_patch", "semantic_input_mode": "inherit_workflow", "summary": "Patch one source file by replacements, a whole function, full content, or a unified diff. Never enqueues a build. Do not patch the published assets/index-*.js bundle.", "title": "Patch App Studio Source", "when_blocked": {"content_shrink_blocked": "find/replace removed too many lines — pass allow_shrink:true for intentional entrypoint shrinks, or split into smaller replacements.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "digest_mismatch": "Re-read with source.get; pass current sha256.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "literal_escape": "Use real newlines in replace bodies, not \\n literals.", "patch_apply_failed": "unified diff did not apply — source.get and retry", "path_protected": "App Studio protected entry scaffolds — for Vite journal ship use hosting.workspace.init profile=node_vite, hosting.workspace.file.put, hosting.git.init then git push agentstack HEAD:dev (not ai_builder.source.* on package.json/vite.config).", "replacement_not_found": "search_replace needs find and replace. ai_builder.source.get and confirm the substring.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "slot_marker_missing": "Keep @slot: and @endslot in src/routes/* files.", "symbol_not_found": "source.get view=skeleton to list names, then retry.", "syntax_rejected": "Fix syntax before write; try symbols or smaller replacements.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Use this for App Studio source. Static buckets use hosting.bucket.file.patch.", "when_to_use": "One find/replace or symbols:[{name, replace}] for a whole function. Pass expected_sha256; digest_mismatch writes nothing. A truncated source.get window is refused unless allow_shrink is true. Do not p", "write_mode": null}, {"action": "ai_builder.compose.apply", "ai_builder_atoms": {"AI_BUILDER_RECIPE_NOT_TOOL": "mcp_app_studio_* are recipes (executable=false) — run via recipe runner or ai_builder.compose.apply / build.enqueue, not agentstack.execute with recipe id as action."}, "aliases": ["ai_builder.create", "app.scaffold"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.compose.apply", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Compose Apply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create the React skeleton from a blueprint, then patch slots."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.compose.apply", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Compose Apply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create the React skeleton from a blueprint, then patch slots."}, "domain": "ai_builder", "domain_title": "Ai Builder MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Create the React skeleton from a blueprint, then patch slots.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "ai_builder_compose_apply", "semantic_input_mode": "inherit_workflow", "summary": "Materialize a blueprint or UAM onto the project source tree. Does not run Vite.", "title": "Ai Builder Compose Apply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create the React skeleton from a blueprint, then patch slots.", "write_mode": null}, {"action": "ai_builder.build.enqueue", "ai_builder_atoms": {"AI_BUILDER_BUILD_FAILED_RECOVERY": "Vite parse error in errors[0].file:line. source.get view=symbol, source.patch once, build.enqueue again. Browserslist/caniuse warnings are not failures.", "AI_BUILDER_RECIPE_NOT_TOOL": "mcp_app_studio_* are recipes (executable=false) — run via recipe runner or ai_builder.compose.apply / build.enqueue, not agentstack.execute with recipe id as action.", "AI_BUILDER_VS_STACKSCRIPT": "script.put / StackScript = server-side TypeScript (@stack/runtime) on DNA slice. Browser game UI/WebGL = hosting workspace + hosting.site.build, then promote_branch to prod. Do not script.put defineRoom for a Vite SPA."}, "aliases": ["ai_builder.build", "ai_builder.build.run", "ai_builder.run"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.build.enqueue", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Build Enqueue", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After source edits. Poll ai_builder.build.status. Do not wait inside agents.orchestrate."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.build.enqueue", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Build Enqueue", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After source edits. Poll ai_builder.build.status. Do not wait inside agents.orchestrate."}, "domain": "ai_builder", "domain_title": "Ai Builder MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "After source edits. Poll ai_builder.build.status. Do not wait inside agents.orchestrate.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "ai_builder_build_enqueue", "semantic_input_mode": "inherit_workflow", "summary": "App Studio Vite queue only. AI Builder is off for shipping a game — do not use this. Put sources on the hosting journal and hosting.site.build.", "title": "Ai Builder Build Enqueue", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After source edits. Poll ai_builder.build.status. Do not wait inside agents.orchestrate.", "write_mode": null}, {"action": "ai_builder.build.status", "ai_builder_atoms": {"AI_BUILDER_BUILD_FAILED_RECOVERY": "Vite parse error in errors[0].file:line. source.get view=symbol, source.patch once, build.enqueue again. Browserslist/caniuse warnings are not failures.", "AI_BUILDER_PUBLISH_BOUNDARY": "ai_builder.publish omits bucket_id when hosting.project.status shows primary_public_url. Do not hand-edit assets/index-*.js build output. If bucket_id_or_bucket_name_required — run hosting.site.quick_start first (or pass bucket_id from hosting.project.status)."}, "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.build.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Build Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dependency_error": "Fix imports in errors[0].file — source.get view=symbol; do not patch package.json for Browserslist noise.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "syntax_error": "Fix errors[0].file:line in src/ — ai_builder.source.get view=symbol, patch once, build.enqueue again.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll until completed, failed, or cached. Omit build_uuid for the latest build. On failed: error_code syntax_error or dependency_error with errors[{file,line,message}]. Browserslist/caniuse warnings ar"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.build.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Build Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dependency_error": "Fix imports in errors[0].file — source.get view=symbol; do not patch package.json for Browserslist noise.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "syntax_error": "Fix errors[0].file:line in src/ — ai_builder.source.get view=symbol, patch once, build.enqueue again.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll until completed, failed, or cached. Omit build_uuid for the latest build. On failed: error_code syntax_error or dependency_error with errors[{file,line,message}]. Browserslist/caniuse warnings ar"}, "domain": "ai_builder", "domain_title": "Ai Builder MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Poll latest build (omit build_uuid)", "request": {"params": {}, "tool": "ai_builder.build.status"}, "response": {"data": {"agent_completion": {"done": false, "phase": "status"}, "error_code": "syntax_error", "errors": [{"file": "src/routes/Route0.tsx", "line": 12, "message": "Unexpected token"}], "next_actions": [{"action": "ai_builder.source.get", "params": {"path": "src/routes/Route0.tsx", "view": "symbol"}}, {"action": "ai_builder.source.patch"}], "status": "failed"}, "error_code": "syntax_error", "success": false}}, {"name": "Build completed", "request": {"params": {}, "tool": "ai_builder.build.status"}, "response": {"data": {"agent_completion": {"done": true, "phase": "status"}, "status": "completed"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Poll until completed, failed, or cached. Omit build_uuid for the latest build. On failed: error_cod…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_builder_build_status", "semantic_input_mode": "inherit_workflow", "summary": "Read a Vite build status, including file and line when it failed.", "title": "Check Build Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dependency_error": "Fix imports in errors[0].file — source.get view=symbol; do not patch package.json for Browserslist noise.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "syntax_error": "Fix errors[0].file:line in src/ — ai_builder.source.get view=symbol, patch once, build.enqueue again.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll until completed, failed, or cached. Omit build_uuid for the latest build. On failed: error_code syntax_error or dependency_error with errors[{file,line,message}]. Browserslist/caniuse warnings ar", "write_mode": null}, {"action": "ai_builder.publish", "ai_builder_atoms": {"AI_BUILDER_HOSTED_SESSION": "Published pages call /s/{project_id}/mcp with credentials on load — not MCP auth.login for visitors; clearSession only on HTTP 401.", "AI_BUILDER_PUBLISH_BOUNDARY": "ai_builder.publish omits bucket_id when hosting.project.status shows primary_public_url. Do not hand-edit assets/index-*.js build output. If bucket_id_or_bucket_name_required — run hosting.site.quick_start first (or pass bucket_id from hosting.project.status).", "AI_BUILDER_PUBLISH_URL_SHAPE": "After ai_builder.publish (or quick_start with publish=true): public_path is /s/{project_id}/{bucket_slug}/; public_url_absolute is https://agentstack.tech + that path (same as hosting.project.status sites.primary_public_url). WebGL/Vite games use publish after build.status completed — not quick_start HTML stub."}, "aliases": ["ai_builder.build.publish"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not store .tsx in ecosystem storage.", "Do not add a second orchestrator beside core.agents.orchestrator.gen1.", "Do not merge tenant dependencies into the shared package.json."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.publish", "related_tools": ["hosting.site.quick_start", "hosting.project.status", "ai_builder.build.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Publish", "when_blocked": {"bucket_id_or_bucket_name_required": "No primary hosting site — run hosting.site.quick_start first, then retry ai_builder.publish (or pass bucket_id from hosting.project.status).", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id required; bucket_id optional when primary site exists — else hosting.site.quick_start first.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "publish_failed": "Inspect error — ai_builder.build.status, fix src/, rebuild, then publish again. If no bucket: hosting.project.status then hosting.site.quick_start slug=… before ai_builder.publish.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Only when the user explicitly asks to publish. Agents need approval. If bucket_id_or_bucket_name_required — run hosting.site.quick_start first."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.publish", "related_tools": ["hosting.site.quick_start", "hosting.project.status", "ai_builder.build.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Publish", "when_blocked": {"bucket_id_or_bucket_name_required": "No primary hosting site — run hosting.site.quick_start first, then retry ai_builder.publish (or pass bucket_id from hosting.project.status).", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id required; bucket_id optional when primary site exists — else hosting.site.quick_start first.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "publish_failed": "Inspect error — ai_builder.build.status, fix src/, rebuild, then publish again. If no bucket: hosting.project.status then hosting.site.quick_start slug=… before ai_builder.publish.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Only when the user explicitly asks to publish. Agents need approval. If bucket_id_or_bucket_name_required — run hosting.site.quick_start first."}, "domain": "ai_builder", "domain_title": "App Studio pipeline", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.app_studio.pipeline.gen1"], "instruction_hint": "Only when the user explicitly asks to publish. Agents need approval. If bucket_id_or_bucket_name_re…", "kind": "processor", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "app_studio.pipeline", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bucket_id": {"description": "string", "type": "string"}, "edge_ready": {"description": "boolean", "type": "boolean"}, "public_path": {"description": "string", "type": "string"}, "public_url_absolute": {"description": "string", "type": "string"}, "url": {"description": "string", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.app_studio.pipeline.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "related_tools": ["hosting.site.quick_start", "hosting.project.status", "ai_builder.build.status"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "production_publish", "rollback": ["hosting.release.promote"], "safe_action": "ai_builder_publish", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "App Studio publish only. AI Builder is off for games — prod is hosting.git.promote_branch ref=dev target=prod, not this action.", "title": "Publish App Studio Build", "verification": ["hosting.project.status", "hosting.site.edge_health"], "verify": [{"action": "hosting.project.status", "predicate": "named resource is visible"}, {"action": "hosting.site.edge_health", "predicate": "named resource is visible"}], "when_blocked": {"bucket_id_or_bucket_name_required": "No primary hosting site — run hosting.site.quick_start first, then retry ai_builder.publish (or pass bucket_id from hosting.project.status).", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id required; bucket_id optional when primary site exists — else hosting.site.quick_start first.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "publish_failed": "Inspect error — ai_builder.build.status, fix src/, rebuild, then publish again. If no bucket: hosting.project.status then hosting.site.quick_start slug=… before ai_builder.publish.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Only when the user explicitly asks to publish. Agents need approval. If bucket_id_or_bucket_name_required — run hosting.site.quick_start first.", "write_mode": null}, {"action": "analytics.project_snapshot", "aliases": ["analytics.export_data", "analytics.list", "analytics.set_budget"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.analytics.gen1", "core.analytics.read_model.gen1"], "id": "analytics.project_snapshot", "related_tools": ["finance.project.analytics", "analytics.get_usage", "projects.get_stats"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Analytics Project Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dashboard / metrics / report for a project. Use finance.project.analytics only when you need P&L alone."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.analytics.gen1", "core.analytics.read_model.gen1"], "id": "analytics.project_snapshot", "related_tools": ["finance.project.analytics", "analytics.get_usage", "projects.get_stats"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Analytics Project Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dashboard / metrics / report for a project. Use finance.project.analytics only when you need P&L alone."}, "domain": "analytics", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "not_found": "projects.get — verify project_id and membership.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session."}, "execution_class": "plain_read", "instruction_hint": "Dashboard / metrics / report for a project. Use finance.project.analytics only when you need P&L al…", "mutation_kind": "none", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Dashboard BFF: analytics.project_snapshot (activity, finance, CRM slices). Platform operator pid=1: analytics.platform_snapshot (adds platform_rollups). Legacy: analytics.get_usage / get_metrics — prefer project_snapshot. projects.get_stats = members/status only. P&L only: finance.project.analytics — not analytics.get_metrics for custom DNA.", "related_tools": ["finance.project.analytics", "analytics.get_usage", "projects.get_stats"], "required_cap": "analytics", "requires_preflight": false, "risk_class": "read", "safe_action": "analytics_project_snapshot", "semantic_input_mode": "inherit_workflow", "summary": "Unified project analytics snapshot: activity, finance, CRM, product events, optional business/bots/hosting slices. Prefer this over analytics.get_usage.", "title": "Analytics Project Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dashboard / metrics / report for a project. Use finance.project.analytics only when you need P&L alone.", "write_mode": null}, {"action": "analytics.platform_snapshot", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.analytics.gen1"], "id": "analytics.platform_snapshot", "related_tools": ["analytics.project_snapshot", "integrations.get_platform_diagnostics"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Analytics Platform Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem-wide platform rollup (project_id=1). Includes platform_rollups slice + stackscript fuel/load (`stackscript.dna_monthly`). `period` is echoed for other slices; platform_rollups summary window"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.analytics.gen1"], "id": "analytics.platform_snapshot", "related_tools": ["analytics.project_snapshot", "integrations.get_platform_diagnostics"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Analytics Platform Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem-wide platform rollup (project_id=1). Includes platform_rollups slice + stackscript fuel/load (`stackscript.dna_monthly`). `period` is echoed for other slices; platform_rollups summary window"}, "domain": "analytics", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Ecosystem-wide platform rollup (project_id=1). Includes platform_rollups slice + stackscript fuel/l…", "mutation_kind": "none", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Dashboard BFF: analytics.project_snapshot (activity, finance, CRM slices). Platform operator pid=1: analytics.platform_snapshot (adds platform_rollups). Legacy: analytics.get_usage / get_metrics — prefer project_snapshot. projects.get_stats = members/status only. P&L only: finance.project.analytics — not analytics.get_metrics for custom DNA.", "related_tools": ["analytics.project_snapshot", "integrations.get_platform_diagnostics"], "required_cap": "analytics", "requires_preflight": false, "risk_class": "low_write", "safe_action": "analytics_platform_snapshot", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem platform rollup (project_id=1) with platform_rollups slice. Alias of analytics.project_snapshot — prefer for operator platform KPIs. period is echoed on the envelope; platform_rollups uses f", "title": "Analytics Platform Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem-wide platform rollup (project_id=1). Includes platform_rollups slice + stackscript fuel/load (`stackscript.dna_monthly`). `period` is echoed for other slices; platform_rollups summary window", "write_mode": null}, {"action": "analytics.get_usage", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.analytics.gen1"], "id": "analytics.get_usage", "related_tools": ["analytics.project_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Analytics Get Usage", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Quick activity counters; prefer analytics.project_snapshot for dashboards."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.analytics.gen1"], "id": "analytics.get_usage", "related_tools": ["analytics.project_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Analytics Get Usage", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Quick activity counters; prefer analytics.project_snapshot for dashboards."}, "do_not_use_when": "Prefer analytics.project_snapshot for operator dashboards.", "domain": "analytics", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "not_found": "projects.get — verify project_id and membership.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session."}, "execution_class": "plain_read", "instruction_hint": "Quick activity counters; prefer analytics.project_snapshot for dashboards.", "mutation_kind": "none", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Dashboard BFF: analytics.project_snapshot (activity, finance, CRM slices). Platform operator pid=1: analytics.platform_snapshot (adds platform_rollups). Legacy: analytics.get_usage / get_metrics — prefer project_snapshot. projects.get_stats = members/status only. P&L only: finance.project.analytics — not analytics.get_metrics for custom DNA.", "related_tools": ["analytics.project_snapshot"], "required_cap": "analytics", "requires_preflight": false, "risk_class": "read", "safe_action": "analytics_get_usage", "semantic_input_mode": "inherit_workflow", "summary": "Project activity usage slice (members + API/exec events). Prefer analytics.project_snapshot with include=['activity']. Date filters are accepted for forward-compat but not applied.", "title": "Analytics Get Usage", "tool_chains": ["usage_monitoring"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Prefer analytics.project_snapshot for operator dashboards.", "when_to_use": "Quick activity counters; prefer analytics.project_snapshot for dashboards.", "write_mode": null}, {"action": "analytics.get_metrics", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.analytics.gen1"], "id": "analytics.get_metrics", "related_tools": ["analytics.project_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Analytics Get Metrics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read custom counters stored in project data.metrics[]."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.analytics.gen1"], "id": "analytics.get_metrics", "related_tools": ["analytics.project_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Analytics Get Metrics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read custom counters stored in project data.metrics[]."}, "do_not_use_when": "Prefer project_snapshot unless reading custom metric keys.", "domain": "analytics", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "not_found": "projects.get — verify project_id and membership.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session."}, "execution_class": "plain_read", "instruction_hint": "Read custom counters stored in project data.metrics[].", "mutation_kind": "none", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Dashboard BFF: analytics.project_snapshot (activity, finance, CRM slices). Platform operator pid=1: analytics.platform_snapshot (adds platform_rollups). Legacy: analytics.get_usage / get_metrics — prefer project_snapshot. projects.get_stats = members/status only. P&L only: finance.project.analytics — not analytics.get_metrics for custom DNA.", "related_tools": ["analytics.project_snapshot"], "required_cap": "analytics", "requires_preflight": false, "risk_class": "read", "safe_action": "analytics_get_metrics", "semantic_input_mode": "inherit_workflow", "summary": "Custom DNA metrics array (data.metrics[]) for a project — not performance KPIs. For dashboard KPIs use analytics.project_snapshot.", "title": "Analytics Get Metrics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Prefer project_snapshot unless reading custom metric keys.", "when_to_use": "Read custom counters stored in project data.metrics[].", "write_mode": null}, {"action": "analytics.bump", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.analytics.journal.gen1"], "id": "analytics.bump", "related_tools": ["analytics.project_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Analytics Bump", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "deltas object required — catalog keys ae, ee, pe, rc, ec, eo, ev.* only.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Manual ring correction or integration test seeding."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.analytics.journal.gen1"], "id": "analytics.bump", "related_tools": ["analytics.project_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Analytics Bump", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "deltas object required — catalog keys ae, ee, pe, rc, ec, eo, ev.* only.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Manual ring correction or integration test seeding."}, "domain": "analytics", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"invalid_parameters": "deltas object required — catalog keys ae, ee, pe, rc, ec, eo, ev.* only.", "not_found": "projects.get — verify project_id and membership.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session."}, "execution_class": "cheap", "instruction_hint": "Manual ring correction or integration test seeding.", "mutation_kind": "none", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Dashboard BFF: analytics.project_snapshot (activity, finance, CRM slices). Platform operator pid=1: analytics.platform_snapshot (adds platform_rollups). Legacy: analytics.get_usage / get_metrics — prefer project_snapshot. projects.get_stats = members/status only. P&L only: finance.project.analytics — not analytics.get_metrics for custom DNA.", "related_tools": ["analytics.project_snapshot"], "required_cap": "analytics", "requires_preflight": false, "risk_class": "low_write", "safe_action": "analytics_bump", "semantic_input_mode": "inherit_workflow", "summary": "Increment analytics day-ring counters (catalog keys only: ae, ee, pe, rc, ec, eo, ev.*). Prefer organic writers; use for tests or manual corrections.", "title": "Analytics Bump", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "deltas object required — catalog keys ae, ee, pe, rc, ec, eo, ev.* only.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Manual ring correction or integration test seeding.", "write_mode": null}, {"action": "analytics.events.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.analytics.gen1"], "id": "analytics.events.list", "related_tools": ["analytics.project_snapshot", "analytics.archive.query"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Analytics Events List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Game or product telemetry drill-down without loading full snapshot"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.analytics.gen1"], "id": "analytics.events.list", "related_tools": ["analytics.project_snapshot", "analytics.archive.query"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Analytics Events List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Game or product telemetry drill-down without loading full snapshot"}, "domain": "analytics", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Game or product telemetry drill-down without loading full snapshot", "mutation_kind": "none", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Dashboard BFF: analytics.project_snapshot (activity, finance, CRM slices). Platform operator pid=1: analytics.platform_snapshot (adds platform_rollups). Legacy: analytics.get_usage / get_metrics — prefer project_snapshot. projects.get_stats = members/status only. P&L only: finance.project.analytics — not analytics.get_metrics for custom DNA.", "related_tools": ["analytics.project_snapshot", "analytics.archive.query"], "required_cap": "analytics", "requires_preflight": false, "risk_class": "read", "safe_action": "analytics_events_list", "semantic_input_mode": "inherit_workflow", "summary": "List product analytics events for a project (same rows as GET /api/analytics/events). Not included in analytics.project_snapshot.", "title": "Analytics Events List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Game or product telemetry drill-down without loading full snapshot", "write_mode": null}, {"action": "analytics.archive.query", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.analytics.journal.gen1"], "id": "analytics.archive.query", "related_tools": ["analytics.project_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Analytics Archive Query", "when_blocked": {"archive_disabled": "Cold archive requires audit_logs and storage quota — enable policy or use live snapshot.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Forensic analytics after detail archived to Storage sqlite."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.analytics.journal.gen1"], "id": "analytics.archive.query", "related_tools": ["analytics.project_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Analytics Archive Query", "when_blocked": {"archive_disabled": "Cold archive requires audit_logs and storage quota — enable policy or use live snapshot.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Forensic analytics after detail archived to Storage sqlite."}, "domain": "analytics", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"archive_disabled": "Cold archive requires audit_logs and storage quota — enable policy or use live snapshot.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "not_found": "projects.get — verify project_id and membership.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session."}, "execution_class": "plain_read", "instruction_hint": "Forensic analytics after detail archived to Storage sqlite.", "mutation_kind": "none", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Dashboard BFF: analytics.project_snapshot (activity, finance, CRM slices). Platform operator pid=1: analytics.platform_snapshot (adds platform_rollups). Legacy: analytics.get_usage / get_metrics — prefer project_snapshot. projects.get_stats = members/status only. P&L only: finance.project.analytics — not analytics.get_metrics for custom DNA.", "related_tools": ["analytics.project_snapshot"], "required_cap": "analytics", "requires_preflight": false, "risk_class": "read", "safe_action": "analytics_archive_query", "semantic_input_mode": "inherit_workflow", "summary": "Read-only cold archive rows (audit_logs + storage quota). Not included in analytics.project_snapshot.", "title": "Analytics Archive Query", "when_blocked": {"archive_disabled": "Cold archive requires audit_logs and storage quota — enable policy or use live snapshot.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Forensic analytics after detail archived to Storage sqlite.", "write_mode": null}, {"action": "ecosystem.metrics.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.ecosystem.gen1"], "id": "ecosystem.metrics.get", "related_tools": ["analytics.project_snapshot", "analytics.platform_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Ecosystem Metrics Get", "when_to_use": "Read ecosystem.metrics DNA leaf for a project (admin). Not the hosted analytics BFF."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.ecosystem.gen1"], "id": "ecosystem.metrics.get", "related_tools": ["analytics.project_snapshot", "analytics.platform_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Ecosystem Metrics Get", "when_to_use": "Read ecosystem.metrics DNA leaf for a project (admin). Not the hosted analytics BFF."}, "domain": "ecosystem", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read ecosystem.metrics DNA leaf for a project (admin). Not the hosted analytics BFF.", "mutation_kind": "none", "related_tools": ["analytics.project_snapshot", "analytics.platform_snapshot"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "ecosystem_metrics_get", "semantic_input_mode": "inherit_workflow", "summary": "Read ecosystem.metrics leaf paths for a project (admin). Parameterized by project_id.", "title": "Ecosystem Metrics Get", "when_to_use": "Read ecosystem.metrics DNA leaf for a project (admin). Not the hosted analytics BFF.", "write_mode": null}, {"action": "assets.list_presets", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.list_presets", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets List Presets", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — presets are project-scoped", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List deterministic asset wizard presets for the project."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.list_presets", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets List Presets", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — presets are project-scoped", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List deterministic asset wizard presets for the project."}, "domain": "assets", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List deterministic asset wizard presets for the project.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "assets_list_presets", "semantic_input_mode": "inherit_workflow", "summary": "List deterministic asset wizard presets for the project.", "title": "Assets List Presets", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — presets are project-scoped", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List deterministic asset wizard presets for the project.", "write_mode": null}, {"action": "assets.create", "aliases": ["assets.mint"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not replace data.assets.items[] via projects.patch_data — use assets.create.", "anti_patterns": ["Do not replace data.assets.items[] via projects.patch_data — use assets.create.", "Do not create a second asset when list is empty — sandbox head is kept server-side."], "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.create", "mutation_risk": "low", "related_tools": ["assets.get", "assets.list", "assets.update", "commerce.storefront.seed_apply"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Create", "when_blocked": {"asset_exists": "assets.list — id collision; pick a new name or delete stale row", "batch_semantic_anchor_required": "Multi-step batches with assets.create need options.execution_intent=direct, options.goal, or preflight.check simulate_batch_actions — not bare execute chains", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "generation sandbox head may apply — assets.list before second create", "insufficient_permissions": "project write + assets_write cap", "internal_error": "scoped env_uuid invalid or DNA fault — agentstack_diagnose", "invalid_structure": "components must match preset schema — assets.list_presets", "invalid_type": "type must be a known asset type — assets.list_presets", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "name_required": "name is required — assets.list_presets for a starter row", "project_id_required": "context.project_id bound — pass project_id on create", "read_back_miss": "DNA write succeeded but items[] read-back missed id — retry assets.list; if empty, generation.realign_to_prod or assets.reindex on stale memo/index", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with assets_write in service_caps; member role does not auto-widen — use owner/admin session or explicit assets_write on the key", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unknown_preset": "assets.list_presets — preset slug from catalog row", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "generation sandbox head — assets.list then retry; agentstack_diagnose if persists"}, "when_to_use": "Digital commerce asset — prefer over custom product tables."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.create", "mutation_risk": "low", "related_tools": ["assets.get", "assets.list", "assets.update", "commerce.storefront.seed_apply"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Create", "when_blocked": {"asset_exists": "assets.list — id collision; pick a new name or delete stale row", "batch_semantic_anchor_required": "Multi-step batches with assets.create need options.execution_intent=direct, options.goal, or preflight.check simulate_batch_actions — not bare execute chains", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "generation sandbox head may apply — assets.list before second create", "insufficient_permissions": "project write + assets_write cap", "internal_error": "scoped env_uuid invalid or DNA fault — agentstack_diagnose", "invalid_structure": "components must match preset schema — assets.list_presets", "invalid_type": "type must be a known asset type — assets.list_presets", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "name_required": "name is required — assets.list_presets for a starter row", "project_id_required": "context.project_id bound — pass project_id on create", "read_back_miss": "DNA write succeeded but items[] read-back missed id — retry assets.list; if empty, generation.realign_to_prod or assets.reindex on stale memo/index", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with assets_write in service_caps; member role does not auto-widen — use owner/admin session or explicit assets_write on the key", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unknown_preset": "assets.list_presets — preset slug from catalog row", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "generation sandbox head — assets.list then retry; agentstack_diagnose if persists"}, "when_to_use": "Digital commerce asset — prefer over custom product tables."}, "commerce_atoms": {"ASSETS_SANDBOX_HEAD": "Empty assets.list after assets.create is the sandbox head — server keeps the row; do not patch data.assets.items[] manually.", "CHECKOUT_TIER_GATE": "payments.create blocked by feature gate — buffs.get_effective_limits; payments.get_balance and payments.list_methods before retry."}, "domain": "assets", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Create a game card with attack, HP, and mana cost", "name": "Create game card", "request": {"components": {"game": {"stats": {"attack": 5, "hp": 10, "mana_cost": 3}}, "properties": {"tradeable": false}, "visual": {"image_url": "https://example.com/card.png"}}, "name": "card_10hp_5atk", "price_usdt": "0.00", "type": "digital_item"}, "response": {"data": {"components": {"game": {"stats": {"attack": 5, "hp": 10, "mana_cost": 3}}, "properties": {"tradeable": false}, "visual": {"image_url": "https://example.com/card.png"}}, "id": "550e8400-e29b-41d4-a716-446655440000", "name": "card_10hp_5atk", "price_usdt": "0.00", "project_id": 123, "type": "digital_item"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Digital commerce asset — prefer over custom product tables.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"accepted": {"description": "bool", "type": "boolean"}, "asset_id": {"description": "string - same as id", "type": "string"}, "committed": {"description": "bool", "type": "boolean"}, "components": {"additionalProperties": true, "description": "object - Asset components", "type": "object"}, "id": {"description": "string - asset_<12 hex>", "type": "string"}, "name": {"description": "string - Asset name", "type": "string"}, "price_usdt": {"description": "string - Price in USDT", "type": "string"}, "project_id": {"description": "int - Project ID", "type": "integer"}, "retryable": {"description": "bool", "type": "boolean"}, "state": {"description": "string - ready", "type": "string"}, "success": {"description": "bool", "type": "boolean"}, "type": {"description": "string - Asset type", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.get", "assets.list", "assets.update", "commerce.storefront.seed_apply"], "required_cap": "assets_write", "requires_preflight": false, "risk_class": "low_write", "rollback": ["assets.delete"], "safe_action": "assets_create", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a new asset for the project.", "title": "Assets Create", "tool_chains": ["project_bootstrap", "economy_setup", "economy_setup"], "verification": ["assets.get", "assets.list"], "verify": [{"action": "assets.get", "predicate": "named resource is visible"}, {"action": "assets.list", "predicate": "named resource is visible"}], "when_blocked": {"asset_exists": "assets.list — id collision; pick a new name or delete stale row", "batch_semantic_anchor_required": "Multi-step batches with assets.create need options.execution_intent=direct, options.goal, or preflight.check simulate_batch_actions — not bare execute chains", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "generation sandbox head may apply — assets.list before second create", "insufficient_permissions": "project write + assets_write cap", "internal_error": "scoped env_uuid invalid or DNA fault — agentstack_diagnose", "invalid_structure": "components must match preset schema — assets.list_presets", "invalid_type": "type must be a known asset type — assets.list_presets", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "name_required": "name is required — assets.list_presets for a starter row", "project_id_required": "context.project_id bound — pass project_id on create", "read_back_miss": "DNA write succeeded but items[] read-back missed id — retry assets.list; if empty, generation.realign_to_prod or assets.reindex on stale memo/index", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with assets_write in service_caps; member role does not auto-widen — use owner/admin session or explicit assets_write on the key", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unknown_preset": "assets.list_presets — preset slug from catalog row", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "generation sandbox head — assets.list then retry; agentstack_diagnose if persists"}, "when_to_use": "Digital commerce asset — prefer over custom product tables.", "write_mode": null}, {"action": "assets.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.get", "related_tools": ["assets.list", "assets.create", "assets.update"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Get", "when_blocked": {"asset_not_found": "assets.list — opaque asset_id as returned by create/list", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "index_card_only": "shape.mode=index_card — items[] missing row; assets.reindex or retry after create commit", "invalid_parameters": "asset_id required — opaque id from assets.create or assets.list", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — pass project_id on get", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify assets.create receipt or load full row before assets.update or storefront seed."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.get", "related_tools": ["assets.list", "assets.create", "assets.update"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Get", "when_blocked": {"asset_not_found": "assets.list — opaque asset_id as returned by create/list", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "index_card_only": "shape.mode=index_card — items[] missing row; assets.reindex or retry after create commit", "invalid_parameters": "asset_id required — opaque id from assets.create or assets.list", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — pass project_id on get", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify assets.create receipt or load full row before assets.update or storefront seed."}, "domain": "assets", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve asset details by asset ID", "name": "Get asset by ID", "request": {"asset_id": "asset_a1b2c3d4e5f6"}, "response": {"data": {"components": {"game": {"stats": {"attack": 5, "hp": 10, "mana_cost": 3}}, "properties": {"tradeable": false}, "visual": {"image_url": "https://example.com/card.png"}}, "id": "550e8400-e29b-41d4-a716-446655440000", "name": "card_10hp_5atk", "price_usdt": "0.00", "type": "digital_item"}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Verify assets.create receipt or load full row before assets.update or storefront seed.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.list", "assets.create", "assets.update"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "assets_get", "semantic_input_mode": "inherit_workflow", "summary": "Get asset details by ID.", "title": "Assets Get", "when_blocked": {"asset_not_found": "assets.list — opaque asset_id as returned by create/list", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "index_card_only": "shape.mode=index_card — items[] missing row; assets.reindex or retry after create commit", "invalid_parameters": "asset_id required — opaque id from assets.create or assets.list", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — pass project_id on get", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify assets.create receipt or load full row before assets.update or storefront seed.", "write_mode": null}, {"action": "assets.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not treat empty list as missing product — may be generation sandbox head.", "anti_patterns": ["Do not treat empty list as missing product — may be generation sandbox head.", "Wallets hold balance — assets.list is catalog only.", "Do not use projection=full for pick-lists — summary avoids loading assets.items[]."], "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.list", "related_tools": ["assets.get", "assets.update", "assets.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — tenant: empty list may be sandbox head; platform pid≤1: check scope.drift and counts.assets", "scope_drift": "response.scope.drift true — assets.reindex then assets.list again; summary uses ECS index only (no items[] read); projection=full loads items[]", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Catalog pick-list: default summary (index cards). Use assets.get or projection=full for components/price. If scope.drift, assets.reindex then re-list. Paginate: limit default 100 (max 1000), offset; t"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.list", "related_tools": ["assets.get", "assets.update", "assets.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — tenant: empty list may be sandbox head; platform pid≤1: check scope.drift and counts.assets", "scope_drift": "response.scope.drift true — assets.reindex then assets.list again; summary uses ECS index only (no items[] read); projection=full loads items[]", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Catalog pick-list: default summary (index cards). Use assets.get or projection=full for components/price. If scope.drift, assets.reindex then re-list. Paginate: limit default 100 (max 1000), offset; t"}, "commerce_atoms": {"ASSETS_LIST_PAGINATION": "Page with limit (default 100, max 1000) and offset; has_more or offset + len(items) < count for next page. total is canonical catalog size.", "ASSETS_LIST_PROJECTION": "assets.list defaults to projection=summary (ECS index). Use projection=full or assets.get for components/price_usdt; scope.drift → assets.reindex then re-list. Index-light filters: type, rarity, tradeable, lifecycle, category, q, cross_project — no items[] read on summary path.", "ASSETS_SANDBOX_HEAD": "Empty assets.list after assets.create is the sandbox head — server keeps the row; do not patch data.assets.items[] manually.", "PAYMENTS_NO_LIST": "payments.list does not exist — use payments.get_balance, payments.get, or wallets.list."}, "domain": "assets", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Get all assets in the project", "name": "List all assets", "request": {"project_id": 123}, "response": {"data": {"count": 1, "items": [{"id": "asset_a1b2c3d4e5f6", "name": "card_10hp_5atk", "status": "active", "type": "digital_item"}], "limit": 100, "offset": 0, "projection": "summary", "scope": {"canonical_total": 1, "drift": false}, "total": 1}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Catalog pick-list: default summary (index cards). Use assets.get or projection=full for components/…", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.get", "assets.update", "assets.create"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "assets_list", "semantic_input_mode": "inherit_workflow", "summary": "Page catalog assets (default projection=summary, limit 100, max 1000).", "title": "Assets List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — tenant: empty list may be sandbox head; platform pid≤1: check scope.drift and counts.assets", "scope_drift": "response.scope.drift true — assets.reindex then assets.list again; summary uses ECS index only (no items[] read); projection=full loads items[]", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Catalog pick-list: default summary (index cards). Use assets.get or projection=full for components/price. If scope.drift, assets.reindex then re-list. Paginate: limit default 100 (max 1000), offset; t", "write_mode": null}, {"action": "assets.update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.update", "mutation_risk": "low", "related_tools": ["assets.get", "assets.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Update", "when_blocked": {"asset_not_found": "assets.list or assets.get — confirm asset id on active sandbox head", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "assets_write cap + project membership", "invalid_parameters": "patch leaf paths only — not full data.assets.items[] blob", "invalid_structure": "assets.get then patch leaf paths valid for the asset type", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_tradeable": "Set components.properties.tradeable (or transferable) true via assets.update before REST POST /projects/{id}/assets/{asset_id}/transfer — not wallets.transfer", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "update_failed": "CAS or mutate refused — assets.get then retry leaf patch", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch asset metadata or pricing leaf."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.update", "mutation_risk": "low", "related_tools": ["assets.get", "assets.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Update", "when_blocked": {"asset_not_found": "assets.list or assets.get — confirm asset id on active sandbox head", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "assets_write cap + project membership", "invalid_parameters": "patch leaf paths only — not full data.assets.items[] blob", "invalid_structure": "assets.get then patch leaf paths valid for the asset type", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_tradeable": "Set components.properties.tradeable (or transferable) true via assets.update before REST POST /projects/{id}/assets/{asset_id}/transfer — not wallets.transfer", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "update_failed": "CAS or mutate refused — assets.get then retry leaf patch", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch asset metadata or pricing leaf."}, "commerce_atoms": {"ASSETS_SANDBOX_HEAD": "Empty assets.list after assets.create is the sandbox head — server keeps the row; do not patch data.assets.items[] manually."}, "domain": "assets", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Update asset properties", "name": "Update asset", "request": {"asset_id": "550e8400-e29b-41d4-a716-446655440000", "name": "Updated Card Name", "price_usdt": "1.00"}, "response": {"data": {"id": "550e8400-e29b-41d4-a716-446655440000", "name": "Updated Card Name", "price_usdt": "1.00"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Patch asset metadata or pricing leaf.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"components": {"additionalProperties": true, "description": "object - Asset components", "type": "object"}, "id": {"description": "string - Asset ID", "type": "string"}, "name": {"description": "string - Updated asset name", "type": "string"}, "price_usdt": {"description": "string - Price in USDT", "type": "string"}, "project_id": {"description": "int - Project ID", "type": "integer"}, "type": {"description": "string - Asset type", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.get", "assets.create"], "required_cap": "assets_write", "requires_preflight": false, "risk_class": "low_write", "rollback": ["assets.update"], "safe_action": "assets_update", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Update an existing asset.", "title": "Assets Update", "verification": ["assets.get"], "verify": [{"action": "assets.get", "predicate": "named resource is visible"}], "when_blocked": {"asset_not_found": "assets.list or assets.get — confirm asset id on active sandbox head", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "assets_write cap + project membership", "invalid_parameters": "patch leaf paths only — not full data.assets.items[] blob", "invalid_structure": "assets.get then patch leaf paths valid for the asset type", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_tradeable": "Set components.properties.tradeable (or transferable) true via assets.update before REST POST /projects/{id}/assets/{asset_id}/transfer — not wallets.transfer", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "update_failed": "CAS or mutate refused — assets.get then retry leaf patch", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch asset metadata or pricing leaf.", "write_mode": null}, {"action": "assets.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.delete", "mutation_risk": "low", "related_tools": ["assets.list", "assets.get", "assets.create", "assets.update"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Delete", "when_blocked": {"asset_not_found": "assets.list — check storefront refs before delete", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "assets_write cap required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — pass project_id on delete", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove asset from catalog — check storefront refs first."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.delete", "mutation_risk": "low", "related_tools": ["assets.list", "assets.get", "assets.create", "assets.update"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Delete", "when_blocked": {"asset_not_found": "assets.list — check storefront refs before delete", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "assets_write cap required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — pass project_id on delete", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove asset from catalog — check storefront refs first."}, "domain": "assets", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "examples": [{"description": "Use asset_id exactly as returned by create/list", "name": "Delete by opaque id", "request": {"asset_id": "asset_a1b2c3d4e5f6"}}], "execution_class": "cheap", "instruction_hint": "Remove asset from catalog — check storefront refs first.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "string", "type": "string"}, "success": {"description": "bool", "type": "boolean"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.list", "assets.get", "assets.create", "assets.update"], "required_cap": "assets_write", "requires_preflight": true, "risk_class": "destructive", "rollback": [], "safe_action": "assets_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete an asset from the project.", "title": "Assets Delete", "verification": ["assets.list"], "verify": [{"action": "assets.list", "predicate": "named resource is visible"}], "when_blocked": {"asset_not_found": "assets.list — check storefront refs before delete", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "assets_write cap required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "project_id_required": "context.project_id bound — pass project_id on delete", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove asset from catalog — check storefront refs first.", "write_mode": null}, {"action": "assets.transfer", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.transfer", "mutation_risk": "high", "related_tools": ["assets.get", "assets.update", "wallets.transfer"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Transfer", "when_blocked": {"asset_not_found": "assets.get — opaque asset_id on active sandbox head", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_holdings": "source user lacks quantity — inventory revoke failed", "insufficient_permissions": "assets_write cap + project membership on source project_id", "invalid_parameters": "asset_id plus to_user_id and to_project_id (>0); quantity defaults to 1", "inventory_failed": "grant to recipient failed after debit — retry; check inventory service", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_tradeable": "assets.update — set components.properties.tradeable or transferable true (catalog transfer is not wallets.transfer)", "operation_failed": "unexpected failure — agentstack_diagnose with trace id", "project_id_required": "context.project_id bound — pass project_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with assets_write in service_caps", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move tradeable catalog items between users — not AGNT/agUSD wallet transfer."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.transfer", "mutation_risk": "high", "related_tools": ["assets.get", "assets.update", "wallets.transfer"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Transfer", "when_blocked": {"asset_not_found": "assets.get — opaque asset_id on active sandbox head", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_holdings": "source user lacks quantity — inventory revoke failed", "insufficient_permissions": "assets_write cap + project membership on source project_id", "invalid_parameters": "asset_id plus to_user_id and to_project_id (>0); quantity defaults to 1", "inventory_failed": "grant to recipient failed after debit — retry; check inventory service", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_tradeable": "assets.update — set components.properties.tradeable or transferable true (catalog transfer is not wallets.transfer)", "operation_failed": "unexpected failure — agentstack_diagnose with trace id", "project_id_required": "context.project_id bound — pass project_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with assets_write in service_caps", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move tradeable catalog items between users — not AGNT/agUSD wallet transfer."}, "domain": "assets", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Transfer tradeable item", "request": {"asset_id": "asset_a1b2c3d4e5f6", "quantity": 1, "to_project_id": 123, "to_user_id": 42}}], "execution_class": "cheap", "instruction_hint": "Move tradeable catalog items between users — not AGNT/agUSD wallet transfer.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.get", "assets.update", "wallets.transfer"], "required_cap": "assets_write", "requires_preflight": true, "risk_class": "financial", "safe_action": "assets_transfer", "semantic_input_mode": "inherit_workflow", "summary": "Transfer a catalog asset (inventory holding) to another user/project.", "title": "Assets Transfer", "when_blocked": {"asset_not_found": "assets.get — opaque asset_id on active sandbox head", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_holdings": "source user lacks quantity — inventory revoke failed", "insufficient_permissions": "assets_write cap + project membership on source project_id", "invalid_parameters": "asset_id plus to_user_id and to_project_id (>0); quantity defaults to 1", "inventory_failed": "grant to recipient failed after debit — retry; check inventory service", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_tradeable": "assets.update — set components.properties.tradeable or transferable true (catalog transfer is not wallets.transfer)", "operation_failed": "unexpected failure — agentstack_diagnose with trace id", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "project_id_required": "context.project_id bound — pass project_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with assets_write in service_caps", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move tradeable catalog items between users — not AGNT/agUSD wallet transfer.", "write_mode": null}, {"action": "assets.bulk_delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.bulk_delete", "mutation_risk": "low", "related_tools": ["assets.delete", "assets.list"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Bulk Delete", "when_blocked": {"asset_not_found": "assets.list — missing ids appear in failed[]", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "assets_write cap required", "invalid_parameters": "asset_ids must be a non-empty array of opaque ids", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — pass project_id on bulk_delete", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Prefer over many assets.delete calls for the same project."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.bulk_delete", "mutation_risk": "low", "related_tools": ["assets.delete", "assets.list"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Bulk Delete", "when_blocked": {"asset_not_found": "assets.list — missing ids appear in failed[]", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "assets_write cap required", "invalid_parameters": "asset_ids must be a non-empty array of opaque ids", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — pass project_id on bulk_delete", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Prefer over many assets.delete calls for the same project."}, "domain": "assets", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Prefer over many assets.delete calls for the same project.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.delete", "assets.list"], "required_cap": "assets_write", "requires_preflight": true, "risk_class": "destructive", "safe_action": "assets_bulk_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete multiple catalog assets in one write (REST bulk-delete parity).", "title": "Assets Bulk Delete", "when_blocked": {"asset_not_found": "assets.list — missing ids appear in failed[]", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "assets_write cap required", "invalid_parameters": "asset_ids must be a non-empty array of opaque ids", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "project_id_required": "context.project_id bound — pass project_id on bulk_delete", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Prefer over many assets.delete calls for the same project.", "write_mode": null}, {"action": "assets.bulk_update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.bulk_update", "mutation_risk": "low", "related_tools": ["assets.update", "assets.list"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Bulk Update", "when_blocked": {"asset_not_found": "assets.list — per-row missing id in failed[]", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "assets_write cap + project membership", "invalid_parameters": "updates must be a non-empty array of rows with asset_id (or id)", "invalid_structure": "each row patch must match assets.update leaf paths", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_tradeable": "Set tradeable via assets.update before transfer — bulk patch cannot bypass transfer gate", "project_id_required": "context.project_id bound — pass project_id on bulk_update", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk lifecycle or metadata patches — not projects.patch_data on items[]."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.bulk_update", "mutation_risk": "low", "related_tools": ["assets.update", "assets.list"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Bulk Update", "when_blocked": {"asset_not_found": "assets.list — per-row missing id in failed[]", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "assets_write cap + project membership", "invalid_parameters": "updates must be a non-empty array of rows with asset_id (or id)", "invalid_structure": "each row patch must match assets.update leaf paths", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_tradeable": "Set tradeable via assets.update before transfer — bulk patch cannot bypass transfer gate", "project_id_required": "context.project_id bound — pass project_id on bulk_update", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk lifecycle or metadata patches — not projects.patch_data on items[]."}, "domain": "assets", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Bulk lifecycle or metadata patches — not projects.patch_data on items[].", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.update", "assets.list"], "required_cap": "assets_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "assets_bulk_update", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch multiple catalog assets in one write (REST bulk-update parity).", "title": "Assets Bulk Update", "when_blocked": {"asset_not_found": "assets.list — per-row missing id in failed[]", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "assets_write cap + project membership", "invalid_parameters": "updates must be a non-empty array of rows with asset_id (or id)", "invalid_structure": "each row patch must match assets.update leaf paths", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_tradeable": "Set tradeable via assets.update before transfer — bulk patch cannot bypass transfer gate", "project_id_required": "context.project_id bound — pass project_id on bulk_update", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk lifecycle or metadata patches — not projects.patch_data on items[].", "write_mode": null}, {"action": "assets.import", "ai_tips": "Bulk migrate catalog JSON — prefer over many assets.create or patching items[].", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.import", "mutation_risk": "low", "related_tools": ["assets.list", "assets.reindex", "assets.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Import", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "import_all_failed": "every row failed validation — fix failed[]; components defaults to {}", "import_failed": "CAS or mutate refused — assets.list; generation.realign_to_prod if sandbox stuck", "insufficient_permissions": "assets_write cap + project write", "invalid_parameters": "params.assets must be a non-empty array — same shape as catalog export rows", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "post_import": "assets.list — if scope.drift remains after import, assets.reindex once", "project_id_required": "context.project_id or params.project_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with assets_write in service_caps", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk migrate catalog JSON — prefer over many assets.create or patching items[]."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.import", "mutation_risk": "low", "related_tools": ["assets.list", "assets.reindex", "assets.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Import", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "import_all_failed": "every row failed validation — fix failed[]; components defaults to {}", "import_failed": "CAS or mutate refused — assets.list; generation.realign_to_prod if sandbox stuck", "insufficient_permissions": "assets_write cap + project write", "invalid_parameters": "params.assets must be a non-empty array — same shape as catalog export rows", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "post_import": "assets.list — if scope.drift remains after import, assets.reindex once", "project_id_required": "context.project_id or params.project_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with assets_write in service_caps", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk migrate catalog JSON — prefer over many assets.create or patching items[]."}, "commerce_atoms": {"ASSETS_IMPORT_PARTIAL": "success=true with non-empty failed[] is partial import — fix failed rows or overwrite=true; do not re-import the whole blob via projects.patch_data."}, "domain": "assets", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Import one row", "request": {"assets": [{"id": "asset_a1b2c3d4e5f6", "name": "Starter SKU", "price_usdt": "0.00", "type": "digital_item"}]}}], "execution_class": "cheap", "instruction_hint": "Bulk migrate catalog JSON — prefer over many assets.create or patching items[].", "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.list", "assets.reindex", "assets.create"], "required_cap": "assets_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "assets_import", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Bulk import catalog assets from JSON (REST parity with POST .../assets/import).", "title": "Assets Import", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "import_all_failed": "every row failed validation — fix failed[]; components defaults to {}", "import_failed": "CAS or mutate refused — assets.list; generation.realign_to_prod if sandbox stuck", "insufficient_permissions": "assets_write cap + project write", "invalid_parameters": "params.assets must be a non-empty array — same shape as catalog export rows", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "post_import": "assets.list — if scope.drift remains after import, assets.reindex once", "project_id_required": "context.project_id or params.project_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with assets_write in service_caps", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk migrate catalog JSON — prefer over many assets.create or patching items[].", "write_mode": ["merge", "patch", "upsert", "replace", "write", "delete"]}, {"action": "assets.export", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.export", "related_tools": ["assets.import", "assets.list", "assets.reindex"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Export", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "mcp_read on API key or session", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Backup or feed assets.import; pass asset_ids for bulk subset (≤100 avoids full blob). Prefer assets.list + pagination for UI pick-lists."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.export", "related_tools": ["assets.import", "assets.list", "assets.reindex"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Export", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "mcp_read on API key or session", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Backup or feed assets.import; pass asset_ids for bulk subset (≤100 avoids full blob). Prefer assets.list + pagination for UI pick-lists."}, "commerce_atoms": {"ASSETS_EXPORT_HEAVY": "assets.export always reads assets.items[] once, then filters by asset_ids when set (>100 ids still one full read). Use assets.list + limit/offset for catalog UI."}, "domain": "assets", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Backup or feed assets.import; pass asset_ids for bulk subset (≤100 avoids full blob). Prefer assets…", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.import", "assets.list", "assets.reindex"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "assets_export", "semantic_input_mode": "inherit_workflow", "summary": "Export all catalog rows from canonical assets.items[] (full records).", "title": "Assets Export", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "mcp_read on API key or session", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Backup or feed assets.import; pass asset_ids for bulk subset (≤100 avoids full blob). Prefer assets.list + pagination for UI pick-lists.", "write_mode": null}, {"action": "assets.reindex", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.reindex", "mutation_risk": "low", "related_tools": ["assets.list", "assets.get"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Reindex", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "index_rebuild_failed": "CAS refused — assets.list scope; generation.realign_to_prod if sandbox stuck", "insufficient_permissions": "assets_write cap + project membership", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — assets.list scope.drift before reindex", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with assets_write in service_caps", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Heal ECS index drift after bulk import or sandbox promote."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.reindex", "mutation_risk": "low", "related_tools": ["assets.list", "assets.get"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Reindex", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "index_rebuild_failed": "CAS refused — assets.list scope; generation.realign_to_prod if sandbox stuck", "insufficient_permissions": "assets_write cap + project membership", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — assets.list scope.drift before reindex", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with assets_write in service_caps", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Heal ECS index drift after bulk import or sandbox promote."}, "domain": "assets", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Heal ECS index drift after bulk import or sandbox promote.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"reindexed": {"description": "int", "type": "integer"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.list", "assets.get"], "required_cap": "assets_write", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "assets_reindex", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Rebuild assets ECS index from canonical items[] (heal P6 list drift).", "title": "Assets Reindex", "verification": ["assets.list", "assets.get"], "verify": [{"action": "assets.list", "predicate": "named resource is visible"}, {"action": "assets.get", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "index_rebuild_failed": "CAS refused — assets.list scope; generation.realign_to_prod if sandbox stuck", "insufficient_permissions": "assets_write cap + project membership", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — assets.list scope.drift before reindex", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with assets_write in service_caps", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Heal ECS index drift after bulk import or sandbox promote.", "write_mode": null}, {"action": "assets.activity", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.activity", "related_tools": ["assets.get", "assets.transfer", "assets.list"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Activity", "when_blocked": {"asset_not_found": "assets.get — confirm opaque asset_id on active head", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "asset_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspector timeline / support — after assets.get confirms the row exists."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.activity", "related_tools": ["assets.get", "assets.transfer", "assets.list"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Activity", "when_blocked": {"asset_not_found": "assets.get — confirm opaque asset_id on active head", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "asset_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspector timeline / support — after assets.get confirms the row exists."}, "domain": "assets", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Inspector timeline / support — after assets.get confirms the row exists.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.get", "assets.transfer", "assets.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "assets_activity", "semantic_input_mode": "inherit_workflow", "summary": "Recent activity for one catalog asset (execution_ecosystem_logs; transfers and ops that set asset_id). Read-only.", "title": "Assets Activity", "when_blocked": {"asset_not_found": "assets.get — confirm opaque asset_id on active head", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "asset_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspector timeline / support — after assets.get confirms the row exists.", "write_mode": null}, {"action": "auth.login", "aliases": ["app.auth.login", "auth.quick_auth", "identity.login", "session.create"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.login", "related_tools": ["auth.get_profile", "auth.email_otp.send", "auth.email_otp.login", "projects.get_projects"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Login", "when_blocked": {"authz_generation_stale": "Do not re-enter password — call auth.get_profile with backoff or REST bootstrap with X-Auth-Mint-Grace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_credentials": "auth.email_otp.send or retry password — not Cursor plugin MCP Connect", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "member_email_not_auth": "Retry with ecosystem canonical login email — project member display email cannot authenticate; auth.register if no Layer 1 auth row (AUTH_CANONICAL_IDENTITY)", "password_setup_required": "auth.password_reset.request or set-password invite before auth.login", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_found": "auth.register or passwordless OTP when account is missing", "vertical_workspace_unavailable": "Retry auth.login after brief delay — hosted vertical workspace provision failed"}, "when_to_use": "Tenant app user sign-in — not Cursor plugin MCP Connect."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.login", "related_tools": ["auth.get_profile", "auth.email_otp.send", "auth.email_otp.login", "projects.get_projects"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Login", "when_blocked": {"authz_generation_stale": "Do not re-enter password — call auth.get_profile with backoff or REST bootstrap with X-Auth-Mint-Grace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_credentials": "auth.email_otp.send or retry password — not Cursor plugin MCP Connect", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "member_email_not_auth": "Retry with ecosystem canonical login email — project member display email cannot authenticate; auth.register if no Layer 1 auth row (AUTH_CANONICAL_IDENTITY)", "password_setup_required": "auth.password_reset.request or set-password invite before auth.login", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_found": "auth.register or passwordless OTP when account is missing", "vertical_workspace_unavailable": "Retry auth.login after brief delay — hosted vertical workspace provision failed"}, "when_to_use": "Tenant app user sign-in — not Cursor plugin MCP Connect."}, "domain": "auth", "domain_title": "Auth MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Authenticate user and receive JWT token", "name": "Login with email and password", "request": {"params": {"email": "user@example.com", "password": "securepassword123"}, "tool": "auth.login"}, "response": {"data": {"expires_at": "2025-01-27T10:00:00Z", "session_id": "session-uuid", "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "user": {"email": "user@example.com", "is_ecosystem": false, "name": "User Name", "project_id": 1, "role": "admin", "user_id": 1}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Tenant app user sign-in — not Cursor plugin MCP Connect.", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["auth.get_profile"], "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.get_profile", "auth.email_otp.send", "auth.email_otp.login", "projects.get_projects"], "requires_preflight": false, "risk_class": "read", "safe_action": "auth_login", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Email+password tenant sign-in — not Cursor MCP Connect. Passwordless: auth.email_otp.send → login. Session live: omit email → get_profile.", "title": "Auth Login", "when_blocked": {"authz_generation_stale": "Do not re-enter password — call auth.get_profile with backoff or REST bootstrap with X-Auth-Mint-Grace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_credentials": "auth.email_otp.send or retry password — not Cursor plugin MCP Connect", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "member_email_not_auth": "Retry with ecosystem canonical login email — project member display email cannot authenticate; auth.register if no Layer 1 auth row (AUTH_CANONICAL_IDENTITY)", "password_setup_required": "auth.password_reset.request or set-password invite before auth.login", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_found": "auth.register or passwordless OTP when account is missing", "vertical_workspace_unavailable": "Retry auth.login after brief delay — hosted vertical workspace provision failed"}, "when_to_use": "Tenant app user sign-in — not Cursor plugin MCP Connect.", "write_mode": null}, {"action": "auth.email_otp.send", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.email_otp.send", "related_tools": ["auth.email_otp.login", "auth.login", "messaging.get_auth_email_readiness"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Email Otp Send", "when_blocked": {"anonymous_session_required": "purpose=convert requires same X-API-Key anonymous principal", "channel_not_linked": "User must link bot channel (profile MFA) before channel=telegram", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "delivery_unavailable": "delivery_unavailable=true — messaging.get_auth_email_readiness; email: Mail Hub /dev/platform/environment secrets; compose RESEND_API_KEY is bootstrap-only; bot: channel=telegram + linked channel_identities; retry resend:true", "invalid_email": "Fix email param before retry", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "otp_cooldown": "HTTP 429 or cooldown replay — reuse code with same challenge_id or resend:true for new challenge_id", "rate_limited": "Backoff — do not tight-loop send", "resend_required": "Cooldown active — reuse inbox/Telegram code with same challenge_id, or resend:true for new challenge_id (invalidates prior code)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unbound_channel": "Bot channel not reachable for user_id — same as channel_not_linked", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Send a code, then auth.email_otp.login. Convert uses purpose=convert and the same anonymous key. Do not build a second login form."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.email_otp.send", "related_tools": ["auth.email_otp.login", "auth.login", "messaging.get_auth_email_readiness"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Email Otp Send", "when_blocked": {"anonymous_session_required": "purpose=convert requires same X-API-Key anonymous principal", "channel_not_linked": "User must link bot channel (profile MFA) before channel=telegram", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "delivery_unavailable": "delivery_unavailable=true — messaging.get_auth_email_readiness; email: Mail Hub /dev/platform/environment secrets; compose RESEND_API_KEY is bootstrap-only; bot: channel=telegram + linked channel_identities; retry resend:true", "invalid_email": "Fix email param before retry", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "otp_cooldown": "HTTP 429 or cooldown replay — reuse code with same challenge_id or resend:true for new challenge_id", "rate_limited": "Backoff — do not tight-loop send", "resend_required": "Cooldown active — reuse inbox/Telegram code with same challenge_id, or resend:true for new challenge_id (invalidates prior code)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unbound_channel": "Bot channel not reachable for user_id — same as channel_not_linked", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Send a code, then auth.email_otp.login. Convert uses purpose=convert and the same anonymous key. Do not build a second login form."}, "do_not_use_when": "Not Cursor plugin MCP Connect; hosted /s/ visitors use page REST OTP. Pair with auth.email_otp.login — not password auth.login alone.", "domain": "auth", "domain_title": "Auth MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Send a code, then auth.email_otp.login. Convert uses purpose=convert and the same anonymous key. Do…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.email_otp.login", "auth.login", "messaging.get_auth_email_readiness"], "requires_preflight": false, "risk_class": "low_write", "safe_action": "auth_email_otp_send", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "One-time sign-in code. purpose=login|register|convert. No auth.convert_anonymous_user tool. sent=true hides whether the account exists. needs_human: ask the human. UI: AuthWidget or <agentstack-auth>.", "title": "Auth Email Otp Send", "when_blocked": {"anonymous_session_required": "purpose=convert requires same X-API-Key anonymous principal", "channel_not_linked": "User must link bot channel (profile MFA) before channel=telegram", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "delivery_unavailable": "delivery_unavailable=true — messaging.get_auth_email_readiness; email: Mail Hub /dev/platform/environment secrets; compose RESEND_API_KEY is bootstrap-only; bot: channel=telegram + linked channel_identities; retry resend:true", "invalid_email": "Fix email param before retry", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "otp_cooldown": "HTTP 429 or cooldown replay — reuse code with same challenge_id or resend:true for new challenge_id", "rate_limited": "Backoff — do not tight-loop send", "resend_required": "Cooldown active — reuse inbox/Telegram code with same challenge_id, or resend:true for new challenge_id (invalidates prior code)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unbound_channel": "Bot channel not reachable for user_id — same as channel_not_linked", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Not Cursor plugin MCP Connect; hosted /s/ visitors use page REST OTP. Pair with auth.email_otp.login — not password auth.login alone.", "when_to_use": "Send a code, then auth.email_otp.login. Convert uses purpose=convert and the same anonymous key. Do not build a second login form.", "write_mode": null}, {"action": "auth.email_otp.login", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.email_otp.login", "related_tools": ["auth.email_otp.send", "auth.login", "auth.get_profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Email Otp Login", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_key_unavailable": "GET /api/health ecosystem_session_key_source — same plane as password login 503", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "otp_expired": "auth.email_otp.send with same email", "otp_invalid": "Re-read challenge_id + otp — auth.email_otp.send again if expired", "registration_unavailable_misconfigured": "GET /api/health registration_ready — platform ops; do not retry register until true", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Finish passwordless login with the code the human pasted. The bearer is already stored. A server restart does not require a new login while that session row is active."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.email_otp.login", "related_tools": ["auth.email_otp.send", "auth.login", "auth.get_profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Email Otp Login", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_key_unavailable": "GET /api/health ecosystem_session_key_source — same plane as password login 503", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "otp_expired": "auth.email_otp.send with same email", "otp_invalid": "Re-read challenge_id + otp — auth.email_otp.send again if expired", "registration_unavailable_misconfigured": "GET /api/health registration_ready — platform ops; do not retry register until true", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Finish passwordless login with the code the human pasted. The bearer is already stored. A server restart does not require a new login while that session row is active."}, "do_not_use_when": "Not session mint without a prior auth.email_otp.send challenge_id. Not Cursor OAuth — ecosystem Bearer from this action only.", "domain": "auth", "domain_title": "Auth MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Finish passwordless login with the code the human pasted. The bearer is already stored. A server re…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.email_otp.send", "auth.login", "auth.get_profile"], "requires_preflight": false, "risk_class": "read", "safe_action": "auth_email_otp_login", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Verify the email code and mint a session. data.sessions[jti] survives a process restart. The SDK stores the bearer. Hosted flagship sends body.p. MFA: retry with mfa_ticket and mfa_code.", "title": "Auth Email Otp Login", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_key_unavailable": "GET /api/health ecosystem_session_key_source — same plane as password login 503", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "otp_expired": "auth.email_otp.send with same email", "otp_invalid": "Re-read challenge_id + otp — auth.email_otp.send again if expired", "registration_unavailable_misconfigured": "GET /api/health registration_ready — platform ops; do not retry register until true", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Not session mint without a prior auth.email_otp.send challenge_id. Not Cursor OAuth — ecosystem Bearer from this action only.", "when_to_use": "Finish passwordless login with the code the human pasted. The bearer is already stored. A server restart does not require a new login while that session row is active.", "write_mode": null}, {"action": "auth.register", "aliases": ["auth.create_user", "users.create"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.register", "related_tools": ["auth.login", "auth.email_otp.send", "auth.email_otp.login", "buffs.apply_temporary_effect"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Register", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "email_exists": "auth.login or auth.email_otp.send purpose=login", "email_required": "Email is required", "invalid_email": "Invalid email format", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "password_missing_uppercase": "Password must include an uppercase letter", "password_required": "Password is required", "password_too_short": "Password shorter than minimum for registration", "registration_unavailable_misconfigured": "GET /api/health registration_ready — fix server key plane before auth.register", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create a new platform user with email + password."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.register", "related_tools": ["auth.login", "auth.email_otp.send", "auth.email_otp.login", "buffs.apply_temporary_effect"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Register", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "email_exists": "auth.login or auth.email_otp.send purpose=login", "email_required": "Email is required", "invalid_email": "Invalid email format", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "password_missing_uppercase": "Password must include an uppercase letter", "password_required": "Password is required", "password_too_short": "Password shorter than minimum for registration", "registration_unavailable_misconfigured": "GET /api/health registration_ready — fix server key plane before auth.register", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create a new platform user with email + password."}, "domain": "auth", "domain_title": "Auth MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Register a new user", "request": {"email": "user@example.com", "name": "User", "password": "password"}, "response": {"data": {"token": "jwt-token", "user": {"email": "user@example.com", "user_id": 1}}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Create a new platform user with email + password.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.login", "auth.email_otp.send", "auth.email_otp.login", "buffs.apply_temporary_effect"], "requires_preflight": false, "risk_class": "low_write", "safe_action": "auth_register", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "New platform user (email+password). Passwordless: auth.email_otp.send purpose=register → login. Then auth.get_profile.", "title": "Auth Register", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "email_exists": "auth.login or auth.email_otp.send purpose=login", "email_required": "Email is required", "invalid_email": "Invalid email format", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "password_missing_uppercase": "Password must include an uppercase letter", "password_required": "Password is required", "password_too_short": "Password shorter than minimum for registration", "registration_unavailable_misconfigured": "GET /api/health registration_ready — fix server key plane before auth.register", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create a new platform user with email + password.", "write_mode": null}, {"action": "auth.anonymous.provision", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.anonymous.provision", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Anonymous Provision", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hosted game demos: mint anonymous player credentials before script.run / rooms.*. Prefer this over inventing REST paths; SPAs still use POST /api/auth/anonymous/provision."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.anonymous.provision", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Anonymous Provision", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hosted game demos: mint anonymous player credentials before script.run / rooms.*. Prefer this over inventing REST paths; SPAs still use POST /api/auth/anonymous/provision."}, "domain": "auth", "domain_title": "Auth MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Hosted game demos: mint anonymous player credentials before script.run / rooms.*. Prefer this over …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "auth_anonymous_provision", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Provision an anonymous hosted-game player for project_id. Same outcome as POST /api/auth/anonymous/provision — ephemeral guest (eph_ask_*, no DNA user row). Returns api_key, user_id (1.8B+ band), acce", "title": "Auth Anonymous Provision", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hosted game demos: mint anonymous player credentials before script.run / rooms.*. Prefer this over inventing REST paths; SPAs still use POST /api/auth/anonymous/provision.", "write_mode": null}, {"action": "auth.get_profile", "aliases": ["auth.authenticate", "auth.list", "auth.me", "auth.profile", "auth.status", "auth.whoami"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.get_profile", "related_tools": ["auth.update_profile", "auth.login"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Get Profile", "when_blocked": {"authz_generation_stale": "Retry auth.get_profile after short backoff — RBAC epoch bumped; do not auth.login again when session_ready was true on mint", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosted_app_required": "POST /api/hosted-apps/{pid}/session after login or guest bootstrap: trusted /s/{pid}/ Origin with no Bearer auto-provisions (guest_bootstrap.access_token) and mints the hosted_app cookie — not operator Bearer", "hosted_cookie_missing": "Open hosted /s/{pid}/ in browser or use operator Bearer", "hosted_project_mismatch": "Align cookie, X-Hosted-App-Path, and every step project_id", "hosted_step_project_id_invalid": "Fix step project_id type — must be integer storefront pid", "hosted_step_project_id_required": "Add integer project_id to each batch step params", "invalid_credential": "Revoke stale key (G-A166) — Device Code or Connect mint fresh Bearer", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_credential": "Connect G-A174 or Device Code — never empty Bearer on plugin MCP", "not_authenticated": "MCP is required and this channel has no operator session. Pick one method (any one is enough), then confirm session_ready. Do not call mcp_auth and do not retry auth.get_profile on the same unsigned plugin channel.", "opaque": "Use JWT Bearer from Connect/Device Code — raw opaque keys are not MCP session keys", "placeholder_credential": "Replace placeholder Authorization in ~/.cursor/mcp.json", "relogin_required": "Reconnect — X-Session-Action relogin_required", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_caps_required_in_prod": "JWT or PAT with service_caps=null is not MCP-unrestricted in production — tools/list may succeed while tools/call returns service_caps_required_in_prod. Recreate via apikeys.create (full_project / agents_autonomous_loop) or Device Code /agentstack-authorize with mcp_write. Confirm caps on auth.get_profile credential_plane — not tools/list alone.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "token_expired": "Connect (plugin MCP) or /agentstack-authorize — then auth.get_profile", "unauthorized": "auth.login or plugin Connect — then bind context.project_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Session probe. compact sketches neighbors; full is the HTTP profile. One jti covers memberships. Restart rehydrates it from 8DNA. Do not log in again."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.get_profile", "related_tools": ["auth.update_profile", "auth.login"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Get Profile", "when_blocked": {"authz_generation_stale": "Retry auth.get_profile after short backoff — RBAC epoch bumped; do not auth.login again when session_ready was true on mint", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosted_app_required": "POST /api/hosted-apps/{pid}/session after login or guest bootstrap: trusted /s/{pid}/ Origin with no Bearer auto-provisions (guest_bootstrap.access_token) and mints the hosted_app cookie — not operator Bearer", "hosted_cookie_missing": "Open hosted /s/{pid}/ in browser or use operator Bearer", "hosted_project_mismatch": "Align cookie, X-Hosted-App-Path, and every step project_id", "hosted_step_project_id_invalid": "Fix step project_id type — must be integer storefront pid", "hosted_step_project_id_required": "Add integer project_id to each batch step params", "invalid_credential": "Revoke stale key (G-A166) — Device Code or Connect mint fresh Bearer", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_credential": "Connect G-A174 or Device Code — never empty Bearer on plugin MCP", "not_authenticated": "MCP is required and this channel has no operator session. Pick one method (any one is enough), then confirm session_ready. Do not call mcp_auth and do not retry auth.get_profile on the same unsigned plugin channel.", "opaque": "Use JWT Bearer from Connect/Device Code — raw opaque keys are not MCP session keys", "placeholder_credential": "Replace placeholder Authorization in ~/.cursor/mcp.json", "relogin_required": "Reconnect — X-Session-Action relogin_required", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_caps_required_in_prod": "JWT or PAT with service_caps=null is not MCP-unrestricted in production — tools/list may succeed while tools/call returns service_caps_required_in_prod. Recreate via apikeys.create (full_project / agents_autonomous_loop) or Device Code /agentstack-authorize with mcp_write. Confirm caps on auth.get_profile credential_plane — not tools/list alone.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "token_expired": "Connect (plugin MCP) or /agentstack-authorize — then auth.get_profile", "unauthorized": "auth.login or plugin Connect — then bind context.project_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Session probe. compact sketches neighbors; full is the HTTP profile. One jti covers memberships. Restart rehydrates it from 8DNA. Do not log in again."}, "domain": "auth", "domain_title": "Auth MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Session probe. compact sketches neighbors; full is the HTTP profile. One jti covers memberships. Re…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["preflight.check"], "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "Full profile alias when detail=full", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "detail": {"description": "compact (default) or full", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "profile": {"description": "Session card: user_id, email, role, auth_surface.*, locale, profile_missing", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "shape": {"description": "Redaction/focus shapes for fat neighbors when present", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "Present when detail=full", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "One jti covers every project membership allows. mutation_allowed true: do not switch_project and do not log in again. A restart rehydrates that jti from 8DNA. A page at /s/{id}/ uses the hosted cookie, not this jti.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.update_profile", "auth.login"], "requires_preflight": false, "risk_class": "read", "safe_action": "auth_get_profile", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Get the session card for the current API key.", "title": "Read Session Profile", "when_blocked": {"authz_generation_stale": "Retry auth.get_profile after short backoff — RBAC epoch bumped; do not auth.login again when session_ready was true on mint", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosted_app_required": "POST /api/hosted-apps/{pid}/session after login or guest bootstrap: trusted /s/{pid}/ Origin with no Bearer auto-provisions (guest_bootstrap.access_token) and mints the hosted_app cookie — not operator Bearer", "hosted_cookie_missing": "Open hosted /s/{pid}/ in browser or use operator Bearer", "hosted_project_mismatch": "Align cookie, X-Hosted-App-Path, and every step project_id", "hosted_step_project_id_invalid": "Fix step project_id type — must be integer storefront pid", "hosted_step_project_id_required": "Add integer project_id to each batch step params", "invalid_credential": "Revoke stale key (G-A166) — Device Code or Connect mint fresh Bearer", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_credential": "Connect G-A174 or Device Code — never empty Bearer on plugin MCP", "not_authenticated": "MCP is required and this channel has no operator session. Pick one method (any one is enough), then confirm session_ready. Do not call mcp_auth and do not retry auth.get_profile on the same unsigned plugin channel.", "opaque": "Use JWT Bearer from Connect/Device Code — raw opaque keys are not MCP session keys", "placeholder_credential": "Replace placeholder Authorization in ~/.cursor/mcp.json", "relogin_required": "Reconnect — X-Session-Action relogin_required", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_caps_required_in_prod": "JWT or PAT with service_caps=null is not MCP-unrestricted in production — tools/list may succeed while tools/call returns service_caps_required_in_prod. Recreate via apikeys.create (full_project / agents_autonomous_loop) or Device Code /agentstack-authorize with mcp_write. Confirm caps on auth.get_profile credential_plane — not tools/list alone.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "token_expired": "Connect (plugin MCP) or /agentstack-authorize — then auth.get_profile", "unauthorized": "auth.login or plugin Connect — then bind context.project_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Session probe. compact sketches neighbors; full is the HTTP profile. One jti covers memberships. Restart rehydrates it from 8DNA. Do not log in again.", "write_mode": null}, {"action": "auth.update_profile", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.update_profile", "mutation_risk": "low", "related_tools": ["auth.get_profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Update Profile", "when_blocked": {"authz_generation_stale": "RBAC epoch lag — retry auth.get_profile with backoff", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosted_app_required": "Hosted MCP requires session_type=hosted_app — POST /api/hosted-apps/{pid}/session", "hosted_cookie_missing": "Hosted app cookie missing for /s/{pid}/ MCP", "hosted_project_mismatch": "Cookie, path, or step project_id must match storefront pid", "hosted_step_project_id_invalid": "Hosted batch step project_id must be an integer", "hosted_step_project_id_required": "Hosted batch step missing params.project_id — use SDK mcpBatchStep", "invalid_credential": "Credential rejected — mint a new PAT or Connect", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_credential": "No API key or Bearer on the request", "not_authenticated": "MCP is required and this channel has no operator session. Pick one method (any one is enough), then confirm session_ready. Do not call mcp_auth and do not retry auth.get_profile on the same unsigned plugin channel.", "opaque": "Opaque API key not recognized — use Device Code Bearer or user PAT", "placeholder_credential": "Placeholder token in mcp.json — run Device Code or Connect", "relogin_required": "Session expired — Connect or auth.login; do not silent-retry writes", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "token_expired": "Bearer or session expired — Connect or Device Code again", "unauthorized": "User not authenticated", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch user profile fields (display name, locale)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.update_profile", "mutation_risk": "low", "related_tools": ["auth.get_profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Update Profile", "when_blocked": {"authz_generation_stale": "RBAC epoch lag — retry auth.get_profile with backoff", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosted_app_required": "Hosted MCP requires session_type=hosted_app — POST /api/hosted-apps/{pid}/session", "hosted_cookie_missing": "Hosted app cookie missing for /s/{pid}/ MCP", "hosted_project_mismatch": "Cookie, path, or step project_id must match storefront pid", "hosted_step_project_id_invalid": "Hosted batch step project_id must be an integer", "hosted_step_project_id_required": "Hosted batch step missing params.project_id — use SDK mcpBatchStep", "invalid_credential": "Credential rejected — mint a new PAT or Connect", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_credential": "No API key or Bearer on the request", "not_authenticated": "MCP is required and this channel has no operator session. Pick one method (any one is enough), then confirm session_ready. Do not call mcp_auth and do not retry auth.get_profile on the same unsigned plugin channel.", "opaque": "Opaque API key not recognized — use Device Code Bearer or user PAT", "placeholder_credential": "Placeholder token in mcp.json — run Device Code or Connect", "relogin_required": "Session expired — Connect or auth.login; do not silent-retry writes", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "token_expired": "Bearer or session expired — Connect or Device Code again", "unauthorized": "User not authenticated", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch user profile fields (display name, locale)."}, "domain": "auth", "domain_title": "Auth MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Update user profile", "request": {"name": "Updated Name"}, "response": {"data": {"name": "Updated Name", "user_id": 1}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Patch user profile fields (display name, locale).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.get_profile"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "auth_update_profile", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Update user profile.", "title": "Auth Update Profile", "tool_chains": ["crud_with_logic"], "when_blocked": {"authz_generation_stale": "RBAC epoch lag — retry auth.get_profile with backoff", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosted_app_required": "Hosted MCP requires session_type=hosted_app — POST /api/hosted-apps/{pid}/session", "hosted_cookie_missing": "Hosted app cookie missing for /s/{pid}/ MCP", "hosted_project_mismatch": "Cookie, path, or step project_id must match storefront pid", "hosted_step_project_id_invalid": "Hosted batch step project_id must be an integer", "hosted_step_project_id_required": "Hosted batch step missing params.project_id — use SDK mcpBatchStep", "invalid_credential": "Credential rejected — mint a new PAT or Connect", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_credential": "No API key or Bearer on the request", "not_authenticated": "MCP is required and this channel has no operator session. Pick one method (any one is enough), then confirm session_ready. Do not call mcp_auth and do not retry auth.get_profile on the same unsigned plugin channel.", "opaque": "Opaque API key not recognized — use Device Code Bearer or user PAT", "placeholder_credential": "Placeholder token in mcp.json — run Device Code or Connect", "relogin_required": "Session expired — Connect or auth.login; do not silent-retry writes", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "token_expired": "Bearer or session expired — Connect or Device Code again", "unauthorized": "User not authenticated", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch user profile fields (display name, locale).", "write_mode": null}, {"action": "auth.switch_project", "aliases": ["project.select", "projects.select", "session.switch_project"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not loop switch_project when membership already allows the mutation.", "Do not reconnect OAuth to heal stale accessible_project_ids when session_ready is true."], "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.switch_project", "related_tools": ["auth.login", "auth.get_profile", "projects.join"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Switch Project", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Mint failed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_a_member": "projects.get_users — session stays valid; pick another project_id", "project_not_accessible": "Same as not_a_member — membership check via projects.get_users", "project_session_required": "auth.login or auth.get_profile before switch_project", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Caller not authenticated", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "target_project_id missing or invalid"}, "when_to_use": "Only when auth.get_profile mutation_allowed is false. One call, then the mutation. Do not loop it and do not log in again. Cache miss still succeeds when projects.get_users shows the caller."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.switch_project", "related_tools": ["auth.login", "auth.get_profile", "projects.join"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Switch Project", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Mint failed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_a_member": "projects.get_users — session stays valid; pick another project_id", "project_not_accessible": "Same as not_a_member — membership check via projects.get_users", "project_session_required": "auth.login or auth.get_profile before switch_project", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Caller not authenticated", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "target_project_id missing or invalid"}, "when_to_use": "Only when auth.get_profile mutation_allowed is false. One call, then the mutation. Do not loop it and do not log in again. Cache miss still succeeds when projects.get_users shows the caller."}, "do_not_use_when": "When session_ready=true and mutation_allowed=true for context.project_id — set params.project_id only.", "domain": "auth", "domain_title": "Auth MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "mcp_community_hub_v1 step after projects.join — bind context for project_self work_next", "request": {"target_project_id": 123}, "response": {"data": {"jti": "session-jti-example", "project_id": 123, "session_handoff": {"mutation_allowed_after": true, "session_ready": true, "target_project_id": 123}, "success": true, "token_fields_redacted": ["access_token", "refresh_token", "session"], "token_type": "Bearer"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Only when auth.get_profile mutation_allowed is false. One call, then the mutation. Do not loop it a…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.login", "auth.get_profile", "projects.join"], "requires_preflight": false, "risk_class": "read", "safe_action": "auth_switch_project", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Rebind working project on the same identity session when mutation_allowed is false; for user-scoped Bearer prefer context.project_id / X-Project-ID without a new login.", "title": "Auth Switch Project", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Mint failed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_a_member": "projects.get_users — session stays valid; pick another project_id", "project_not_accessible": "Same as not_a_member — membership check via projects.get_users", "project_session_required": "auth.login or auth.get_profile before switch_project", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Caller not authenticated", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "target_project_id missing or invalid"}, "when_not_to_use": "When session_ready=true and mutation_allowed=true for context.project_id — set params.project_id only.", "when_to_use": "Only when auth.get_profile mutation_allowed is false. One call, then the mutation. Do not loop it and do not log in again. Cache miss still succeeds when projects.get_users shows the caller.", "write_mode": null}, {"action": "auth.channel_identities.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.channel_identities.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Channel Identities List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List bot channel identities linked to the authenticated user profile."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.channel_identities.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Channel Identities List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List bot channel identities linked to the authenticated user profile."}, "domain": "auth", "domain_title": "Auth MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "List bot channel identities linked to the authenticated user profile.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "auth_channel_identities_list", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "List bot channel identities linked to the authenticated user profile.", "title": "Auth Channel Identities List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List bot channel identities linked to the authenticated user profile.", "write_mode": null}, {"action": "auth.channel_identities.revoke", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.channel_identities.revoke", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Channel Identities Revoke", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke a channel identity link by id (owner-only)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.channel_identities.revoke", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Channel Identities Revoke", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke a channel identity link by id (owner-only)."}, "domain": "auth", "domain_title": "Auth MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Revoke a channel identity link by id (owner-only).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "auth_channel_identities_revoke", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Revoke a channel identity link by id (owner-only).", "title": "Auth Channel Identities Revoke", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke a channel identity link by id (owner-only).", "write_mode": null}, {"action": "auth.password_setup.mint", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.password_setup.mint", "mutation_risk": "low", "related_tools": ["auth.register", "projects.add_user"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Password Setup Mint", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Caller is not an ecosystem operator", "invalid_parameters": "user_id missing", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Caller not authenticated", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_found": "Target user does not exist in project_id=1"}, "when_to_use": "After creating a user with a random password, send this link instead of the password."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.password_setup.mint", "mutation_risk": "low", "related_tools": ["auth.register", "projects.add_user"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Password Setup Mint", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Caller is not an ecosystem operator", "invalid_parameters": "user_id missing", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Caller not authenticated", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_found": "Target user does not exist in project_id=1"}, "when_to_use": "After creating a user with a random password, send this link instead of the password."}, "domain": "auth", "domain_title": "Auth MCP domain", "effect": {"conditional_mutate": "Mints one-time setup token in user DNA; not a plain read despite verb mint.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "After creating a user with a random password, send this link instead of the password.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.register", "projects.add_user"], "requires_preflight": false, "risk_class": "low_write", "safe_action": "auth_password_setup_mint", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Mint a one-time /set-password URL for an existing ecosystem user. Operator-only (ecosystem owner or ecosystem admin/manage_users). The user opens the link, chooses their password, then signs in.", "title": "Auth Password Setup Mint", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Caller is not an ecosystem operator", "invalid_parameters": "user_id missing", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Caller not authenticated", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_found": "Target user does not exist in project_id=1"}, "when_to_use": "After creating a user with a random password, send this link instead of the password.", "write_mode": null}, {"action": "auth.password_reset.request", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.password_reset.request", "related_tools": ["auth.login", "auth.register", "auth.password_setup.mint"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Password Reset Request", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_email": "Malformed email address", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "User forgot password — triggers reset email when account exists."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.password_reset.request", "related_tools": ["auth.login", "auth.register", "auth.password_setup.mint"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Password Reset Request", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_email": "Malformed email address", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "User forgot password — triggers reset email when account exists."}, "domain": "auth", "domain_title": "Auth MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "User forgot password — triggers reset email when account exists.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.login", "auth.register", "auth.password_setup.mint"], "requires_preflight": false, "risk_class": "read", "safe_action": "auth_password_reset_request", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Request a self-service password reset email for an ecosystem user. Always returns the same success message (enumeration-safe). The user opens the link in the email, sets a new password, then signs in.", "title": "Auth Password Reset Request", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_email": "Malformed email address", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "User forgot password — triggers reset email when account exists.", "write_mode": null}, {"action": "auth.confirm_email.resend", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.confirm_email.resend", "related_tools": ["auth.register", "auth.login", "messaging.get_auth_email_readiness"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Confirm Email Resend", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_email": "Malformed email address", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "User cannot log in with email_unconfirmed — re-queue confirmation email when Mail Hub is ready."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.confirm_email.resend", "related_tools": ["auth.register", "auth.login", "messaging.get_auth_email_readiness"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Confirm Email Resend", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_email": "Malformed email address", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "User cannot log in with email_unconfirmed — re-queue confirmation email when Mail Hub is ready."}, "domain": "auth", "domain_title": "Auth MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "User cannot log in with email_unconfirmed — re-queue confirmation email when Mail Hub is ready.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.register", "auth.login", "messaging.get_auth_email_readiness"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "auth_confirm_email_resend", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Resend signup email confirmation for an ecosystem user (enumeration-safe). Use when login returns email_unconfirmed and the original confirmation never arrived.", "title": "Auth Confirm Email Resend", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_email": "Malformed email address", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "User cannot log in with email_unconfirmed — re-queue confirmation email when Mail Hub is ready.", "write_mode": null}, {"action": "auth.identity.resolve", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.identity.resolve", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Identity Resolve", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Resolve canonical vs display email for a user (support / debug)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.identity.resolve", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Identity Resolve", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Resolve canonical vs display email for a user (support / debug)."}, "domain": "auth", "domain_title": "Identity MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Resolve canonical vs display email for a user (support / debug).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.identity", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "auth_identity_resolve", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Resolve canonical vs display email for a user (support / debug).", "title": "Auth Identity Resolve", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Resolve canonical vs display email for a user (support / debug).", "write_mode": null}, {"action": "auth.identity.conflicts", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.identity.conflicts", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Identity Conflicts", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List project member emails that diverge from ecosystem canonical auth email."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.identity.conflicts", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Identity Conflicts", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List project member emails that diverge from ecosystem canonical auth email."}, "domain": "auth", "domain_title": "Identity MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "List project member emails that diverge from ecosystem canonical auth email.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.identity", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "auth_identity_conflicts", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "List project member emails that diverge from ecosystem canonical auth email.", "title": "Auth Identity Conflicts", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List project member emails that diverge from ecosystem canonical auth email.", "write_mode": null}, {"action": "profile.spotlight.move", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "profile", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.profile.gen1"], "id": "profile.spotlight.move", "related_tools": ["auth.get_profile"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Profile Spotlight Move", "when_to_use": "After purchasing Spotlight/VIP or to retarget the personal project beam."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "profile", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.profile.gen1"], "id": "profile.spotlight.move", "related_tools": ["auth.get_profile"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Profile Spotlight Move", "when_to_use": "After purchasing Spotlight/VIP or to retarget the personal project beam."}, "domain": "profile", "domain_title": "Auth MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "After purchasing Spotlight/VIP or to retarget the personal project beam.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.get_profile"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "profile_spotlight_move", "semantic_input_mode": "inherit_workflow", "summary": "Point a personal Spotlight/VIP/premium beam at an owned standalone Free project. REST twin: POST /api/profile/spotlight. Not projects.patch_my_data.", "title": "Profile Spotlight Move", "when_to_use": "After purchasing Spotlight/VIP or to retarget the personal project beam.", "write_mode": null}, {"action": "buffs.create_buff", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Don't apply buff before creating it", "anti_patterns": ["Don't apply buff before creating it", "Don't create multiple identical buffs - reuse templates", "Don't forget to set revert_on_expire for temporary effects"], "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.create_buff", "mutation_risk": "low", "related_tools": ["buffs.apply_buff", "buffs.get_buff", "buffs.list_active_buffs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Create Buff", "when_blocked": {"buff_creation_failed": "Internal error — retry; check entity_kind and project_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_buff_forbidden": "Tenant projects cannot create ecosystem-scoped buff templates", "invalid_entity": "Entity not found — verify entity_id and entity_kind", "invalid_parameters": "name and category required — see buffs.apply_*_effect for trials", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Define buff template (admin) — tenants use apply_*_effect."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.create_buff", "mutation_risk": "low", "related_tools": ["buffs.apply_buff", "buffs.get_buff", "buffs.list_active_buffs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Create Buff", "when_blocked": {"buff_creation_failed": "Internal error — retry; check entity_kind and project_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_buff_forbidden": "Tenant projects cannot create ecosystem-scoped buff templates", "invalid_entity": "Entity not found — verify entity_id and entity_kind", "invalid_parameters": "name and category required — see buffs.apply_*_effect for trials", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Define buff template (admin) — tenants use apply_*_effect."}, "do_not_use_when": "Do not use create+apply for platform premium/vip/scale grants — use buffs.grant_subscription. Tenant buyers: prefer buffs.grant_tenant_subscription over raw create+apply.", "domain": "buffs", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Create a trial buff for premium features", "name": "Create 7-day trial buff", "request": {"params": {"category": "subscription", "duration_days": 7, "effects": {"data.limits.api_calls": 10000}, "entity_id": 1, "entity_kind": "user", "name": "7-Day Premium Trial", "type": "trial"}, "tool": "buffs.create_buff"}, "response": {"data": {"buff_id": "uuid-here", "created_at": "2025-01-20T10:00:00Z", "state": "pending"}, "success": true}}, {"description": "Create a promotional buff for an event", "name": "Create promotional buff", "request": {"params": {"category": "event", "duration_days": 30, "effects": {"data.limits.api_calls": 50000}, "entity_id": 1, "entity_kind": "project", "name": "Black Friday 2024", "type": "promo"}, "tool": "buffs.create_buff"}, "response": {"data": {"buff_id": "uuid-here", "created_at": "2025-01-20T10:00:00Z", "state": "pending"}, "success": true}}, {"description": "Create a permanent upgrade buff", "name": "Create permanent upgrade", "request": {"params": {"category": "permanent", "config": {"persistent": true}, "duration_days": 365, "effects": {"data.features.premium": true}, "entity_id": 1, "entity_kind": "user", "name": "Premium Package", "type": "purchase"}, "tool": "buffs.create_buff"}, "response": {"data": {"buff_id": "uuid-here", "created_at": "2025-01-20T10:00:00Z", "state": "pending"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.apply_buff", "buffs.get_buff", "buffs.list_active_buffs"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "buffs_create_buff", "semantic_input_mode": "inherit_workflow", "summary": "Create a buff template in PENDING state.", "title": "Buffs Create Buff", "tool_chains": ["user_with_trial", "payment_to_subscription", "apply_custom_buff_to_user"], "when_blocked": {"buff_creation_failed": "Internal error — retry; check entity_kind and project_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_buff_forbidden": "Tenant projects cannot create ecosystem-scoped buff templates", "invalid_entity": "Entity not found — verify entity_id and entity_kind", "invalid_parameters": "name and category required — see buffs.apply_*_effect for trials", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not use create+apply for platform premium/vip/scale grants — use buffs.grant_subscription. Tenant buyers: prefer buffs.grant_tenant_subscription over raw create+apply.", "when_to_use": "Define buff template (admin) — tenants use apply_*_effect.", "write_mode": null}, {"action": "buffs.apply_buff", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not create+apply for platform tier grants — use buffs.grant_subscription.", "anti_patterns": ["Do not create+apply for platform tier grants — use buffs.grant_subscription.", "Tenant buyers: prefer buffs.grant_tenant_subscription over raw create+apply."], "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.apply_buff", "mutation_risk": "low", "related_tools": ["buffs.create_buff", "buffs.get_buff", "buffs.list_active_buffs", "buffs.get_effective_limits"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Apply Buff", "when_blocked": {"apply_failed": "Failed to apply buff — check buff_id and entity_kind", "buff_not_found": "buffs.list_active_buffs then buffs.create_buff or grant_subscription", "buff_not_pending": "Buff is not in PENDING state — use extend_buff or grant rails", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_entity": "bind context.project_id; user plane needs entity_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Low-level buff apply — prefer apply_temporary_effect for trials."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.apply_buff", "mutation_risk": "low", "related_tools": ["buffs.create_buff", "buffs.get_buff", "buffs.list_active_buffs", "buffs.get_effective_limits"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Apply Buff", "when_blocked": {"apply_failed": "Failed to apply buff — check buff_id and entity_kind", "buff_not_found": "buffs.list_active_buffs then buffs.create_buff or grant_subscription", "buff_not_pending": "Buff is not in PENDING state — use extend_buff or grant rails", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_entity": "bind context.project_id; user plane needs entity_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Low-level buff apply — prefer apply_temporary_effect for trials."}, "do_not_use_when": "Do not use create+apply for platform premium/vip/scale grants — use buffs.grant_subscription. Tenant buyers: prefer buffs.grant_tenant_subscription over raw create+apply.", "domain": "buffs", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Activate a trial buff for a user", "name": "Apply trial buff", "request": {"params": {"buff_id": "uuid-here", "entity_id": 123, "entity_kind": "user", "project_id": 1}, "tool": "buffs.apply_buff"}, "response": {"data": {"applied_at": "2025-01-20T10:00:00Z", "buff_id": "uuid-here", "expires_at": "2025-01-27T10:00:00Z", "state": "active"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.create_buff", "buffs.get_buff", "buffs.list_active_buffs", "buffs.get_effective_limits"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "buffs_apply_buff", "semantic_input_mode": "inherit_workflow", "summary": "Apply a buff to an entity (user or project).", "title": "Buffs Apply Buff", "tool_chains": ["user_with_trial", "apply_custom_buff_to_user", "marketing_campaign"], "when_blocked": {"apply_failed": "Failed to apply buff — check buff_id and entity_kind", "buff_not_found": "buffs.list_active_buffs then buffs.create_buff or grant_subscription", "buff_not_pending": "Buff is not in PENDING state — use extend_buff or grant rails", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_entity": "bind context.project_id; user plane needs entity_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not use create+apply for platform premium/vip/scale grants — use buffs.grant_subscription. Tenant buyers: prefer buffs.grant_tenant_subscription over raw create+apply.", "when_to_use": "Low-level buff apply — prefer apply_temporary_effect for trials.", "write_mode": null}, {"action": "buffs.extend_buff", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.extend_buff", "related_tools": ["buffs.get_buff", "buffs.list_active_buffs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Extend Buff", "when_blocked": {"buff_not_active": "Only active buffs extend — check state in list_active_buffs", "buff_not_found": "buffs.list_active_buffs or buffs.get_buff with buff_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "extend_failed": "Retry extend_buff or buffs.grant_tenant_subscription for SKU", "extension_not_supported": "Buff category may not support extend — use grant rails", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Prolong active buff window."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.extend_buff", "related_tools": ["buffs.get_buff", "buffs.list_active_buffs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Extend Buff", "when_blocked": {"buff_not_active": "Only active buffs extend — check state in list_active_buffs", "buff_not_found": "buffs.list_active_buffs or buffs.get_buff with buff_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "extend_failed": "Retry extend_buff or buffs.grant_tenant_subscription for SKU", "extension_not_supported": "Buff category may not support extend — use grant rails", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Prolong active buff window."}, "domain": "buffs", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Extend a subscription buff by 30 days", "name": "Extend by 30 days", "request": {"params": {"additional_days": 30, "buff_id": "uuid-here", "entity_id": 123, "entity_kind": "user"}, "tool": "buffs.extend_buff"}, "response": {"data": {"buff_id": "uuid-here", "expires_at": "2025-02-20T10:00:00Z", "state": "active"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_buff", "buffs.list_active_buffs"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "buffs_extend_buff", "semantic_input_mode": "inherit_workflow", "summary": "Extend the duration of an active buff.", "title": "Buffs Extend Buff", "when_blocked": {"buff_not_active": "Only active buffs extend — check state in list_active_buffs", "buff_not_found": "buffs.list_active_buffs or buffs.get_buff with buff_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "extend_failed": "Retry extend_buff or buffs.grant_tenant_subscription for SKU", "extension_not_supported": "Buff category may not support extend — use grant rails", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Prolong active buff window.", "write_mode": null}, {"action": "buffs.revert_buff", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.revert_buff", "related_tools": ["buffs.get_buff", "buffs.cancel_buff"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Revert Buff", "when_blocked": {"buff_not_active": "revert_buff requires active state", "buff_not_found": "buffs.get_buff — buff_id must be active application id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "persistent_buff": "Use cancel_buff for persistent subscriptions", "revert_failed": "Check permissions and buff_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Undo last buff mutation on a user."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.revert_buff", "related_tools": ["buffs.get_buff", "buffs.cancel_buff"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Revert Buff", "when_blocked": {"buff_not_active": "revert_buff requires active state", "buff_not_found": "buffs.get_buff — buff_id must be active application id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "persistent_buff": "Use cancel_buff for persistent subscriptions", "revert_failed": "Check permissions and buff_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Undo last buff mutation on a user."}, "domain": "buffs", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "examples": [{"description": "Revert an active buff and restore original state", "name": "Revert active buff", "request": {"params": {"buff_id": "uuid-here", "entity_id": 123, "entity_kind": "user", "project_id": 1}, "tool": "buffs.revert_buff"}, "response": {"data": {"buff_id": "uuid-here", "reverted": true}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_buff", "buffs.cancel_buff"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "buffs_revert_buff", "semantic_input_mode": "inherit_workflow", "summary": "Revert an active buff - restore original state from snapshot.", "title": "Buffs Revert Buff", "tool_chains": ["trial_to_paid_tier", "trial_to_premium"], "when_blocked": {"buff_not_active": "revert_buff requires active state", "buff_not_found": "buffs.get_buff — buff_id must be active application id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "persistent_buff": "Use cancel_buff for persistent subscriptions", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "revert_failed": "Check permissions and buff_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Undo last buff mutation on a user.", "write_mode": null}, {"action": "buffs.cancel_buff", "aliases": ["buffs.revoke"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.cancel_buff", "related_tools": ["buffs.get_buff", "buffs.revert_buff"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Cancel Buff", "when_blocked": {"buff_id_required": "buff_id param required", "buff_not_found": "buffs.list_active_buffs then pass buff_id", "cancel_failed": "Retry cancel_buff; verify buff_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project write or buffs.write cap required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "End active buff before expiry."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.cancel_buff", "related_tools": ["buffs.get_buff", "buffs.revert_buff"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Cancel Buff", "when_blocked": {"buff_id_required": "buff_id param required", "buff_not_found": "buffs.list_active_buffs then pass buff_id", "cancel_failed": "Retry cancel_buff; verify buff_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project write or buffs.write cap required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "End active buff before expiry."}, "domain": "buffs", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "examples": [{"description": "Cancel a buff that hasn't been applied yet", "name": "Cancel pending buff", "request": {"params": {"buff_id": "uuid-here", "entity_id": 123, "entity_kind": "user"}, "tool": "buffs.cancel_buff"}, "response": {"data": {"buff_id": "uuid-here", "cancelled": true, "deleted": true, "reverted": false}, "success": true}}, {"description": "Force cancel an active buff (requires admin rights)", "name": "Force cancel active buff", "request": {"params": {"buff_id": "uuid-here", "entity_id": 123, "entity_kind": "user"}, "tool": "buffs.cancel_buff"}, "response": {"data": {"buff_id": "uuid-here", "cancelled": true, "deleted": true, "reverted": true}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_buff", "buffs.revert_buff"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "buffs_cancel_buff", "semantic_input_mode": "inherit_workflow", "summary": "Cancel a buff in any state (force cancellation).", "title": "Buffs Cancel Buff", "when_blocked": {"buff_id_required": "buff_id param required", "buff_not_found": "buffs.list_active_buffs then pass buff_id", "cancel_failed": "Retry cancel_buff; verify buff_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project write or buffs.write cap required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "End active buff before expiry.", "write_mode": null}, {"action": "buffs.get_buff", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.get_buff", "related_tools": ["buffs.list_active_buffs", "buffs.apply_buff", "buffs.extend_buff"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Get Buff", "when_blocked": {"buff_not_found": "buff_id from create_buff, apply_buff, or list_active_buffs", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect one buff definition or active instance."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.get_buff", "related_tools": ["buffs.list_active_buffs", "buffs.apply_buff", "buffs.extend_buff"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Get Buff", "when_blocked": {"buff_not_found": "buff_id from create_buff, apply_buff, or list_active_buffs", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect one buff definition or active instance."}, "domain": "buffs", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve information about a buff", "name": "Get buff info", "request": {"params": {"buff_id": "uuid-here", "entity_id": 123, "entity_kind": "user", "project_id": 1}, "tool": "buffs.get_buff"}, "response": {"data": {"buff_id": "uuid-here", "expires_at": "2025-01-27T10:00:00Z", "is_active": true, "name": "7-Day Premium Trial", "state": "active"}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.list_active_buffs", "buffs.apply_buff", "buffs.extend_buff"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "buffs_get_buff", "semantic_input_mode": "inherit_workflow", "summary": "Get information about a specific buff.", "title": "Buffs Get Buff", "when_blocked": {"buff_not_found": "buff_id from create_buff, apply_buff, or list_active_buffs", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect one buff definition or active instance.", "write_mode": null}, {"action": "buffs.list_active_buffs", "aliases": ["buffs.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.list_active_buffs", "related_tools": ["buffs.get_buff", "buffs.get_effective_limits", "buffs.extend_buff"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs List Active Buffs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_entity": "entity_id + entity_kind required — project plane: entity_kind=project, entity_id=project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_failed": "buffs.get_effective_limits to verify plane; on pid=1 dedupe enterprise rows in response", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List entitlements before get_effective_limits."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.list_active_buffs", "related_tools": ["buffs.get_buff", "buffs.get_effective_limits", "buffs.extend_buff"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs List Active Buffs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_entity": "entity_id + entity_kind required — project plane: entity_kind=project, entity_id=project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_failed": "buffs.get_effective_limits to verify plane; on pid=1 dedupe enterprise rows in response", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List entitlements before get_effective_limits."}, "domain": "buffs", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Get all active buffs for a user", "name": "List all active buffs", "request": {"params": {"entity_id": 123, "entity_kind": "user", "project_id": 1}, "tool": "buffs.list_active_buffs"}, "response": {"data": {"active_buffs": [{"buff_id": "uuid-here", "expires_at": "2025-01-27T10:00:00Z", "name": "Premium Trial", "state": "active"}], "entity_id": 123, "entity_kind": "user"}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_buff", "buffs.get_effective_limits", "buffs.extend_buff"], "required_cap": "mcp_read", "requires_preflight": false, "returns_hint": "active_buffs[].buff_id is the applied instance; application_id alias when present. Project plane: entity_kind=project, entity_id=project_id. include_ecosystem=true merges ecosystem templates (pid=1 storage).", "risk_class": "read", "safe_action": "buffs_list_active_buffs", "semantic_input_mode": "inherit_workflow", "summary": "List active buffs for an entity.", "title": "Buffs List Active Buffs", "tool_chains": ["payment_to_subscription", "apply_custom_buff_to_user"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_entity": "entity_id + entity_kind required — project plane: entity_kind=project, entity_id=project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_failed": "buffs.get_effective_limits to verify plane; on pid=1 dedupe enterprise rows in response", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List entitlements before get_effective_limits.", "write_mode": null}, {"action": "buffs.get_effective_limits", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.get_effective_limits", "related_tools": ["buffs.list_active_buffs", "buffs.apply_buff"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Get Effective Limits", "when_blocked": {"billing_service_unavailable": "Billing service not available — retry or operator session", "calculation_failed": "Failed to calculate effective limits", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_entity": "entity_kind user|project; optional project_id for user-scoped limits", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read merged limits for gating UI and server-side checks."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.get_effective_limits", "related_tools": ["buffs.list_active_buffs", "buffs.apply_buff"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Get Effective Limits", "when_blocked": {"billing_service_unavailable": "Billing service not available — retry or operator session", "calculation_failed": "Failed to calculate effective limits", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_entity": "entity_kind user|project; optional project_id for user-scoped limits", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read merged limits for gating UI and server-side checks."}, "do_not_use_when": "Not for the full Profile billing dashboard (owned projects list, subscription narrative, per-project usage meters). Use REST GET /api/billing/overview (session auth) or @agentstack/sdk AgentBilling.getOverview for that aggregate.", "domain": "buffs", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Get effective limits for a user with all buffs", "name": "Get effective limits", "request": {"params": {"entity_id": 123, "entity_kind": "user", "project_id": 1}, "tool": "buffs.get_effective_limits"}, "response": {"data": {"effective_limits": {"api_calls": 10000, "logic_engine_calls": 5000}, "entity_id": 123, "entity_kind": "user"}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "none", "next_actions": ["limits/entitlements after grant → buffs.get_effective_limits (entity_kind user|project, optional project_id)", "finance hub KPIs → finance.dashboard_bundle", "SPA subscription shell → GET /api/billing/overview"], "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.list_active_buffs", "buffs.apply_buff"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "buffs_get_effective_limits", "semantic_input_mode": "inherit_workflow", "summary": "Get effective limits for an entity with all buffs applied.", "title": "Buffs Get Effective Limits", "when_blocked": {"billing_service_unavailable": "Billing service not available — retry or operator session", "calculation_failed": "Failed to calculate effective limits", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_entity": "entity_kind user|project; optional project_id for user-scoped limits", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Not for the full Profile billing dashboard (owned projects list, subscription narrative, per-project usage meters). Use REST GET /api/billing/overview (session auth) or @agentstack/sdk AgentBilling.getOverview for that aggregate.", "when_to_use": "Read merged limits for gating UI and server-side checks.", "write_mode": null}, {"action": "buffs.apply_temporary_effect", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.apply_temporary_effect", "mutation_risk": "low", "related_tools": ["buffs.get_effective_limits", "payments.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Apply Temporary Effect", "when_blocked": {"apply_failed": "apply_buff path failed after create — see error_code", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "Template create failed — check name/category/effects", "ecosystem_buff_forbidden": "Use tenant plane buffs on PID>1", "invalid_entity": "entity_id + entity_kind required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Time-boxed trial or promo tier — prefer over custom subscription tables."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.apply_temporary_effect", "mutation_risk": "low", "related_tools": ["buffs.get_effective_limits", "payments.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Apply Temporary Effect", "when_blocked": {"apply_failed": "apply_buff path failed after create — see error_code", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "Template create failed — check name/category/effects", "ecosystem_buff_forbidden": "Use tenant plane buffs on PID>1", "invalid_entity": "entity_id + entity_kind required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Time-boxed trial or promo tier — prefer over custom subscription tables."}, "domain": "buffs", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Quickly apply a 2-day bonus", "name": "Apply weekend bonus", "request": {"params": {"duration_days": 2, "effects": {"data.limits.api_calls": 5000}, "entity_id": 123, "entity_kind": "user", "name": "Weekend Bonus"}, "tool": "buffs.apply_temporary_effect"}, "response": {"data": {"applied_at": "2025-01-20T10:00:00Z", "buff_id": "uuid-here", "expires_at": "2025-01-22T10:00:00Z", "state": "active"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_effective_limits", "payments.create"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "buffs_apply_temporary_effect", "semantic_input_mode": "inherit_workflow", "summary": "Quickly apply a temporary effect (creates and applies buff in one step).", "title": "Buffs Apply Temporary Effect", "tool_chains": ["scheduled_rewards", "usage_monitoring"], "when_blocked": {"apply_failed": "apply_buff path failed after create — see error_code", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "Template create failed — check name/category/effects", "ecosystem_buff_forbidden": "Use tenant plane buffs on PID>1", "invalid_entity": "entity_id + entity_kind required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Time-boxed trial or promo tier — prefer over custom subscription tables.", "write_mode": null}, {"action": "buffs.apply_persistent_effect", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.apply_persistent_effect", "mutation_risk": "low", "related_tools": ["buffs.create_buff", "buffs.apply_buff", "buffs.apply_temporary_effect"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Apply Persistent Effect", "when_blocked": {"apply_failed": "apply_buff path failed after create", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "Template create failed — check plan_id slug", "ecosystem_buff_forbidden": "Tenant SKU grants via commerce checkout or grant_tenant_subscription", "invalid_entity": "entity_id + entity_kind required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Grant durable entitlement after payment or admin action."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.apply_persistent_effect", "mutation_risk": "low", "related_tools": ["buffs.create_buff", "buffs.apply_buff", "buffs.apply_temporary_effect"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Apply Persistent Effect", "when_blocked": {"apply_failed": "apply_buff path failed after create", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "Template create failed — check plan_id slug", "ecosystem_buff_forbidden": "Tenant SKU grants via commerce checkout or grant_tenant_subscription", "invalid_entity": "entity_id + entity_kind required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Grant durable entitlement after payment or admin action."}, "domain": "buffs", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Quickly apply a permanent premium upgrade", "name": "Apply lifetime premium", "request": {"params": {"effects": {"data.features.premium": true, "data.limits.api_calls": 1000000}, "entity_id": 123, "entity_kind": "user", "name": "Lifetime Premium"}, "tool": "buffs.apply_persistent_effect"}, "response": {"data": {"applied_at": "2025-01-20T10:00:00Z", "buff_id": "uuid-here", "persistent": true, "state": "active"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.create_buff", "buffs.apply_buff", "buffs.apply_temporary_effect"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "buffs_apply_persistent_effect", "semantic_input_mode": "inherit_workflow", "summary": "Quickly apply a persistent effect (creates and applies permanent buff).", "title": "Buffs Apply Persistent Effect", "when_blocked": {"apply_failed": "apply_buff path failed after create", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "Template create failed — check plan_id slug", "ecosystem_buff_forbidden": "Tenant SKU grants via commerce checkout or grant_tenant_subscription", "invalid_entity": "entity_id + entity_kind required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Grant durable entitlement after payment or admin action.", "write_mode": null}, {"action": "buffs.grant_subscription", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not use buffs.grant_subscription for tenant-app SKU sales — use commerce + buffs.grant_tenant_subscription.", "anti_patterns": ["Do not use buffs.grant_subscription for tenant-app SKU sales — use commerce + buffs.grant_tenant_subscription.", "Do not raw create_buff+apply_buff for platform premium/vip/scale — use this grant rail."], "buffs_atoms": {"BUFFS_GRANT_OPERATOR_PLANE": "Ecosystem operator jurisdiction: buffs.grant_subscription with operator session on ecosystem ops context — personal premium/vip or project launch/business/scale. preflight.check before grant. Not tenant SKU sales."}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Ecosystem operator grants platform subscription tier.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1", "shared.subscription.two_plane.gen1"], "id": "buffs.grant_subscription", "mutation_risk": "high", "related_tools": ["buffs.get_effective_limits", "buffs.create_buff", "buffs.apply_buff"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Buffs Grant Subscription", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem operator only — operator session on ecosystem ops; not tenant SKU sales", "grant_failed": "buffs.get_effective_limits verify; check entity_id and plane", "invalid_tier": "plane+tier from platform grant table (personal premium/vip or project launch+)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "preflight.check with ecosystem ops context bound before grant", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "buffs.write cap on API key — widen service_caps or operator session", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "tier_denied": "tier/cap denied — buffs.get_effective_limits first; verify plane+entity_kind", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem operator grants personal premium/vip or project launch/business/scale."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Ecosystem operator grants platform subscription tier.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1", "shared.subscription.two_plane.gen1"], "id": "buffs.grant_subscription", "mutation_risk": "high", "related_tools": ["buffs.get_effective_limits", "buffs.create_buff", "buffs.apply_buff"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Buffs Grant Subscription", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem operator only — operator session on ecosystem ops; not tenant SKU sales", "grant_failed": "buffs.get_effective_limits verify; check entity_id and plane", "invalid_tier": "plane+tier from platform grant table (personal premium/vip or project launch+)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "preflight.check with ecosystem ops context bound before grant", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "buffs.write cap on API key — widen service_caps or operator session", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "tier_denied": "tier/cap denied — buffs.get_effective_limits first; verify plane+entity_kind", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem operator grants personal premium/vip or project launch/business/scale."}, "doc_audience": "operator", "domain": "buffs", "effect": {"conditional_mutate": "Ecosystem operator grants platform subscription tier.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Ecosystem operator grants platform subscription tier.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "operator_glossary": {"platform_owner_grant": "Ecosystem operator: buffs.grant_subscription (plane, tier, entity_id) or recipe mcp_platform_subscription_grant. Personal: entity_kind=user, project_id=1. Project: entity_kind=project. Business $69: tier=basic (not slug business). Prompt: agentstack_platform_subscription_grant.", "two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"buff_id": {"description": "string", "type": "string"}, "category": {"description": "string", "type": "string"}, "effective_limits": {"additionalProperties": true, "description": "object (when verify=true)", "type": "object"}, "entity_kind": {"description": "string", "type": "string"}, "state": {"description": "string", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Ecosystem operator jurisdiction: buffs.grant_subscription with operator session on ecosystem ops context — personal premium/vip or project launch/business/scale. preflight.check before grant. Not tenant SKU sales.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_effective_limits", "buffs.create_buff", "buffs.apply_buff"], "required_cap": "mcp_read", "requires_preflight": true, "returns_hint": "buff_id = active application id after apply; template_buff_id when a PENDING template was cloned. verify=true attaches flattened effective_limits.limits/features.", "risk_class": "low_write", "safe_action": "buffs_grant_subscription", "semantic_input_mode": "inherit_workflow", "summary": "Platform operator: grant AgentStack subscription tier in one step (resolve → create_buff → apply_buff).", "title": "Buffs Grant Subscription", "tool_chains": ["multi_tenant_onboarding"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem operator only — operator session on ecosystem ops; not tenant SKU sales", "grant_failed": "buffs.get_effective_limits verify; check entity_id and plane", "invalid_tier": "plane+tier from platform grant table (personal premium/vip or project launch+)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "preflight.check with ecosystem ops context bound before grant", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "buffs.write cap on API key — widen service_caps or operator session", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "tier_denied": "tier/cap denied — buffs.get_effective_limits first; verify plane+entity_kind", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem operator grants personal premium/vip or project launch/business/scale.", "write_mode": null}, {"action": "buffs.grant_tenant_subscription", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not call buffs.grant_subscription on tenant PID — platform operator only.", "anti_patterns": ["Do not call buffs.grant_subscription on tenant PID — platform operator only.", "Do not hand-roll subscription tables — tenant paid path is commerce.sell.activate + webhook/C24."], "buffs_atoms": {"BUFFS_GRANT_TENANT_SELF_SERVE": "Tenant operator jurisdiction: buffs.grant_tenant_subscription on tenant project (project write) — manual comp to buyer. Paid checkout auto-grants via webhook/C24. Not buffs.grant_subscription."}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Tenant project grants subscription/comp to buyer user.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1", "shared.subscription.two_plane.gen1"], "id": "buffs.grant_tenant_subscription", "mutation_risk": "high", "related_tools": ["buffs.list_active_buffs", "buffs.create_buff", "commerce.participant.grant_holding", "commerce.sell.activate"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Buffs Grant Tenant Subscription", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "authenticated operator + project_id > 1 — never grant_subscription on tenant PID", "insufficient_permissions": "project write on tenant PID — not personal Premium/VIP", "invalid_project": "context.project_id or params.project_id required (PID>1)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "tenant_grant_failed": "buffs.create_buff SKU first or check plan_id slug", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Tenant agent grants subscription/comp to buyer user_id in tenant project. Support, trials, manual entitlement — not platform AgentStack tiers."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Tenant project grants subscription/comp to buyer user.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1", "shared.subscription.two_plane.gen1"], "id": "buffs.grant_tenant_subscription", "mutation_risk": "high", "related_tools": ["buffs.list_active_buffs", "buffs.create_buff", "commerce.participant.grant_holding", "commerce.sell.activate"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Buffs Grant Tenant Subscription", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "authenticated operator + project_id > 1 — never grant_subscription on tenant PID", "insufficient_permissions": "project write on tenant PID — not personal Premium/VIP", "invalid_project": "context.project_id or params.project_id required (PID>1)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "tenant_grant_failed": "buffs.create_buff SKU first or check plan_id slug", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Tenant agent grants subscription/comp to buyer user_id in tenant project. Support, trials, manual entitlement — not platform AgentStack tiers."}, "doc_audience": "operator", "domain": "buffs", "effect": {"conditional_mutate": "Tenant project grants subscription/comp to buyer user.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Tenant project grants subscription/comp to buyer user.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "operator_glossary": {"tenant_owner_grant": "Tenant operator: buffs.grant_tenant_subscription (user_id, plan_id) or commerce.participant.grant_holding for inventory. Project write on PID>1. Prompt agentstack_tenant_buff_grant. Not buffs.grant_subscription.", "two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"active_buffs": {"description": "array (when verify=true)", "items": {"type": "string"}, "type": "array"}, "buff_id": {"description": "string", "type": "string"}, "expires_at": {"description": "string", "type": "string"}, "plan_id": {"description": "string", "type": "string"}, "recipient_project_id": {"description": "int", "type": "integer"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Tenant operator jurisdiction: buffs.grant_tenant_subscription on tenant project (project write) — manual comp to buyer. Paid checkout auto-grants via webhook/C24. Not buffs.grant_subscription.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.list_active_buffs", "buffs.create_buff", "commerce.participant.grant_holding", "commerce.sell.activate"], "required_cap": "buffs.write", "requires_preflight": true, "risk_class": "low_write", "safe_action": "buffs_grant_tenant_subscription", "semantic_input_mode": "inherit_workflow", "summary": "Tenant operator: grant subscription entitlement to an end user in your project (one-shot).", "title": "Buffs Grant Tenant Subscription", "tool_chains": ["trial_to_paid_tier", "trial_to_premium"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "authenticated operator + project_id > 1 — never grant_subscription on tenant PID", "insufficient_permissions": "project write on tenant PID — not personal Premium/VIP", "invalid_project": "context.project_id or params.project_id required (PID>1)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "tenant_grant_failed": "buffs.create_buff SKU first or check plan_id slug", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Tenant agent grants subscription/comp to buyer user_id in tenant project. Support, trials, manual entitlement — not platform AgentStack tiers.", "write_mode": null}, {"action": "business.get_org", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.business.organism.gen1"], "id": "business.get_org", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Get Org", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get business org config and children index for a head project."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.business.organism.gen1"], "id": "business.get_org", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Get Org", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get business org config and children index for a head project."}, "domain": "business", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Get business org config and children index for a head project.", "mutation_kind": "none", "next_actions": ["business.command_snapshot"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"config": {"additionalProperties": true, "description": "object or null", "type": "object"}, "index": {"additionalProperties": true, "description": "object", "type": "object"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "business_get_org", "semantic_input_mode": "inherit_workflow", "summary": "Get business org config and children index for a head project.", "title": "Business Get Org", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get business org config and children index for a head project.", "write_mode": null}, {"action": "business.list_children", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.business.organism.gen1"], "id": "business.list_children", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business List Children", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List child organ projects for a business head."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.business.organism.gen1"], "id": "business.list_children", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business List Children", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List child organ projects for a business head."}, "domain": "business", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List child organ projects for a business head.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"items": {"description": "Child organ rows (project_id, organ, display_name, status, …)", "items": {"type": "object"}, "type": "array"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "business_list_children", "semantic_input_mode": "inherit_workflow", "summary": "List child organ projects for a business head.", "title": "Business List Children", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List child organ projects for a business head.", "write_mode": null}, {"action": "business.attach_child", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Federates child organ with head business org.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.attach_child", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Attach Child", "when_blocked": {"business_quota_exceeded": "Reduce organs — business.list_children then tariff", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "organ_already_attached": "business.list_children — detach before re-attach", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add one missing organ to an existing head. Do not call this for organs business.create_composite already created. Stay under the tariff child cap."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Federates child organ with head business org.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.attach_child", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Attach Child", "when_blocked": {"business_quota_exceeded": "Reduce organs — business.list_children then tariff", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "organ_already_attached": "business.list_children — detach before re-attach", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add one missing organ to an existing head. Do not call this for organs business.create_composite already created. Stay under the tariff child cap."}, "do_not_use_when": "Do not re-attach organs create_composite already returned. Single-project edits — use projects.* on that child.", "domain": "business", "effect": {"conditional_mutate": "Federates child organ with head business org.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Federates child organ with head business org.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "instruction_hint": "Add one missing organ to an existing head. Do not call this for organs business.create_composite al…", "mutation_kind": "entity", "next_actions": ["business.list_children"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"display_name": {"description": "Child label on index", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "link_mode": {"description": "attach | adopt when applicable", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "organ": {"description": "Organ kind (crm, storefront, …)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Child organ project id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "business_attach_child", "semantic_input_mode": "inherit_workflow", "summary": "Attach a child organ project to a business head.", "title": "Business Attach Child", "when_blocked": {"business_quota_exceeded": "Reduce organs — business.list_children then tariff", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "organ_already_attached": "business.list_children — detach before re-attach", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not re-attach organs create_composite already returned. Single-project edits — use projects.* on that child.", "when_to_use": "Add one missing organ to an existing head. Do not call this for organs business.create_composite already created. Stay under the tariff child cap.", "write_mode": null}, {"action": "business.link_child", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "business.link_child", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Business Link Child", "when_blocked": {"business_quota_exceeded": "Detach or upgrade tariff before link", "child_access_denied": "Actor must admin both head and child project", "child_same_as_head": "existing_project_id must differ from head project_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry with idempotency_key unchanged", "existing_project_id_required": "business.list_adopt_candidates on head project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Link an existing owned project as a business organ (adopt)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "business.link_child", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Business Link Child", "when_blocked": {"business_quota_exceeded": "Detach or upgrade tariff before link", "child_access_denied": "Actor must admin both head and child project", "child_same_as_head": "existing_project_id must differ from head project_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry with idempotency_key unchanged", "existing_project_id_required": "business.list_adopt_candidates on head project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Link an existing owned project as a business organ (adopt)."}, "domain": "business", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Link an existing owned project as a business organ (adopt).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "business_link_child", "semantic_input_mode": "inherit_workflow", "summary": "Link an existing owned project as a business organ (adopt).", "title": "Business Link Child", "when_blocked": {"business_quota_exceeded": "Detach or upgrade tariff before link", "child_access_denied": "Actor must admin both head and child project", "child_same_as_head": "existing_project_id must differ from head project_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry with idempotency_key unchanged", "existing_project_id_required": "business.list_adopt_candidates on head project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Link an existing owned project as a business organ (adopt).", "write_mode": null}, {"action": "business.list_adopt_candidates", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "business.list_adopt_candidates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Business List Adopt Candidates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List projects eligible for adopt/link into a business head."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "business.list_adopt_candidates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Business List Adopt Candidates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List projects eligible for adopt/link into a business head."}, "domain": "business", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List projects eligible for adopt/link into a business head.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "business_list_adopt_candidates", "semantic_input_mode": "inherit_workflow", "summary": "List projects eligible for adopt/link into a business head.", "title": "Business List Adopt Candidates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List projects eligible for adopt/link into a business head.", "write_mode": null}, {"action": "business.list_composite_adopt_candidates", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "business.list_composite_adopt_candidates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Business List Composite Adopt Candidates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry — list standalone projects for adopt[]", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List standalone projects eligible for adopt during composite business create."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "business.list_composite_adopt_candidates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Business List Composite Adopt Candidates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry — list standalone projects for adopt[]", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List standalone projects eligible for adopt during composite business create."}, "domain": "business", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List standalone projects eligible for adopt during composite business create.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "business_list_composite_adopt_candidates", "semantic_input_mode": "inherit_workflow", "summary": "List standalone projects eligible for adopt during composite business create.", "title": "Business List Composite Adopt Candidates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry — list standalone projects for adopt[]", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List standalone projects eligible for adopt during composite business create.", "write_mode": null}, {"action": "business.transfer_preflight", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "business.transfer_preflight", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Business Transfer Preflight", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; inspect blockers[] on success with can_transfer=false", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_project_owner": "Only project owner may run sale/transfer preflight", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Scan transfer blockers before listing a project for sale."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "business.transfer_preflight", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Business Transfer Preflight", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; inspect blockers[] on success with can_transfer=false", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_project_owner": "Only project owner may run sale/transfer preflight", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Scan transfer blockers before listing a project for sale."}, "domain": "business", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Scan transfer blockers before listing a project for sale.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "financial", "safe_action": "business_transfer_preflight", "semantic_input_mode": "inherit_workflow", "summary": "Scan transfer blockers before listing a project for sale.", "title": "Business Transfer Preflight", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; inspect blockers[] on success with can_transfer=false", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_project_owner": "Only project owner may run sale/transfer preflight", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Scan transfer blockers before listing a project for sale.", "write_mode": null}, {"action": "business.detach_child", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Removes child from head org; revokes federation/channels/access.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.detach_child", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Detach Child", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Detach a child organ from business head."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Removes child from head org; revokes federation/channels/access.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.detach_child", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Detach Child", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Detach a child organ from business head."}, "domain": "business", "effect": {"conditional_mutate": "Removes child from head org; revokes federation/channels/access.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Removes child from head org; revokes federation/channels/access.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "instruction_hint": "Detach a child organ from business head.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"detached_project_id": {"description": "Child project id removed from head", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "Detach succeeded", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "business_detach_child", "semantic_input_mode": "inherit_workflow", "summary": "Detach a child organ from business head.", "title": "Business Detach Child", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Detach a child organ from business head.", "write_mode": null}, {"action": "business.command_snapshot", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.command_snapshot", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Command Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once after project_id bind", "forbidden": "business command read — finance/CRM membership on head", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Primary BFF read for business head — not projects.get_data blob."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.command_snapshot", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Command Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once after project_id bind", "forbidden": "business command read — finance/CRM membership on head", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Primary BFF read for business head — not projects.get_data blob."}, "domain": "business", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Primary BFF read for business head — not projects.get_data blob.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"as_of": {"description": "UTC ISO snapshot timestamp", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "business_treasury": {"description": "Treasury aggregate across head + children", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "children": {"description": "Child organ project rows (limit 50)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "children_finance": {"description": "Per-child finance rollup when children exist", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "crm": {"description": "CRM hub cold summary", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "display_name": {"description": "Resolved portfolio display label", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "finance": {"description": "Finance dashboard bundle for head", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "head_project_id": {"description": "Business head project id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "integrations_index": {"description": "Rollup when include_integrations=true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "metrics": {"description": "Optional metrics slice", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "onboarding_pointers": {"description": "Closed-loop discovery hints", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "org": {"description": "org_summary config + children index", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "staff": {"description": "Staff roster summary slice", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "tariff": {"description": "Business tariff slice for actor", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "business_command_snapshot", "semantic_input_mode": "inherit_workflow", "summary": "Business command center aggregate (finance + CRM + org).", "title": "Business Command Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once after project_id bind", "forbidden": "business command read — finance/CRM membership on head", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Primary BFF read for business head — not projects.get_data blob.", "write_mode": null}, {"action": "business.create_composite", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.create_composite", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Create Composite", "when_blocked": {"business_quota_exceeded": "Reduce organs[] — check max_business_children on tariff", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Inspect saga rollback — list_children before retry", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "organs_empty": "Omit organs for crm+storefront default or pass adopt[]", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "New company only: one call returns head_project_id and children[].project_id. Do not business.attach_child those organs again. CRM contacts use the CRM child project_id from children[] (resolve_child"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.create_composite", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Create Composite", "when_blocked": {"business_quota_exceeded": "Reduce organs[] — check max_business_children on tariff", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Inspect saga rollback — list_children before retry", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "organs_empty": "Omit organs for crm+storefront default or pass adopt[]", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "New company only: one call returns head_project_id and children[].project_id. Do not business.attach_child those organs again. CRM contacts use the CRM child project_id from children[] (resolve_child"}, "do_not_use_when": "Head already exists — use business.attach_child or business.link_child for one extra organ. Do not call create_composite again for the same company.", "domain": "business", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "New company only: one call returns head_project_id and children[].project_id. Do not business.attac…", "mutation_kind": "entity", "next_actions": ["business.list_children", "business.resolve_child"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"children": {"description": "Attached organ child summaries", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "head_project_id": {"description": "New business head project id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "name": {"description": "Head display name", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "Composite create succeeded", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "business_create_composite", "semantic_input_mode": "inherit_workflow", "summary": "Create business head + attach organ children from template.", "title": "Business Create Composite", "when_blocked": {"business_quota_exceeded": "Reduce organs[] — check max_business_children on tariff", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Inspect saga rollback — list_children before retry", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "organs_empty": "Omit organs for crm+storefront default or pass adopt[]", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Head already exists — use business.attach_child or business.link_child for one extra organ. Do not call create_composite again for the same company.", "when_to_use": "New company only: one call returns head_project_id and children[].project_id. Do not business.attach_child those organs again. CRM contacts use the CRM child project_id from children[] (resolve_child", "write_mode": null}, {"action": "business.resolve_child", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.business.organism.gen1"], "id": "business.resolve_child", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Business Resolve Child", "when_blocked": {"ambiguous_display_name": "Narrow organ= or use unique display_name", "child_not_found": "business.list_children — confirm display_name and organ=crm", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "display_name required": "Pass exact display_name from business.list_children", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "project_admin or head read membership required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After business.create_composite: map organ display_name to child project_id for crm.* on that organ. Prefer children[] from create_composite — avoid extra list_children when the recipe already returne"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.business.organism.gen1"], "id": "business.resolve_child", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Business Resolve Child", "when_blocked": {"ambiguous_display_name": "Narrow organ= or use unique display_name", "child_not_found": "business.list_children — confirm display_name and organ=crm", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "display_name required": "Pass exact display_name from business.list_children", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "project_admin or head read membership required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After business.create_composite: map organ display_name to child project_id for crm.* on that organ. Prefer children[] from create_composite — avoid extra list_children when the recipe already returne"}, "domain": "business", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "After business.create_composite: map organ display_name to child project_id for crm.* on that organ…", "mutation_kind": "none", "next_actions": ["crm.get_crm_config", "crm.upsert_contact"], "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "business_resolve_child", "semantic_input_mode": "inherit_workflow", "summary": "Resolve child organ project_id by display_name under a business head.", "title": "Business Resolve Child", "when_blocked": {"ambiguous_display_name": "Narrow organ= or use unique display_name", "child_not_found": "business.list_children — confirm display_name and organ=crm", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "display_name required": "Pass exact display_name from business.list_children", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "project_admin or head read membership required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After business.create_composite: map organ display_name to child project_id for crm.* on that organ. Prefer children[] from create_composite — avoid extra list_children when the recipe already returne", "write_mode": null}, {"action": "business.list_tariff_templates", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.business.organism.gen1"], "id": "business.list_tariff_templates", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business List Tariff Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List business tariff templates available for a head project."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.business.organism.gen1"], "id": "business.list_tariff_templates", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business List Tariff Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List business tariff templates available for a head project."}, "domain": "business", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List business tariff templates available for a head project.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"items": {"description": "template_id, category, name, effects per row", "items": {"type": "object"}, "type": "array"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "business_list_tariff_templates", "semantic_input_mode": "inherit_workflow", "summary": "List business tariff templates available for a head project.", "title": "Business List Tariff Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List business tariff templates available for a head project.", "write_mode": null}, {"action": "business.apply_tariff", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.apply_tariff", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Apply Tariff", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "template_id_required": "business.list_tariff_templates — pick template_id", "unauthorized": "auth.get_profile — operator session required", "unknown_tariff_template": "template_id from list_tariff_templates catalog", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply a tariff template to a business head project."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.apply_tariff", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Apply Tariff", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "template_id_required": "business.list_tariff_templates — pick template_id", "unauthorized": "auth.get_profile — operator session required", "unknown_tariff_template": "template_id from list_tariff_templates catalog", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply a tariff template to a business head project."}, "domain": "business", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Apply a tariff template to a business head project.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"applied_buff_id": {"description": "Effective buff id on head", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "buff_id": {"description": "Requested buff id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "Tariff apply succeeded", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "template_id": {"description": "Applied catalog template id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "business_apply_tariff", "semantic_input_mode": "inherit_workflow", "summary": "Apply a tariff template to a business head project.", "title": "Business Apply Tariff", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "template_id_required": "business.list_tariff_templates — pick template_id", "unauthorized": "auth.get_profile — operator session required", "unknown_tariff_template": "template_id from list_tariff_templates catalog", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply a tariff template to a business head project.", "write_mode": null}, {"action": "business.patch_org_settings", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.patch_org_settings", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Patch Org Settings", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "settings_required": "Pass settings object — partial org config leaf", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch business head org settings (config.org leaf)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.patch_org_settings", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Patch Org Settings", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "settings_required": "Pass settings object — partial org config leaf", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch business head org settings (config.org leaf)."}, "domain": "business", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Patch business head org settings (config.org leaf).", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"org": {"description": "BusinessOrgConfig dump after merge", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "Patch persisted", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "business_patch_org_settings", "semantic_input_mode": "inherit_workflow", "summary": "Patch business head org settings (config.org leaf).", "title": "Business Patch Org Settings", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "settings_required": "Pass settings object — partial org config leaf", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch business head org settings (config.org leaf).", "write_mode": null}, {"action": "calendar.events", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "calendar", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.calendar.gen1"], "id": "calendar.events", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Calendar Events", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Show project calendar month view before upserting manual events."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "calendar", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.calendar.gen1"], "id": "calendar.events", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Calendar Events", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Show project calendar month view before upserting manual events."}, "domain": "calendar", "domain_title": "Calendar MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.calendar.gen1"], "instruction_hint": "Show project calendar month view before upserting manual events.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.calendar", "owner_gene": "core.mcp.calendar.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "calendar_events", "semantic_input_mode": "inherit_workflow", "summary": "List calendar events merged from CRM deals, activities, invoices, manual.", "title": "Calendar Events", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Show project calendar month view before upserting manual events.", "write_mode": null}, {"action": "calendar.event.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "calendar", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.calendar.gen1"], "id": "calendar.event.upsert", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Calendar Event Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add or edit a manual calendar block after calendar.events."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "calendar", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.calendar.gen1"], "id": "calendar.event.upsert", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Calendar Event Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add or edit a manual calendar block after calendar.events."}, "domain": "calendar", "domain_title": "Calendar MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.calendar.gen1"], "instruction_hint": "Add or edit a manual calendar block after calendar.events.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.calendar", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"event": {"additionalProperties": true, "description": "object", "type": "object"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.calendar.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["calendar.event.delete"], "safe_action": "calendar_event_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Create or update a manual calendar event on ecosystem.calendar.manual_events.", "title": "Calendar Event Upsert", "verification": ["calendar.events"], "verify": [{"action": "calendar.events", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add or edit a manual calendar block after calendar.events.", "write_mode": null}, {"action": "calendar.event.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "calendar", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.calendar.gen1"], "id": "calendar.event.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Calendar Event Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove a manual event by id from calendar.events."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "calendar", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.calendar.gen1"], "id": "calendar.event.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Calendar Event Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove a manual event by id from calendar.events."}, "domain": "calendar", "domain_title": "Calendar MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.calendar.gen1"], "instruction_hint": "Remove a manual event by id from calendar.events.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.calendar", "owner_gene": "core.mcp.calendar.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "calendar_event_delete", "semantic_input_mode": "inherit_workflow", "summary": "Delete a manual calendar event by id.", "title": "Calendar Event Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove a manual event by id from calendar.events.", "write_mode": null}, {"action": "commands.execute", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commands", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.commands.gen1"], "id": "commands.execute", "mutation_risk": "low", "related_tools": ["commands.execute_batch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commands Execute", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_failed": "Command execution failed. Check error message for details", "insufficient_permissions": "RBAC denied — bind context.project_id; check project membership and service caps.", "invalid_command_type": "Prefer domain MCP (projects.patch_data, logic.*, hosting.*) — commands.execute is low-level Protein bus only when no action fits.", "invalid_payload": "Payload needs target_entity and operation_type — discovery.describe for domain actions before raw dna_crud.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "timeout": "Command execution timed out", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Low-level Protein bus when no domain MCP action fits — prefer projects.patch_data, logic.*, hosting.*, etc. Mutates when payload.operation_type is create|update|delete|delta. Omit generation_env_uuid"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commands", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.commands.gen1"], "id": "commands.execute", "mutation_risk": "low", "related_tools": ["commands.execute_batch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commands Execute", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_failed": "Command execution failed. Check error message for details", "insufficient_permissions": "RBAC denied — bind context.project_id; check project membership and service caps.", "invalid_command_type": "Prefer domain MCP (projects.patch_data, logic.*, hosting.*) — commands.execute is low-level Protein bus only when no action fits.", "invalid_payload": "Payload needs target_entity and operation_type — discovery.describe for domain actions before raw dna_crud.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "timeout": "Command execution timed out", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Low-level Protein bus when no domain MCP action fits — prefer projects.patch_data, logic.*, hosting.*, etc. Mutates when payload.operation_type is create|update|delete|delta. Omit generation_env_uuid"}, "domain": "commands", "domain_title": "Commands MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Retrieve project information using DNA_CRUD command", "name": "Get a project by ID", "request": {"params": {"command_name": "get_project", "command_type": "dna_crud", "payload": {"filters": {"project_id": 123}, "operation_type": "get", "target_entity": "data_projects_8dna"}, "priority": 5, "timeout_ms": 30000}, "tool": "commands.execute"}, "response": {"data": {"command_uuid": "550e8400-e29b-41d4-a716-446655440000", "execution_time_ms": 45.2, "result": {"description": "Project description", "id": 123, "is_active": true, "name": "My Project"}, "status": "completed"}, "execution_time_ms": 45.2, "success": true, "trace_id": "trace-123"}}, {"description": "Create a new project using DNA_CRUD command", "name": "Create a new project", "request": {"params": {"command_name": "create_project", "command_type": "dna_crud", "payload": {"input_data": {"description": "Project description", "is_active": true, "name": "My New Project"}, "operation_type": "create", "target_entity": "data_projects_8dna"}}, "tool": "commands.execute"}, "response": {"data": {"command_uuid": "550e8400-e29b-41d4-a716-446655440001", "execution_time_ms": 78.5, "result": {"created_at": "2025-01-20T10:00:00Z", "id": 124, "name": "My New Project"}, "status": "completed"}, "success": true}}, {"description": "Update existing project using DNA_CRUD command", "name": "Update project", "request": {"params": {"command_name": "update_project", "command_type": "dna_crud", "payload": {"filters": {"project_id": 123}, "operation_type": "update", "target_entity": "data_projects_8dna", "updates": {"description": "Updated description", "name": "Updated Project Name"}}}, "tool": "commands.execute"}, "response": {"data": {"command_uuid": "550e8400-e29b-41d4-a716-446655440002", "result": {"id": 123, "name": "Updated Project Name", "updated_at": "2025-01-20T10:05:00Z"}, "status": "completed"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.commands.gen1"], "instruction_hint": "Low-level Protein bus when no domain MCP action fits — prefer projects.patch_data, logic.*, hosting…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commands", "owner_gene": "core.mcp.commands.gen1", "plane": "App commands: commands.execute. Processor list: processors.list.", "plane_chooser": "App commands: commands.execute. Processor list: processors.list.", "related_tools": ["commands.execute_batch"], "required_cap": "logic_write|mcp.execute", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commands_execute", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Execute a single Protein Command via universal API.", "title": "Commands Execute", "tool_chains": ["game_setup"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_failed": "Command execution failed. Check error message for details", "insufficient_permissions": "RBAC denied — bind context.project_id; check project membership and service caps.", "invalid_command_type": "Prefer domain MCP (projects.patch_data, logic.*, hosting.*) — commands.execute is low-level Protein bus only when no action fits.", "invalid_payload": "Payload needs target_entity and operation_type — discovery.describe for domain actions before raw dna_crud.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "timeout": "Command execution timed out", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Low-level Protein bus when no domain MCP action fits — prefer projects.patch_data, logic.*, hosting.*, etc. Mutates when payload.operation_type is create|update|delete|delta. Omit generation_env_uuid", "write_mode": null}, {"action": "commands.execute_batch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commands", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.commands.gen1"], "id": "commands.execute_batch", "mutation_risk": "low", "related_tools": ["commands.execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commands Execute Batch", "when_blocked": {"batch_execution_failed": "Inspect per-index results — fail_fast stops on first error; fix upstream command.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_commands": "Pass non-empty commands list — same shape as commands.execute params.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Batch Protein commands — same fork/accumulation rules as commands.execute. Use fail_fast to stop on first error."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commands", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.commands.gen1"], "id": "commands.execute_batch", "mutation_risk": "low", "related_tools": ["commands.execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commands Execute Batch", "when_blocked": {"batch_execution_failed": "Inspect per-index results — fail_fast stops on first error; fix upstream command.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_commands": "Pass non-empty commands list — same shape as commands.execute params.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Batch Protein commands — same fork/accumulation rules as commands.execute. Use fail_fast to stop on first error."}, "domain": "commands", "domain_title": "Commands MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Execute two commands concurrently to get project and user data", "name": "Execute multiple commands in parallel", "request": {"params": {"commands": [{"command_name": "get_project", "command_type": "dna_crud", "payload": {"filters": {"project_id": 123}, "operation_type": "get", "target_entity": "data_projects_8dna"}}, {"command_name": "get_users", "command_type": "dna_crud", "payload": {"filters": {"project_id": 123}, "operation_type": "get", "target_entity": "data_projects_8dna"}}], "execute_parallel": true, "fail_fast": false}, "tool": "commands.execute_batch"}, "response": {"data": {"failed_commands": 0, "results": [{"command_uuid": "uuid-1", "result": {"id": 123, "name": "My Project"}, "status": "completed"}, {"command_uuid": "uuid-2", "result": [{"email": "user@example.com", "user_id": 1}], "status": "completed"}], "successful_commands": 2, "total_commands": 2, "total_execution_time_ms": 125.5}, "success": true}}, {"description": "Execute commands one after another, where second command depends on first", "name": "Execute commands sequentially", "request": {"params": {"commands": [{"command_name": "create_project", "command_type": "dna_crud", "payload": {"input_data": {"name": "New Project"}, "operation_type": "create", "target_entity": "data_projects_8dna"}}, {"command_name": "create_api_key", "command_type": "dna_crud", "payload": {"input_data": {"project_id": "{{result[0].id}}"}, "operation_type": "create", "target_entity": "api_keys"}}], "execute_parallel": false, "fail_fast": true}, "tool": "commands.execute_batch"}, "response": {"data": {"failed_commands": 0, "results": [{"command_uuid": "uuid-1", "result": {"id": 123}, "status": "completed"}], "successful_commands": 2, "total_commands": 2, "total_execution_time_ms": 250.0}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.commands.gen1"], "instruction_hint": "Batch Protein commands — same fork/accumulation rules as commands.execute. Use fail_fast to stop on…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commands", "owner_gene": "core.mcp.commands.gen1", "plane": "App commands: commands.execute. Processor list: processors.list.", "plane_chooser": "App commands: commands.execute. Processor list: processors.list.", "related_tools": ["commands.execute"], "required_cap": "logic_write|mcp.execute", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commands_execute_batch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Execute multiple Protein Commands in batch.", "title": "Commands Execute Batch", "when_blocked": {"batch_execution_failed": "Inspect per-index results — fail_fast stops on first error; fix upstream command.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_commands": "Pass non-empty commands list — same shape as commands.execute params.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Batch Protein commands — same fork/accumulation rules as commands.execute. Use fail_fast to stop on first error.", "write_mode": null}, {"action": "cardgame.dna.read_rows", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "cardgame", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.cardgame.gen1"], "id": "cardgame.dna.read_rows", "related_tools": ["commands.execute", "cardgame.rules.execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Cardgame Dna Read Rows", "when_to_use": "Read public or owner-scoped cardgame state for reasoning before proposing a move."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "cardgame", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.cardgame.gen1"], "id": "cardgame.dna.read_rows", "related_tools": ["commands.execute", "cardgame.rules.execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Cardgame Dna Read Rows", "when_to_use": "Read public or owner-scoped cardgame state for reasoning before proposing a move."}, "domain": "cardgame", "domain_title": "Cardgame MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.cardgame.gen1"], "instruction_hint": "Read public or owner-scoped cardgame state for reasoning before proposing a move.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.cardgame", "owner_gene": "core.mcp.cardgame.gen1", "related_tools": ["commands.execute", "cardgame.rules.execute"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "cardgame_dna_read_rows", "semantic_input_mode": "inherit_workflow", "summary": "List up to ``limit`` rows for a cardgame 8DNA entity type using DNA CRUD get (same permission model as the SPA). Use for match room / cell snapshots when building agent context.", "title": "Cardgame Dna Read Rows", "when_to_use": "Read public or owner-scoped cardgame state for reasoning before proposing a move.", "write_mode": null}, {"action": "cardgame.rules.execute", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "cardgame", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.cardgame.gen1"], "id": "cardgame.rules.execute", "related_tools": ["cardgame.dna.read_rows", "logic.execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Cardgame Rules Execute", "when_to_use": "Let an agent take a turn or advance match flow after validating legality server-side."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "cardgame", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.cardgame.gen1"], "id": "cardgame.rules.execute", "related_tools": ["cardgame.dna.read_rows", "logic.execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Cardgame Rules Execute", "when_to_use": "Let an agent take a turn or advance match flow after validating legality server-side."}, "domain": "cardgame", "domain_title": "Cardgame MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.cardgame.gen1"], "instruction_hint": "Let an agent take a turn or advance match flow after validating legality server-side.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.cardgame", "owner_gene": "core.mcp.cardgame.gen1", "related_tools": ["cardgame.dna.read_rows", "logic.execute"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "cardgame_rules_execute", "semantic_input_mode": "inherit_workflow", "summary": "Execute a Logic Engine command for ArcaneStack (e.g. ``cardgame.match.play_card``) with the same payload shape as the game client. Requires authenticated MCP context.", "title": "Cardgame Rules Execute", "when_to_use": "Let an agent take a turn or advance match flow after validating legality server-side.", "write_mode": null}, {"action": "checklist.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "checklist", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.checklist.gen1", "core.work.checklist.gen1"], "id": "checklist.get", "related_tools": ["checklist.toggle_item", "checklist.append_item", "crm.get_deal"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Checklist Get", "visitor_callable": false, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied — project membership or CRM read cap required.", "invalid_parameters": "entity_id required — pass CRM entity id.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Malformed params — fix entity_type / entity_id."}, "when_to_use": "Read deal or task checklist before toggling items."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "checklist", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.checklist.gen1", "core.work.checklist.gen1"], "id": "checklist.get", "related_tools": ["checklist.toggle_item", "checklist.append_item", "crm.get_deal"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Checklist Get", "visitor_callable": false, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied — project membership or CRM read cap required.", "invalid_parameters": "entity_id required — pass CRM entity id.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Malformed params — fix entity_type / entity_id."}, "when_to_use": "Read deal or task checklist before toggling items."}, "domain": "checklist", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"params": {"entity_id": "deal-abc", "entity_type": "crm_deal", "project_id": 1}}], "execution_class": "plain_read", "instruction_hint": "Read deal or task checklist before toggling items.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Before go-live: preflight.check, then checklist.get.", "plane_chooser": "Before go-live: preflight.check, then checklist.get.", "related_prompts": ["agentstack_hosted_vertical"], "related_tools": ["checklist.toggle_item", "checklist.append_item", "crm.get_deal"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "checklist_get", "semantic_input_mode": "inherit_workflow", "summary": "Get checklist for an entity (e.g. crm_deal).", "title": "Checklist Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied — project membership or CRM read cap required.", "invalid_parameters": "entity_id required — pass CRM entity id.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Malformed params — fix entity_type / entity_id."}, "when_to_use": "Read deal or task checklist before toggling items.", "write_mode": null}, {"action": "checklist.set", "ai_tips": "Replace full checklist snapshot on a CRM deal or work item (write_mode=replace only).", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "checklist", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.checklist.gen1", "core.work.checklist.gen1"], "id": "checklist.set", "related_tools": ["checklist.get", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Checklist Set", "visitor_callable": false, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied for checklist write on this entity.", "invalid_parameters": "items must be a non-empty array; entity_id required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Item objects need id + label and valid status enum.", "write_mode_unsupported": "checklist.set only supports write_mode=replace."}, "when_to_use": "Replace full checklist template on a CRM deal or work item."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "checklist", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.checklist.gen1", "core.work.checklist.gen1"], "id": "checklist.set", "related_tools": ["checklist.get", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Checklist Set", "visitor_callable": false, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied for checklist write on this entity.", "invalid_parameters": "items must be a non-empty array; entity_id required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Item objects need id + label and valid status enum.", "write_mode_unsupported": "checklist.set only supports write_mode=replace."}, "when_to_use": "Replace full checklist template on a CRM deal or work item."}, "domain": "checklist", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Replace deal checklist snapshot", "params": {"entity_id": "deal-abc", "entity_type": "crm_deal", "items": [{"id": "step-1", "label": "Confirm budget", "status": "open"}], "project_id": 1, "write_mode": "replace"}}], "execution_class": "cheap", "instruction_hint": "Replace full checklist template on a CRM deal or work item.", "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"checklist": {"additionalProperties": true, "description": "object", "type": "object"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Before go-live: preflight.check, then checklist.get.", "plane_chooser": "Before go-live: preflight.check, then checklist.get.", "related_prompts": ["agentstack_hosted_vertical"], "related_tools": ["checklist.get", "preflight.check"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "rollback": ["checklist.set"], "safe_action": "checklist_set", "semantic_input_mode": "inherit_workflow", "summary": "Replace checklist items for an entity.", "title": "Checklist Set", "verification": ["checklist.get"], "verify": [{"action": "checklist.get", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied for checklist write on this entity.", "invalid_parameters": "items must be a non-empty array; entity_id required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Item objects need id + label and valid status enum.", "write_mode_unsupported": "checklist.set only supports write_mode=replace."}, "when_to_use": "Replace full checklist template on a CRM deal or work item.", "write_mode": ["replace"], "write_mode_note": "checklist.set replaces the full items list — write_mode defaults to replace."}, {"action": "checklist.toggle_item", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "checklist", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.checklist.gen1", "core.work.checklist.gen1"], "id": "checklist.toggle_item", "related_tools": ["checklist.get", "crm.get_deal"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Checklist Toggle Item", "visitor_callable": false, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied for checklist mutate.", "invalid_parameters": "item_id and entity_id required.", "item_not_found": "Unknown item_id — checklist.get first.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark one checklist step done or reopen after checklist.get."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "checklist", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.checklist.gen1", "core.work.checklist.gen1"], "id": "checklist.toggle_item", "related_tools": ["checklist.get", "crm.get_deal"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Checklist Toggle Item", "visitor_callable": false, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied for checklist mutate.", "invalid_parameters": "item_id and entity_id required.", "item_not_found": "Unknown item_id — checklist.get first.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark one checklist step done or reopen after checklist.get."}, "domain": "checklist", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"params": {"entity_id": "deal-abc", "entity_type": "crm_deal", "item_id": "step-1", "project_id": 1, "status": "done"}}], "execution_class": "cheap", "instruction_hint": "Mark one checklist step done or reopen after checklist.get.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Before go-live: preflight.check, then checklist.get.", "plane_chooser": "Before go-live: preflight.check, then checklist.get.", "related_prompts": ["agentstack_hosted_vertical"], "related_tools": ["checklist.get", "crm.get_deal"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "checklist_toggle_item", "semantic_input_mode": "inherit_workflow", "summary": "Toggle or set status on one checklist item.", "title": "Checklist Toggle Item", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied for checklist mutate.", "invalid_parameters": "item_id and entity_id required.", "item_not_found": "Unknown item_id — checklist.get first.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark one checklist step done or reopen after checklist.get.", "write_mode": null}, {"action": "checklist.append_item", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "checklist", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.checklist.gen1", "core.work.checklist.gen1"], "id": "checklist.append_item", "related_tools": ["checklist.get", "checklist.set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Checklist Append Item", "visitor_callable": false, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied for checklist mutate.", "invalid_parameters": "label and entity_id required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add a new step to an existing entity checklist."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "checklist", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.checklist.gen1", "core.work.checklist.gen1"], "id": "checklist.append_item", "related_tools": ["checklist.get", "checklist.set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Checklist Append Item", "visitor_callable": false, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied for checklist mutate.", "invalid_parameters": "label and entity_id required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add a new step to an existing entity checklist."}, "domain": "checklist", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Append CRM deal step", "params": {"entity_id": "deal-abc", "entity_type": "crm_deal", "label": "Send contract draft", "project_id": 1}}], "execution_class": "cheap", "instruction_hint": "Add a new step to an existing entity checklist.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Before go-live: preflight.check, then checklist.get.", "plane_chooser": "Before go-live: preflight.check, then checklist.get.", "related_prompts": ["agentstack_hosted_vertical"], "related_tools": ["checklist.get", "checklist.set"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "checklist_append_item", "semantic_input_mode": "inherit_workflow", "summary": "Append a checklist step.", "title": "Checklist Append Item", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied for checklist mutate.", "invalid_parameters": "label and entity_id required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add a new step to an existing entity checklist.", "write_mode": null}, {"action": "checklist.clear", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "checklist", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.checklist.gen1", "core.work.checklist.gen1"], "id": "checklist.clear", "related_tools": ["checklist.get", "checklist.set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Checklist Clear", "visitor_callable": false, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied for checklist mutate.", "invalid_parameters": "entity_id required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reset deal or work-item checklist before cert cleanup or template swap."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "checklist", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.checklist.gen1", "core.work.checklist.gen1"], "id": "checklist.clear", "related_tools": ["checklist.get", "checklist.set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Checklist Clear", "visitor_callable": false, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied for checklist mutate.", "invalid_parameters": "entity_id required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reset deal or work-item checklist before cert cleanup or template swap."}, "domain": "checklist", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Reset deal or work-item checklist before cert cleanup or template swap.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"checklist": {"additionalProperties": true, "description": "object", "type": "object"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Before go-live: preflight.check, then checklist.get.", "plane_chooser": "Before go-live: preflight.check, then checklist.get.", "related_prompts": ["agentstack_hosted_vertical"], "related_tools": ["checklist.get", "checklist.set"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "checklist_clear", "semantic_input_mode": "inherit_workflow", "summary": "Clear all checklist items for an entity.", "title": "Checklist Clear", "verification": ["checklist.get"], "verify": [{"action": "checklist.get", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied for checklist mutate.", "invalid_parameters": "entity_id required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reset deal or work-item checklist before cert cleanup or template swap.", "write_mode": null}, {"action": "context.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "capability_descriptor": {"complexity": "simple", "domain": "context", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.fabric.context_provider.gen1"], "id": "context.get", "related_tools": ["rag.search", "context.resolve"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Context Get", "when_blocked": {"invalid_context_source": "context.get requested sources do not match source_status rows — check tools_context._parse_sources and ContextFabric gather (no silent RAG substitution for crm)."}, "when_to_use": "Prefetch grounded snippets before a reply or tool call that needs project knowledge."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "context", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.fabric.context_provider.gen1"], "id": "context.get", "related_tools": ["rag.search", "context.resolve"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Context Get", "when_blocked": {"invalid_context_source": "context.get requested sources do not match source_status rows — check tools_context._parse_sources and ContextFabric gather (no silent RAG substitution for crm)."}, "when_to_use": "Prefetch grounded snippets before a reply or tool call that needs project knowledge."}, "domain": "context", "domain_title": "Context Resolve MCP domain", "effect": {"budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "conditional_mutate": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "heavy", "genetic_tags": ["core.mcp.context_resolve.gen1"], "instruction_hint": "Prefetch grounded snippets before a reply or tool call that needs project knowledge.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.context_resolve", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bundle": {"description": "ContextBundle — snippets, citations, estimated_tokens", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "bundle.citations": {"description": "Source citations with urls / ids", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "bundle.estimated_tokens": {"description": "Approximate token count of bundle", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "bundle.snippets": {"description": "Ranked text snippets for the task", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "source_status": {"description": "Per-source availability / error codes", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "sources_used": {"description": "Which sources contributed (rag, memory, crm, …)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.context_resolve.gen1", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_rag_memory_orchestrator"], "related_tools": ["rag.search", "context.resolve"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "context_get", "semantic_input_mode": "inherit_workflow", "summary": "Prefetch grounded snippets before a reply or tool call that needs project knowledge.", "title": "Context Get", "when_blocked": {"invalid_context_source": "context.get requested sources do not match source_status rows — check tools_context._parse_sources and ContextFabric gather (no silent RAG substitution for crm)."}, "when_to_use": "Prefetch grounded snippets before a reply or tool call that needs project knowledge.", "write_mode": null}, {"action": "context.resolve", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "context", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.context.gen1"], "id": "context.resolve", "related_tools": ["projects.get_projects", "auth.get_profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Context Resolve", "when_to_use": "After auth when context.project_id is missing or ambiguous."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "context", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.context.gen1"], "id": "context.resolve", "related_tools": ["projects.get_projects", "auth.get_profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Context Resolve", "when_to_use": "After auth when context.project_id is missing or ambiguous."}, "domain": "context", "domain_title": "Context Resolve MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.context_resolve.gen1"], "instruction_hint": "After auth when context.project_id is missing or ambiguous.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.context_resolve", "owner_gene": "core.mcp.context_resolve.gen1", "plane_chooser": "One jti covers every project membership allows. mutation_allowed true: do not switch_project and do not log in again. A restart rehydrates that jti from 8DNA. A page at /s/{id}/ uses the hosted cookie, not this jti.", "related_prompts": ["agentstack_rag_memory_orchestrator"], "related_tools": ["projects.get_projects", "auth.get_profile"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "context_resolve", "semantic_input_mode": "inherit_workflow", "summary": "Resolve effective project_id for the session; surfaces ambiguous_project_context.", "title": "Context Resolve", "when_to_use": "After auth when context.project_id is missing or ambiguous.", "write_mode": null}, {"action": "context.hint_use_params_project_id", "aliases": ["context.set_project"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "context", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.context.gen1"], "id": "context.hint_use_params_project_id", "related_tools": ["context.resolve", "auth.switch_project", "projects.get_projects"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Context Hint Use Params Project Id", "when_to_use": "When an agent calls context.set_project or context.set (alias target)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "context", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.context.gen1"], "id": "context.hint_use_params_project_id", "related_tools": ["context.resolve", "auth.switch_project", "projects.get_projects"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Context Hint Use Params Project Id", "when_to_use": "When an agent calls context.set_project or context.set (alias target)."}, "domain": "context", "domain_title": "Context Resolve MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.context_resolve.gen1"], "instruction_hint": "When an agent calls context.set_project or context.set (alias target).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.context_resolve", "owner_gene": "core.mcp.context_resolve.gen1", "plane_chooser": "One jti covers every project membership allows. mutation_allowed true: do not switch_project and do not log in again. A restart rehydrates that jti from 8DNA. A page at /s/{id}/ uses the hosted cookie, not this jti.", "related_prompts": ["agentstack_rag_memory_orchestrator"], "related_tools": ["context.resolve", "auth.switch_project", "projects.get_projects"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "context_hint_use_params_project_id", "semantic_input_mode": "inherit_workflow", "summary": "Instruction-only: there is no MCP context.set tool. Pass params.project_id on each execute step; bind context.project_id / X-Project-ID on the same jti when mutation_allowed is true — auth.switch_proj", "title": "Context Hint Use Params Project Id", "when_to_use": "When an agent calls context.set_project or context.set (alias target).", "write_mode": null}, {"action": "crm.list_contacts", "aliases": ["crm.contacts.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.list_contacts", "related_tools": ["crm.upsert_contact", "crm.search", "crm.get_contact_360"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Crm List Contacts", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "CRM cap or project membership denied", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "project_not_found": "Project does not exist or is not accessible", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List/search before upsert, 360, or pipeline board."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.list_contacts", "related_tools": ["crm.upsert_contact", "crm.search", "crm.get_contact_360"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Crm List Contacts", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "CRM cap or project membership denied", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "project_not_found": "Project does not exist or is not accessible", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List/search before upsert, 360, or pipeline board."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "List/search before upsert, 360, or pipeline board.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"contacts": {"description": "list", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "total": {"description": "integer", "type": "integer"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "One CRM. An empty list after upsert is the sandbox head — crm.get_contact_360. Do not insert a second contact. crm.list_board readiness=pending follows next_actions. Do not create_deal. Do not promote.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.upsert_contact", "crm.search", "crm.get_contact_360"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_list_contacts", "semantic_input_mode": "inherit_workflow", "summary": "Default projection=summary rows are entity_id, kind, title, status, and updated_at. projection=full is the contact record.", "title": "List CRM Contacts", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "CRM cap or project membership denied", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "project_not_found": "Project does not exist or is not accessible", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List/search before upsert, 360, or pipeline board.", "write_mode": null}, {"action": "crm.submit_public_form", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.submit_public_form", "mutation_risk": "low", "related_tools": ["crm.upsert_contact", "crm.list_contacts"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Submit Public Form", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_email": "Valid email required — same rules as public form-intake REST", "invalid_message": "message is required", "invalid_name": "name is required", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "message_too_long": "Shorten message to hosted form limit", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator test of hosted form intake — public sites use REST form-intake; this upserts CRM."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.submit_public_form", "mutation_risk": "low", "related_tools": ["crm.upsert_contact", "crm.list_contacts"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Submit Public Form", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_email": "Valid email required — same rules as public form-intake REST", "invalid_message": "message is required", "invalid_name": "name is required", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "message_too_long": "Shorten message to hosted form limit", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator test of hosted form intake — public sites use REST form-intake; this upserts CRM."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Operator test of hosted form intake — public sites use REST form-intake; this upserts CRM.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.upsert_contact", "crm.list_contacts"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "safe_action": "crm_submit_public_form", "semantic_input_mode": "inherit_workflow", "summary": "Operator helper: submit a hosted-site lead (same shape as public form-intake REST).", "title": "Crm Submit Public Form", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_email": "Valid email required — same rules as public form-intake REST", "invalid_message": "message is required", "invalid_name": "name is required", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "message_too_long": "Shorten message to hosted form limit", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator test of hosted form intake — public sites use REST form-intake; this upserts CRM.", "write_mode": null}, {"action": "crm.upsert_contact", "aliases": ["crm.contacts.create"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.upsert_contact", "mutation_risk": "low", "related_tools": ["crm.list_contacts", "crm.search", "crm.create_deal", "crm.get_contact_360"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Crm Upsert Contact", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "duplicate_contact": "crm.list_contacts by email — merge via crm.merge_contacts or set external_id on update", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create or update one contact — crm.list_contacts by email first."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.upsert_contact", "mutation_risk": "low", "related_tools": ["crm.list_contacts", "crm.search", "crm.create_deal", "crm.get_contact_360"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Crm Upsert Contact", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "duplicate_contact": "crm.list_contacts by email — merge via crm.merge_contacts or set external_id on update", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create or update one contact — crm.list_contacts by email first."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Create or update one contact — crm.list_contacts by email first.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"contact": {"additionalProperties": true, "description": "object", "type": "object"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_contacts", "crm.search", "crm.create_deal", "crm.get_contact_360"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "rollback": ["crm.erase_contact"], "safe_action": "crm_upsert_contact", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create or update a CRM contact (dedupe by email).", "title": "Create or Update Contact", "verification": ["crm.get_contact_360"], "verify": [{"action": "crm.get_contact_360", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "duplicate_contact": "crm.list_contacts by email — merge via crm.merge_contacts or set external_id on update", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create or update one contact — crm.list_contacts by email first.", "write_mode": null}, {"action": "crm.create_deal", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.create_deal", "mutation_risk": "low", "related_tools": ["crm.upsert_contact", "crm.move_deal_stage", "crm.list_board", "crm.get_deal_timeline"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Create Deal", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After contact exists — crm.list_board before crm.move_deal_stage."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.create_deal", "mutation_risk": "low", "related_tools": ["crm.upsert_contact", "crm.move_deal_stage", "crm.list_board", "crm.get_deal_timeline"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Create Deal", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After contact exists — crm.list_board before crm.move_deal_stage."}, "do_not_use_when": "List contacts for that email before creating a deal.", "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "After contact exists — crm.list_board before crm.move_deal_stage.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deal": {"additionalProperties": true, "description": "object", "type": "object"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.upsert_contact", "crm.move_deal_stage", "crm.list_board", "crm.get_deal_timeline"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "rollback": ["crm.delete_deal"], "safe_action": "crm_create_deal", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a CRM deal in the default pipeline.", "title": "Create CRM Deal", "verification": ["crm.list_board", "crm.get_deal_timeline"], "verify": [{"action": "crm.list_board", "predicate": "id"}, {"action": "crm.get_deal_timeline", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "List contacts for that email before creating a deal.", "when_to_use": "After contact exists — crm.list_board before crm.move_deal_stage.", "write_mode": null}, {"action": "crm.update_deal", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.update_deal", "mutation_risk": "low", "related_tools": ["crm.create_deal", "crm.delete_deal", "crm.move_deal_stage"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Update Deal", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "deal_not_found": "crm.list_board — verify deal_id", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "pipeline_stage_locked": "crm.list_board + crm.get_crm_config — use crm.move_deal_stage for stage changes", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Edit deal fields from hosted vertical or CRM drawer."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.update_deal", "mutation_risk": "low", "related_tools": ["crm.create_deal", "crm.delete_deal", "crm.move_deal_stage"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Update Deal", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "deal_not_found": "crm.list_board — verify deal_id", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "pipeline_stage_locked": "crm.list_board + crm.get_crm_config — use crm.move_deal_stage for stage changes", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Edit deal fields from hosted vertical or CRM drawer."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Edit deal fields from hosted vertical or CRM drawer.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.create_deal", "crm.delete_deal", "crm.move_deal_stage"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "safe_action": "crm_update_deal", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch a CRM deal (title, amount, due_at, stage_id, contact_ids, custom).", "title": "Crm Update Deal", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "deal_not_found": "crm.list_board — verify deal_id", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "pipeline_stage_locked": "crm.list_board + crm.get_crm_config — use crm.move_deal_stage for stage changes", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Edit deal fields from hosted vertical or CRM drawer.", "write_mode": null}, {"action": "crm.delete_deal", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.delete_deal", "mutation_risk": "high", "related_tools": ["crm.update_deal", "crm.list_board"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Delete Deal", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Archive or cancel a project/deal from hosted vertical."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.delete_deal", "mutation_risk": "high", "related_tools": ["crm.update_deal", "crm.list_board"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Delete Deal", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Archive or cancel a project/deal from hosted vertical."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Archive or cancel a project/deal from hosted vertical.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.update_deal", "crm.list_board"], "required_cap": "crm", "requires_preflight": true, "risk_class": "destructive", "safe_action": "crm_delete_deal", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Soft-delete (archive) a CRM deal.", "title": "Crm Delete Deal", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Archive or cancel a project/deal from hosted vertical.", "write_mode": null}, {"action": "crm.move_deal_stage", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.move_deal_stage", "related_tools": ["crm.list_board", "crm.get_deal_timeline", "crm.log_activity", "crm.get_crm_config"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Move Deal Stage", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "pipeline_stage_locked": "crm.list_board + crm.get_crm_config — verify stage_id before move", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Kanban advance — crm.list_board projection=summary first."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.move_deal_stage", "related_tools": ["crm.list_board", "crm.get_deal_timeline", "crm.log_activity", "crm.get_crm_config"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Move Deal Stage", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "pipeline_stage_locked": "crm.list_board + crm.get_crm_config — verify stage_id before move", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Kanban advance — crm.list_board projection=summary first."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Kanban advance — crm.list_board projection=summary first.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deal": {"additionalProperties": true, "description": "object", "type": "object"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_board", "crm.get_deal_timeline", "crm.log_activity", "crm.get_crm_config"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "crm_move_deal_stage", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Move a deal to another pipeline stage.", "title": "Crm Move Deal Stage", "verification": ["crm.list_board", "crm.get_deal_timeline"], "verify": [{"action": "crm.list_board", "predicate": "named resource is visible"}, {"action": "crm.get_deal_timeline", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "pipeline_stage_locked": "crm.list_board + crm.get_crm_config — verify stage_id before move", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Kanban advance — crm.list_board projection=summary first.", "write_mode": null}, {"action": "crm.log_activity", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.log_activity", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Log Activity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "crm_write cap + project membership", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append timeline note/call/meeting on a contact or deal."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.log_activity", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Log Activity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "crm_write cap + project membership", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append timeline note/call/meeting on a contact or deal."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Append timeline note/call/meeting on a contact or deal.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"activity": {"additionalProperties": true, "description": "object", "type": "object"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "crm_log_activity", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Log a CRM activity (note, call, task, etc.).", "title": "Crm Log Activity", "verification": ["crm.get_deal_timeline"], "verify": [{"action": "crm.get_deal_timeline", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "crm_write cap + project membership", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append timeline note/call/meeting on a contact or deal.", "write_mode": null}, {"action": "crm.search", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.search", "related_tools": ["crm.list_contacts", "crm.get_contact_360"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Semantic or field search — prefer before upsert when deduping."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.search", "related_tools": ["crm.list_contacts", "crm.get_contact_360"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Semantic or field search — prefer before upsert when deduping."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Semantic or field search — prefer before upsert when deduping.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "One CRM. An empty list after upsert is the sandbox head — crm.get_contact_360. Do not insert a second contact. crm.list_board readiness=pending follows next_actions. Do not create_deal. Do not promote.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_contacts", "crm.get_contact_360"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_search", "semantic_input_mode": "inherit_workflow", "summary": "Search CRM contacts. Default projection=summary is the card (entity_id, kind, title, status, updated_at). projection=full is the hit record.", "title": "Crm Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Semantic or field search — prefer before upsert when deduping.", "write_mode": null}, {"action": "crm.create_company", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.create_company", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Create Company", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create org row before deals — crm.list_contacts optional link."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.create_company", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Create Company", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create org row before deals — crm.list_contacts optional link."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Create org row before deals — crm.list_contacts optional link.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "safe_action": "crm_create_company", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a CRM company for a project.", "title": "Crm Create Company", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create org row before deals — crm.list_contacts optional link.", "write_mode": null}, {"action": "crm.list_companies", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.list_companies", "related_tools": ["crm.create_company", "crm.list_contacts"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm List Companies", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List companies before linking contacts or deals to an account."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.list_companies", "related_tools": ["crm.create_company", "crm.list_contacts"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm List Companies", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List companies before linking contacts or deals to an account."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "List companies before linking contacts or deals to an account.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.create_company", "crm.list_contacts"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_list_companies", "semantic_input_mode": "inherit_workflow", "summary": "Default projection=summary rows are entity_id, kind, title, status, and updated_at. projection=full is the company record.", "title": "Crm List Companies", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List companies before linking contacts or deals to an account.", "write_mode": null}, {"action": "crm.get_contact_360", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.get_contact_360", "related_tools": ["crm.list_contacts", "crm.upsert_contact", "crm.create_deal"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Get Contact 360", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-after-write verify for upsert/import flows."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.get_contact_360", "related_tools": ["crm.list_contacts", "crm.upsert_contact", "crm.create_deal"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Get Contact 360", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-after-write verify for upsert/import flows."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Read-after-write verify for upsert/import flows.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_contacts", "crm.upsert_contact", "crm.create_deal"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_get_contact_360", "semantic_input_mode": "inherit_workflow", "summary": "Contact 360 view: profile, deals, unified timeline.", "title": "Crm Get Contact 360", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-after-write verify for upsert/import flows.", "write_mode": null}, {"action": "crm.magic_fill", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.magic_fill", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Magic Fill", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "AI field assist on an open record — upsert contact/deal first."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.magic_fill", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Magic Fill", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "AI field assist on an open record — upsert contact/deal first."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "AI field assist on an open record — upsert contact/deal first.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_magic_fill", "semantic_input_mode": "inherit_workflow", "summary": "AI/heuristic autofill for quick-create (dry-run, no write).", "title": "Crm Magic Fill", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "AI field assist on an open record — upsert contact/deal first.", "write_mode": null}, {"action": "crm.suggest_field", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.suggest_field", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Suggest Field", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Single-field suggestion — prefer magic_fill for multi-field drafts."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.suggest_field", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Suggest Field", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Single-field suggestion — prefer magic_fill for multi-field drafts."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Single-field suggestion — prefer magic_fill for multi-field drafts.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_suggest_field", "semantic_input_mode": "inherit_workflow", "summary": "Suggest values for a CRM field from partial context.", "title": "Crm Suggest Field", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Single-field suggestion — prefer magic_fill for multi-field drafts.", "write_mode": null}, {"action": "crm.import_contacts", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.import_contacts", "mutation_risk": "low", "related_tools": ["crm.list_contacts", "crm.merge_contacts", "crm.get_contact_360"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Import Contacts", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "import_blocked": "crm.list_contacts to preview dupes — shrink batch or crm.merge_contacts before retry", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk CSV import — prefer dry-run limits in UI; MCP for scripted ingest."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.import_contacts", "mutation_risk": "low", "related_tools": ["crm.list_contacts", "crm.merge_contacts", "crm.get_contact_360"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Import Contacts", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "import_blocked": "crm.list_contacts to preview dupes — shrink batch or crm.merge_contacts before retry", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk CSV import — prefer dry-run limits in UI; MCP for scripted ingest."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Bulk CSV import — prefer dry-run limits in UI; MCP for scripted ingest.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_contacts", "crm.merge_contacts", "crm.get_contact_360"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "safe_action": "crm_import_contacts", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Batch import CRM contacts with email dedupe.", "title": "Crm Import Contacts", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "import_blocked": "crm.list_contacts to preview dupes — shrink batch or crm.merge_contacts before retry", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk CSV import — prefer dry-run limits in UI; MCP for scripted ingest.", "write_mode": null}, {"action": "crm.export_contact", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.export_contact", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Export Contact", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Portable export after upsert — not a substitute for list/search."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.export_contact", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Export Contact", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Portable export after upsert — not a substitute for list/search."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Portable export after upsert — not a substitute for list/search.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_export_contact", "semantic_input_mode": "inherit_workflow", "summary": "Export GDPR bundle for a CRM contact.", "title": "Crm Export Contact", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Portable export after upsert — not a substitute for list/search.", "write_mode": null}, {"action": "crm.erase_contact", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.erase_contact", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Erase Contact", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "GDPR erase — crm.get_contact_360 to confirm id before erase."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.erase_contact", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Erase Contact", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "GDPR erase — crm.get_contact_360 to confirm id before erase."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "GDPR erase — crm.get_contact_360 to confirm id before erase.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": true, "risk_class": "destructive", "safe_action": "crm_erase_contact", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Anonymize/erase a CRM contact (GDPR).", "title": "Crm Erase Contact", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "GDPR erase — crm.get_contact_360 to confirm id before erase.", "write_mode": null}, {"action": "crm.list_board", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.list_board", "related_tools": ["crm.move_deal_stage", "crm.create_deal", "crm.get_deal_timeline"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm List Board", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pipeline snapshot before move_deal_stage or deal updates."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.list_board", "related_tools": ["crm.move_deal_stage", "crm.create_deal", "crm.get_deal_timeline"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm List Board", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pipeline snapshot before move_deal_stage or deal updates."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Pipeline snapshot before move_deal_stage or deal updates.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Board: crm.list_board. pending plus missing_deal_ids is a row this scope did not hydrate. effective_scope is the read. generation_meta is the batch head and can name another env. Do not create_deal. Do not promote. A board error is not a logout.", "plane_chooser": "One CRM. An empty list after upsert is the sandbox head — crm.get_contact_360. Do not insert a second contact. crm.list_board readiness=pending follows next_actions. Do not create_deal. Do not promote.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.move_deal_stage", "crm.create_deal", "crm.get_deal_timeline"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_list_board", "semantic_input_mode": "inherit_workflow", "summary": "Pipeline board. Default deals are cards: entity_id, title, status, updated_at. projection=full is the deal record. Stage columns stay.", "title": "View CRM Pipeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pipeline snapshot before move_deal_stage or deal updates.", "write_mode": null}, {"action": "crm.hub_snapshot", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.hub_snapshot", "related_tools": ["crm.list_board", "crm.list_contacts", "crm.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Hub Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hub KPIs before opening full board or contact lists."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.hub_snapshot", "related_tools": ["crm.list_board", "crm.list_contacts", "crm.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Hub Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hub KPIs before opening full board or contact lists."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Hub KPIs before opening full board or contact lists.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_board", "crm.list_contacts", "crm.search"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_hub_snapshot", "semantic_input_mode": "inherit_workflow", "summary": "CRM hub cold summary (deal/contact counts, pipeline hints) — index-only read. Same as REST GET /api/projects/{id}/crm/hub-snapshot.", "title": "Crm Hub Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hub KPIs before opening full board or contact lists.", "write_mode": null}, {"action": "crm.index.repair", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.index.repair", "related_tools": ["crm.list_board", "crm.hub_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Index Repair", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Backfill CRM deal_cards denorm rows from by_stage + deal entities. Use after legacy imports — list_board no longer runs this on every read."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.index.repair", "related_tools": ["crm.list_board", "crm.hub_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Index Repair", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Backfill CRM deal_cards denorm rows from by_stage + deal entities. Use after legacy imports — list_board no longer runs this on every read."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Backfill CRM deal_cards denorm rows from by_stage + deal entities. Use after legacy imports — list_…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_board", "crm.hub_snapshot"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "safe_action": "crm_index_repair", "semantic_input_mode": "inherit_workflow", "summary": "Backfill CRM deal_cards denorm rows from by_stage + deal entities. Use after legacy imports — list_board no longer runs this on every read.", "title": "Crm Index Repair", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Backfill CRM deal_cards denorm rows from by_stage + deal entities. Use after legacy imports — list_board no longer runs this on every read.", "write_mode": null}, {"action": "crm.get_deal_timeline", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.get_deal_timeline", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Get Deal Timeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-after-write verify for deal stage moves."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.get_deal_timeline", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Get Deal Timeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-after-write verify for deal stage moves."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Read-after-write verify for deal stage moves.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_get_deal_timeline", "semantic_input_mode": "inherit_workflow", "summary": "Activity timeline for a CRM deal (notes, tasks linked to deal_id).", "title": "Crm Get Deal Timeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-after-write verify for deal stage moves.", "write_mode": null}, {"action": "crm.get_crm_config", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.get_crm_config", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Get Crm Config", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pipeline stages and field map before move_deal_stage or magic_fill."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.get_crm_config", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Get Crm Config", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pipeline stages and field map before move_deal_stage or magic_fill."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Pipeline stages and field map before move_deal_stage or magic_fill.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_get_crm_config", "semantic_input_mode": "inherit_workflow", "summary": "Project CRM config (saved_views, settings blob).", "title": "Crm Get Crm Config", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pipeline stages and field map before move_deal_stage or magic_fill.", "write_mode": null}, {"action": "crm.patch_crm_config", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.patch_crm_config", "mutation_risk": "low", "related_tools": ["crm.get_crm_config", "crm.list_board", "crm.magic_fill"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Patch Crm Config", "when_blocked": {"config_conflict": "crm.get_crm_config — if_match revision mismatch", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin for CRM config patch", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Admin CRM settings — crm.get_crm_config first for if_match."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.patch_crm_config", "mutation_risk": "low", "related_tools": ["crm.get_crm_config", "crm.list_board", "crm.magic_fill"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Patch Crm Config", "when_blocked": {"config_conflict": "crm.get_crm_config — if_match revision mismatch", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin for CRM config patch", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Admin CRM settings — crm.get_crm_config first for if_match."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Admin CRM settings — crm.get_crm_config first for if_match.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.get_crm_config", "crm.list_board", "crm.magic_fill"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "safe_action": "crm_patch_crm_config", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch project CRM config (writers may update saved_views only).", "title": "Crm Patch Crm Config", "when_blocked": {"config_conflict": "crm.get_crm_config — if_match revision mismatch", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin for CRM config patch", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Admin CRM settings — crm.get_crm_config first for if_match.", "write_mode": null}, {"action": "crm.merge_contacts", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.merge_contacts", "mutation_risk": "low", "related_tools": ["crm.list_contacts", "crm.upsert_contact", "crm.get_contact_360"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Merge Contacts", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After crm.list_contacts finds duplicate emails or external_ids."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.merge_contacts", "mutation_risk": "low", "related_tools": ["crm.list_contacts", "crm.upsert_contact", "crm.get_contact_360"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Merge Contacts", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After crm.list_contacts finds duplicate emails or external_ids."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "After crm.list_contacts finds duplicate emails or external_ids.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_contacts", "crm.upsert_contact", "crm.get_contact_360"], "required_cap": "crm", "requires_preflight": true, "risk_class": "destructive", "safe_action": "crm_merge_contacts", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Merge duplicate contact into primary (absorb duplicate).", "title": "Crm Merge Contacts", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After crm.list_contacts finds duplicate emails or external_ids.", "write_mode": null}, {"action": "crm.get_custom_fields", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm_config", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.get_custom_fields", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Get Custom Fields", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read CRM custom field definitions before put_custom_fields or magic_fill on new keys."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm_config", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.get_custom_fields", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Get Custom Fields", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read CRM custom field definitions before put_custom_fields or magic_fill on new keys."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Read CRM custom field definitions before put_custom_fields or magic_fill on new keys.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_get_custom_fields", "semantic_input_mode": "inherit_workflow", "summary": "Read CRM custom field definitions for a project.", "title": "Crm Get Custom Fields", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read CRM custom field definitions before put_custom_fields or magic_fill on new keys.", "write_mode": null}, {"action": "crm.put_custom_fields", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm_config", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.put_custom_fields", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Put Custom Fields", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Admin field map — crm.get_custom_fields first; crm.get_crm_config for pipeline context."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "crm_config", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.put_custom_fields", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Put Custom Fields", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Admin field map — crm.get_custom_fields first; crm.get_crm_config for pipeline context."}, "domain": "crm", "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Admin field map — crm.get_custom_fields first; crm.get_crm_config for pipeline context.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "safe_action": "crm_put_custom_fields", "semantic_input_mode": "inherit_workflow", "summary": "Replace CRM custom field definitions (REST parity).", "title": "Crm Put Custom Fields", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Admin field map — crm.get_custom_fields first; crm.get_crm_config for pipeline context.", "write_mode": null}, {"action": "data_access.set_policy", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not use rbac.check_permission as a substitute for field-level FAP.", "Do not scatter if role== checks in app code — set_policy once per resource."], "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1", "core.fabric.capability_descriptor.gen1"], "id": "data_access.set_policy", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Data Access Set Policy", "when_blocked": {"insufficient_permissions": "Requires admin permission", "invalid_policy": "Policy format is invalid", "policy_conflict": "data_access.get_policy — merge paths; test_mask to verify role views", "project_not_found": "Project does not exist"}, "when_to_use": "Create or update the field-level access policy for a project resource."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1", "core.fabric.capability_descriptor.gen1"], "id": "data_access.set_policy", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Data Access Set Policy", "when_blocked": {"insufficient_permissions": "Requires admin permission", "invalid_policy": "Policy format is invalid", "policy_conflict": "data_access.get_policy — merge paths; test_mask to verify role views", "project_not_found": "Project does not exist"}, "when_to_use": "Create or update the field-level access policy for a project resource."}, "domain": "data_access", "domain_title": "Data Access MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"insufficient_permissions": "Requires admin permission", "invalid_policy": "Policy format is invalid", "project_not_found": "Project does not exist"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Create or update the field-level access policy for a project resource.", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["data_access.test_mask"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"policy": {"description": "Updated full policy dict", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "resource": {"description": "Resource key that was updated", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "data_access_admin", "requires_preflight": true, "risk_class": "access_control", "safe_action": "data_access_set_policy", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create or update the field-level access policy for a project resource.", "title": "Data Access Set Policy", "tool_chains": ["content_access_control"], "when_blocked": {"insufficient_permissions": "Requires admin permission", "invalid_policy": "Policy format is invalid", "policy_conflict": "data_access.get_policy — merge paths; test_mask to verify role views", "project_not_found": "Project does not exist"}, "when_to_use": "Create or update the field-level access policy for a project resource.", "write_mode": null}, {"action": "data_access.get_policy", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.get_policy", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Get Policy", "when_blocked": {"project_not_found": "Project does not exist"}, "when_to_use": "Retrieve the current field-level access policy for a project."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.get_policy", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Get Policy", "when_blocked": {"project_not_found": "Project does not exist"}, "when_to_use": "Retrieve the current field-level access policy for a project."}, "domain": "data_access", "domain_title": "Data Access MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"project_not_found": "Project does not exist"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Retrieve the current field-level access policy for a project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "data_access_get_policy", "semantic_input_mode": "inherit_workflow", "summary": "Retrieve the current field-level access policy for a project.", "title": "Data Access Get Policy", "when_blocked": {"project_not_found": "Project does not exist"}, "when_to_use": "Retrieve the current field-level access policy for a project.", "write_mode": null}, {"action": "data_access.check_field", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.check_field", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Check Field", "when_blocked": {"invalid_parameters": "Missing required parameters"}, "when_to_use": "Check whether a specific role can read/write a field in a resource."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.check_field", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Check Field", "when_blocked": {"invalid_parameters": "Missing required parameters"}, "when_to_use": "Check whether a specific role can read/write a field in a resource."}, "domain": "data_access", "domain_title": "Data Access MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "errors": {"invalid_parameters": "Missing required parameters"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Check whether a specific role can read/write a field in a resource.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "data_access_check_field", "semantic_input_mode": "inherit_workflow", "summary": "Check whether a specific role can read/write a field in a resource.", "title": "Data Access Check Field", "when_blocked": {"invalid_parameters": "Missing required parameters"}, "when_to_use": "Check whether a specific role can read/write a field in a resource.", "write_mode": null}, {"action": "data_access.test_mask", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.test_mask", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Test Mask", "when_blocked": {"invalid_parameters": "Missing required parameters"}, "when_to_use": "Preview what fields a given role can read/write in a resource."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.test_mask", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Test Mask", "when_blocked": {"invalid_parameters": "Missing required parameters"}, "when_to_use": "Preview what fields a given role can read/write in a resource."}, "domain": "data_access", "domain_title": "Data Access MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "errors": {"invalid_parameters": "Missing required parameters"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Preview what fields a given role can read/write in a resource.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "data_access_test_mask", "semantic_input_mode": "inherit_workflow", "summary": "Preview what fields a given role can read/write in a resource.", "title": "Data Access Test Mask", "when_blocked": {"invalid_parameters": "Missing required parameters"}, "when_to_use": "Preview what fields a given role can read/write in a resource.", "write_mode": null}, {"action": "data_access.get_defaults_template", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.get_defaults_template", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Get Defaults Template", "when_to_use": "Read the global Field Access Policy template from ecosystem project DNA (`config.field_access_defaults`: default_access, globals, resources)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.get_defaults_template", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Get Defaults Template", "when_to_use": "Read the global Field Access Policy template from ecosystem project DNA (`config.field_access_defaults`: default_access, globals, resources)."}, "domain": "data_access", "domain_title": "Data Access MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Read the global Field Access Policy template from ecosystem project DNA (`config.field_access_defau…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "data_access_get_defaults_template", "semantic_input_mode": "inherit_workflow", "summary": "Read the global Field Access Policy template from ecosystem project DNA (`config.field_access_defaults`: default_access, globals, resources).", "title": "Data Access Get Defaults Template", "when_to_use": "Read the global Field Access Policy template from ecosystem project DNA (`config.field_access_defaults`: default_access, globals, resources).", "write_mode": null}, {"action": "data_access.set_defaults_template", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.set_defaults_template", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Set Defaults Template", "when_to_use": "Write the global FAP template on ecosystem project (admin tooling)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.set_defaults_template", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Set Defaults Template", "when_to_use": "Write the global FAP template on ecosystem project (admin tooling)."}, "domain": "data_access", "domain_title": "Data Access MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Write the global FAP template on ecosystem project (admin tooling).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "data_access_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "data_access_set_defaults_template", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Write the global FAP template on ecosystem project (admin tooling).", "title": "Data Access Set Defaults Template", "when_to_use": "Write the global FAP template on ecosystem project (admin tooling).", "write_mode": null}, {"action": "data_access.apply_defaults_template", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.apply_defaults_template", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Apply Defaults Template", "when_to_use": "Copy missing `resources.<name>` entries from the global template into `target_project_id`'s field_access_policy. Does not overwrite existing keys. Cannot target ecosystem project id=1."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.apply_defaults_template", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Apply Defaults Template", "when_to_use": "Copy missing `resources.<name>` entries from the global template into `target_project_id`'s field_access_policy. Does not overwrite existing keys. Cannot target ecosystem project id=1."}, "domain": "data_access", "domain_title": "Data Access MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Copy missing `resources.<name>` entries from the global template into `target_project_id`'s field_a…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "data_access_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "data_access_apply_defaults_template", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Copy missing `resources.<name>` entries from the global template into `target_project_id`'s field_access_policy. Does not overwrite existing keys. Cannot target ecosystem project id=1.", "title": "Data Access Apply Defaults Template", "tool_chains": ["project_bootstrap", "multi_tenant_onboarding"], "when_to_use": "Copy missing `resources.<name>` entries from the global template into `target_project_id`'s field_access_policy. Does not overwrite existing keys. Cannot target ecosystem project id=1.", "write_mode": null}, {"action": "data_access.get_triggers", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.get_triggers", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Get Triggers", "when_to_use": "Read FAP v1.2 field_triggers for a project (same JSON as field_access_policy.field_triggers)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.get_triggers", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Get Triggers", "when_to_use": "Read FAP v1.2 field_triggers for a project (same JSON as field_access_policy.field_triggers)."}, "domain": "data_access", "domain_title": "Data Access MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Read FAP v1.2 field_triggers for a project (same JSON as field_access_policy.field_triggers).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "data_access_get_triggers", "semantic_input_mode": "inherit_workflow", "summary": "Read FAP v1.2 ``field_triggers`` for a project (same JSON as ``field_access_policy.field_triggers``). Keyed by resource → pattern → list of trigger definitions. See FIELD_ACCESS_POLICY.md — Field Trig", "title": "Data Access Get Triggers", "when_to_use": "Read FAP v1.2 field_triggers for a project (same JSON as field_access_policy.field_triggers).", "write_mode": null}, {"action": "data_access.set_triggers", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.set_triggers", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Set Triggers", "when_to_use": "Upsert field_triggers for one resource. triggers maps field_pattern to a list of trigger definitions."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.set_triggers", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Set Triggers", "when_to_use": "Upsert field_triggers for one resource. triggers maps field_pattern to a list of trigger definitions."}, "domain": "data_access", "domain_title": "Data Access MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Upsert field_triggers for one resource. triggers maps field_pattern to a list of trigger definition…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "data_access_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "data_access_set_triggers", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Upsert ``field_triggers`` for one resource. **triggers** is a map ``field_pattern → [trigger_def, …]`` (patterns like ``status``, ``config.**``, ``*``).", "title": "Data Access Set Triggers", "when_to_use": "Upsert field_triggers for one resource. triggers maps field_pattern to a list of trigger definitions.", "write_mode": null}, {"action": "hosting.demo.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.demo.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Demo Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Anonymous demo pool health: heartbeat ok vs absent, degraded_reason pool_low vs heartbeat_absent. Hosted vitrine is hosting.demo_store.status."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.demo.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Demo Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Anonymous demo pool health: heartbeat ok vs absent, degraded_reason pool_low vs heartbeat_absent. Hosted vitrine is hosting.demo_store.status."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Anonymous demo pool health: heartbeat ok vs absent, degraded_reason pool_low vs heartbeat_absent. H…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_demo_status", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Public demo hosting pool status (enabled, depth, sandbox project id).", "title": "Hosting Demo Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Anonymous demo pool health: heartbeat ok vs absent, degraded_reason pool_low vs heartbeat_absent. Hosted vitrine is hosting.demo_store.status.", "write_mode": null}, {"action": "hosting.demo_store.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.demo_store.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Demo Store Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Golden promo demo-store vitrine: catalog row count on sandbox, published build id, manifest bucket (`frontend.commerce.hosted_storefront.gen1`)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.demo_store.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Demo Store Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Golden promo demo-store vitrine: catalog row count on sandbox, published build id, manifest bucket (`frontend.commerce.hosted_storefront.gen1`)."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Golden promo demo-store vitrine: catalog row count on sandbox, published build id, manifest bucket …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_demo_store_status", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Golden promo demo-store vitrine: catalog row count on sandbox, published build id, manifest bucket (`frontend.commerce.hosted_storefront.gen1`).", "title": "Hosting Demo Store Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Golden promo demo-store vitrine: catalog row count on sandbox, published build id, manifest bucket (`frontend.commerce.hosted_storefront.gen1`).", "write_mode": null}, {"action": "hosting.site.quick_start", "aliases": ["hosting.bucket.create", "hosting.buckets.create", "hosting.create_site", "hosting.site.create", "sites.create"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.quick_start", "mutation_risk": "low", "related_tools": ["hosting.deploy_files", "hosting.release.promote", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Hosting Site Quick Start", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestration_step_violation": "Action is outside the current instruction step — use execution_intent=direct for authorized one-off hosting setup, or follow packet.next_action / work_next", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "sites_max_reached": "buffs.get_effective_limits — upgrade plan or archive an old site bucket", "slug_exists": "Pick another slug — hosting.project.status lists taken vanity slugs", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Create the first hosted bucket and publish /s/{pid}/{slug}/ only when hosting.project.status shows no primary_public_url."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.quick_start", "mutation_risk": "low", "related_tools": ["hosting.deploy_files", "hosting.release.promote", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Hosting Site Quick Start", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestration_step_violation": "Action is outside the current instruction step — use execution_intent=direct for authorized one-off hosting setup, or follow packet.next_action / work_next", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "sites_max_reached": "buffs.get_effective_limits — upgrade plan or archive an old site bucket", "slug_exists": "Pick another slug — hosting.project.status lists taken vanity slugs", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Create the first hosted bucket and publish /s/{pid}/{slug}/ only when hosting.project.status shows no primary_public_url."}, "do_not_use_when": "Do not call when a primary_public_url already exists.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Create the first hosted bucket and publish /s/{pid}/{slug}/ only when hosting.pr… primary_public_url", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bucket_id": {"description": "string", "type": "string"}, "bucket_name": {"description": "string", "type": "string"}, "public_path": {"description": "string", "type": "string"}, "url": {"description": "string", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.deploy_files", "hosting.release.promote", "hosting.project.status"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "hosting_site_quick_start", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create bucket, upload HTML index, optional publish; returns public /s/{project_id}/{bucket_name}/ URL. instruction_slice and recovery_hint use context.locale / instruction_locale.", "title": "Create Hosted Site", "verification": ["hosting.site.resolve", "hosting.project.status"], "verify": [{"action": "hosting.site.resolve", "predicate": "named resource is visible"}, {"action": "hosting.project.status", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestration_step_violation": "Action is outside the current instruction step — use execution_intent=direct for authorized one-off hosting setup, or follow packet.next_action / work_next", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "sites_max_reached": "buffs.get_effective_limits — upgrade plan or archive an old site bucket", "slug_exists": "Pick another slug — hosting.project.status lists taken vanity slugs", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_blocked_locales": {"hosting_archive_quota_exceeded": {"en-US": "Release archive budget full — hosting.release.list + delete old releases, or raise hosting archive buff; live publish may still succeed (soft-fail snapshot)", "pt-BR": "Cota de archive cheia — hosting.release.list e apague releases antigos; publish live pode ok sem snapshot", "ru-RU": "Квота архива релизов — hosting.release.list и удалите старые снимки; публикация live может пройти без snapshot"}, "site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}, "validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_not_to_use": "Do not call when a primary_public_url already exists.", "when_to_use": "Create the first hosted bucket and publish /s/{pid}/{slug}/ only when hosting.project.status shows no primary_public_url.", "write_mode": null}, {"action": "hosting.site.resolve", "aliases": ["hosting.bucket.get"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Resolve is not a file read. A known string is hosting.bucket.file.patch. GET only when the bytes are unknown.", "anti_patterns": ["Resolve is not a file read. A known string is hosting.bucket.file.patch. GET only when the bytes are unknown."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.resolve", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Resolve", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Resolve bucket_id, slug, and public path before bucket file ops when the id is unknown."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.resolve", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Resolve", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Resolve bucket_id, slug, and public path before bucket file ops when the id is unknown."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Resolve bucket_id, slug, and public path before bucket file ops when the id is unknown.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_site_resolve", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Resolve hosting bucket_name to bucket_id and public URL hints.", "title": "Hosting Site Resolve", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}}, "when_to_use": "Resolve bucket_id, slug, and public path before bucket file ops when the id is unknown.", "write_mode": null}, {"action": "hosting.files.put", "aliases": ["hosting.bucket.file.put"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Many pages: one hosting.deploy_files batch, not parallel hosting.files.put (N separate puts).", "anti_patterns": ["Many pages: one hosting.deploy_files batch, not parallel hosting.files.put (N separate puts).", "List files with hosting.bucket.files.list. Public URL is /s/{project_id}/{bucket_name}/.", "Prefer hosting.bucket.file.patch for a small text edit. Do not GET first.", "Do not use storage.upload when the file already lives in the site bucket.", "content_base64 validation_error: fix padding and strip data: prefix — or use content UTF-8.", "Omit generation_env_uuid — hosting byte writes do not fork."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.files.put", "mutation_risk": "low", "related_tools": ["hosting.deploy_files", "hosting.bucket.files.list", "hosting.bucket.file.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Files Put", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Pass UTF-8 content or content_base64 (empty body rejected). Many files: hosting.deploy_files. Small edit: hosting.bucket.file.patch search_replace."}, "when_to_use": "Put one file into the active bucket tree (content or content_base64). Multi-page ship: hosting.deploy_files — one execute step keeps JSON under gateway limits. Refuses a truncated file.get window unle"}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.files.put", "mutation_risk": "low", "related_tools": ["hosting.deploy_files", "hosting.bucket.files.list", "hosting.bucket.file.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Files Put", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Pass UTF-8 content or content_base64 (empty body rejected). Many files: hosting.deploy_files. Small edit: hosting.bucket.file.patch search_replace."}, "when_to_use": "Put one file into the active bucket tree (content or content_base64). Multi-page ship: hosting.deploy_files — one execute step keeps JSON under gateway limits. Refuses a truncated file.get window unle"}, "do_not_use_when": "Tiny text tweak on a known path — hosting.bucket.file.patch search_replace. Omit dry_run.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "error_hints": [{"code": "validation_error", "tip": "Strip data: URL prefix; never pass PLACEHOLDER / YOUR_TOKEN literals as base64. Prefer UTF-8 content or hosting.bucket.file.patch search_replace over base64."}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_BASE64_DECODE": "Strip data: URL prefix; never pass PLACEHOLDER / YOUR_TOKEN literals as base64. Prefer UTF-8 content or hosting.bucket.file.patch search_replace over base64.", "HOSTING_BASE64_PADDING": "content_base64 validation_error: strip whitespace, add = until length % 4 — invalid padding fails before decode.", "HOSTING_GENERATION_ENV_OMIT": "Omit generation_env_uuid on hosting.* byte writes — site edits do not fork. A stale uuid in batch context fails auto-fork; let the server keep the sandbox head. generation_fork_required on hosting.deploy_files is a status-projection defect: another generation.fork does not repair the bytes.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Put one file into the active bucket tree (content or content_base64). Multi-page ship: hosting.depl…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bytes": {"description": "integer", "type": "integer"}, "path": {"description": "string", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.deploy_files", "hosting.bucket.files.list", "hosting.bucket.file.patch"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["hosting.release.promote"], "safe_action": "hosting_files_put", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Upload or replace one file in a hosting bucket. Many files: one hosting.deploy_files call. List: hosting.bucket.files.list.", "title": "Hosting Files Put", "verification": ["hosting.bucket.files.list", "hosting.bucket.file.get"], "verify": [{"action": "hosting.bucket.files.list", "predicate": "named resource is visible"}, {"action": "hosting.bucket.file.get", "predicate": "named resource is visible"}], "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Pass UTF-8 content or content_base64 (empty body rejected). Many files: hosting.deploy_files. Small edit: hosting.bucket.file.patch search_replace."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}, "validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_not_to_use": "Tiny text tweak on a known path — hosting.bucket.file.patch search_replace. Omit dry_run.", "when_to_use": "Put one file into the active bucket tree (content or content_base64). Multi-page ship: hosting.deploy_files — one execute step keeps JSON under gateway limits. Refuses a truncated file.get window unle", "write_mode": null}, {"action": "hosting.bucket.file.import_url", "aliases": ["hosting.bucket.file.import_from_url", "hosting.file.import_url", "hosting.import_from_url"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.file.import_url", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket File Import Url", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fetch one HTTPS asset and write it into a hosting bucket path (SSRF-safe). For dist/site ZIP or git repos use hosting.site.import_archive with source_url instead."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.file.import_url", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket File Import Url", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fetch one HTTPS asset and write it into a hosting bucket path (SSRF-safe). For dist/site ZIP or git repos use hosting.site.import_archive with source_url instead."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Fetch one HTTPS asset and write it into a hosting bucket path (SSRF-safe). For dist/site ZIP or git…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_bucket_file_import_url", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Fetch one HTTPS asset and write it into a hosting bucket path (SSRF-safe). For dist/site ZIP or git repos use hosting.site.import_archive with source_url instead.", "title": "Hosting Bucket File Import Url", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Fetch one HTTPS asset and write it into a hosting bucket path (SSRF-safe). For dist/site ZIP or git repos use hosting.site.import_archive with source_url instead.", "write_mode": null}, {"action": "hosting.release.snapshot", "aliases": ["releases.snapshot"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Snapshot is not a file edit. HTML/CSS bytes are hosting.bucket.file.patch.", "anti_patterns": ["Snapshot is not a file edit. HTML/CSS bytes are hosting.bucket.file.patch.", "Do not snapshot before one file.patch. Identical public bytes return the existing release and do not copy.", "The copy is the public site tree, not user storage and not projects/{id}/src. Prior releases/ are not copied again."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.snapshot", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "hosting_quota_exceeded": "Project hosting byte quota full (live tree + workspace) — hosting.release.list, delete stale releases (hosting.release.delete), or raise hosting buff. Same recovery as hosting_archive_quota_exceeded; snapshot may soft-fail while publish succeeds.", "hosting_snapshot_rate_limited": "Upload/publish succeeded; hourly snapshot cap hit — skip manual snapshot. Poll hosting.site.edge_health if the public URL is not ready.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "prune_exhausted": "Snapshot auto-prune dropped unpinned archives (or had none) but a full-tree hosting.release.snapshot still does not fit the owner pool. hosting.quota.breakdown → hosting.release.list → hosting.release.delete — not hosting.gc.orphans unless breakdown shows _gen drift. Do not generation.fork for byte-only hosting.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Manual immutable copy of the live public tree for recovery — not one text line (hosting.bucket.file.patch) or post-publish auto-snapshot."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.snapshot", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "hosting_quota_exceeded": "Project hosting byte quota full (live tree + workspace) — hosting.release.list, delete stale releases (hosting.release.delete), or raise hosting buff. Same recovery as hosting_archive_quota_exceeded; snapshot may soft-fail while publish succeeds.", "hosting_snapshot_rate_limited": "Upload/publish succeeded; hourly snapshot cap hit — skip manual snapshot. Poll hosting.site.edge_health if the public URL is not ready.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "prune_exhausted": "Snapshot auto-prune dropped unpinned archives (or had none) but a full-tree hosting.release.snapshot still does not fit the owner pool. hosting.quota.breakdown → hosting.release.list → hosting.release.delete — not hosting.gc.orphans unless breakdown shows _gen drift. Do not generation.fork for byte-only hosting.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Manual immutable copy of the live public tree for recovery — not one text line (hosting.bucket.file.patch) or post-publish auto-snapshot."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Manual immutable copy of the live public tree for recovery — not one text line (hosting.bucket.file…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_release_snapshot", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create immutable snapshot (archive bucket copy) for a site.", "title": "Hosting Release Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "hosting_quota_exceeded": "Project hosting byte quota full (live tree + workspace) — hosting.release.list, delete stale releases (hosting.release.delete), or raise hosting buff. Same recovery as hosting_archive_quota_exceeded; snapshot may soft-fail while publish succeeds.", "hosting_snapshot_rate_limited": "Upload/publish succeeded; hourly snapshot cap hit — skip manual snapshot. Poll hosting.site.edge_health if the public URL is not ready.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "prune_exhausted": "Snapshot auto-prune dropped unpinned archives (or had none) but a full-tree hosting.release.snapshot still does not fit the owner pool. hosting.quota.breakdown → hosting.release.list → hosting.release.delete — not hosting.gc.orphans unless breakdown shows _gen drift. Do not generation.fork for byte-only hosting.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"hosting_archive_quota_exceeded": {"en-US": "Release archive budget full — hosting.release.list + delete old releases, or raise hosting archive buff; live publish may still succeed (soft-fail snapshot)", "pt-BR": "Cota de archive cheia — hosting.release.list e apague releases antigos; publish live pode ok sem snapshot", "ru-RU": "Квота архива релизов — hosting.release.list и удалите старые снимки; публикация live может пройти без snapshot"}, "hosting_quota_exceeded": {"en-US": "Hosting byte quota full — hosting.release.list + delete old releases, or raise hosting buff; live publish may still succeed (soft-fail snapshot)", "pt-BR": "Cota de bytes do hosting cheia — hosting.release.list e apague releases antigos; publish live pode ok sem snapshot", "ru-RU": "Квота байтов хостинга — hosting.release.list и удалите старые релизы; публикация live может пройти без snapshot"}, "hosting_snapshot_rate_limited": {"en-US": "Publish ok; snapshot rate-limited — skip snapshot, poll hosting.site.edge_health", "pt-BR": "Publicação ok; limite de snapshot — pule snapshot, use hosting.site.edge_health", "ru-RU": "Публикация ок; лимит снимков — не делайте snapshot, опросите hosting.site.edge_health"}, "site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}}, "when_to_use": "Manual immutable copy of the live public tree for recovery — not one text line (hosting.bucket.file.patch) or post-publish auto-snapshot.", "write_mode": null}, {"action": "hosting.release.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.get", "related_tools": ["hosting.release.list", "hosting.release.download"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One release row by release_uuid. include_files=true loads live manifest (heavy)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.get", "related_tools": ["hosting.release.list", "hosting.release.download"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One release row by release_uuid. include_files=true loads live manifest (heavy)."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "One release row by release_uuid. include_files=true loads live manifest (heavy).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.release.list", "hosting.release.download"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_release_get", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Fetch one hosting release row by release_uuid.", "title": "Hosting Release Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "One release row by release_uuid. include_files=true loads live manifest (heavy).", "write_mode": null}, {"action": "hosting.release.download", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.download", "related_tools": ["hosting.release.get", "hosting.release.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Download", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Metadata for one release tree (path count, bytes, sample). Not a zip body. hosting.release.get include_files=true for the manifest."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.download", "related_tools": ["hosting.release.get", "hosting.release.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Download", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Metadata for one release tree (path count, bytes, sample). Not a zip body. hosting.release.get include_files=true for the manifest."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Metadata for one release tree (path count, bytes, sample). Not a zip body. hosting.release.get incl…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.release.get", "hosting.release.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_release_download", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Release byte manifest + TTL metadata (bulk zip via REST when enabled).", "title": "Hosting Release Download", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Metadata for one release tree (path count, bytes, sample). Not a zip body. hosting.release.get include_files=true for the manifest.", "write_mode": null}, {"action": "hosting.release.diff", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.diff", "related_tools": ["hosting.release.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Diff", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Path diff between two immutable release ids on one bucket. Both trees must still be on disk."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.diff", "related_tools": ["hosting.release.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Diff", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Path diff between two immutable release ids on one bucket. Both trees must still be on disk."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Path diff between two immutable release ids on one bucket. Both trees must still be on disk.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.release.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_release_diff", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Path-level manifest diff between two immutable release trees.", "title": "Hosting Release Diff", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Path diff between two immutable release ids on one bucket. Both trees must still be on disk.", "write_mode": null}, {"action": "hosting.release.list", "aliases": ["hosting.list", "releases.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release List", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enumerate release rows to choose hosting.release.promote rollback targets or hosting.release.delete candidates."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release List", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enumerate release rows to choose hosting.release.promote rollback targets or hosting.release.delete candidates."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Enumerate release rows to choose hosting.release.promote rollback targets or hosting.release.delete…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_release_list", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "List site release history (newest first).", "title": "List Hosting Releases", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}}, "when_to_use": "Enumerate release rows to choose hosting.release.promote rollback targets or hosting.release.delete candidates.", "write_mode": null}, {"action": "hosting.release.promote", "aliases": ["hosting.rollback", "hosting.upgrade", "releases.promote"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.promote", "mutation_risk": "low", "related_tools": ["hosting.release.list", "hosting.project.status", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Promote", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Promote a pinned release snapshot onto live /s/ — bypasses prod git journal compile when git_argv_rejected blocks promote_branch/site.build target=prod. Pass release_uuid from hosting.release.list (de"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.promote", "mutation_risk": "low", "related_tools": ["hosting.release.list", "hosting.project.status", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Promote", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Promote a pinned release snapshot onto live /s/ — bypasses prod git journal compile when git_argv_rejected blocks promote_branch/site.build target=prod. Pass release_uuid from hosting.release.list (de"}, "do_not_use_when": "First ship from source commits — hosting.git.init and HOSTING_SHIP_LADDER. Not generation.promote (8DNA) and not hosting.git.promote_branch.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Promote a pinned release snapshot onto live /s/ — bypasses prod git journal compile when git_argv_r…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"skipped": {"description": "boolean", "type": "boolean"}, "url": {"description": "string", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.release.list", "hosting.project.status", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "production_publish", "rollback": ["hosting.release.promote"], "safe_action": "hosting_release_promote", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Promote a release snapshot to the live site bucket and publish.", "title": "Promote Release", "verification": ["hosting.site.edge_health"], "verify": [{"action": "hosting.site.edge_health", "predicate": "ready"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}}, "when_not_to_use": "First ship from source commits — hosting.git.init and HOSTING_SHIP_LADDER. Not generation.promote (8DNA) and not hosting.git.promote_branch.", "when_to_use": "Promote a pinned release snapshot onto live /s/ — bypasses prod git journal compile when git_argv_rejected blocks promote_branch/site.build target=prod. Pass release_uuid from hosting.release.list (de", "write_mode": null}, {"action": "hosting.release.patch", "aliases": ["hosting.release.pin"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.patch", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update release metadata (label and/or pinned flag)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.patch", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update release metadata (label and/or pinned flag)."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Update release metadata (label and/or pinned flag).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_release_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Update release metadata (label and/or pinned flag).", "title": "Hosting Release Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Update release metadata (label and/or pinned flag).", "write_mode": null}, {"action": "hosting.release.delete", "aliases": ["hosting.release.prune", "releases.delete"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.delete", "mutation_risk": "low", "related_tools": ["hosting.release.list", "hosting.release.snapshot", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "release_pinned": "Unpin in UI or pick another release — pinned rows cannot be deleted", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove an unpinned release row (optional bucket purge). hosting.release.list first — never delete the live primary without clone."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.delete", "mutation_risk": "low", "related_tools": ["hosting.release.list", "hosting.release.snapshot", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "release_pinned": "Unpin in UI or pick another release — pinned rows cannot be deleted", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove an unpinned release row (optional bucket purge). hosting.release.list first — never delete the live primary without clone."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Remove an unpinned release row (optional bucket purge). hosting.release.list first — never delete t…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.release.list", "hosting.release.snapshot", "hosting.project.status"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_release_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete an unpinned hosting release (optional bucket purge).", "title": "Hosting Release Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "release_pinned": "Unpin in UI or pick another release — pinned rows cannot be deleted", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Remove an unpinned release row (optional bucket purge). hosting.release.list first — never delete the live primary without clone.", "write_mode": null}, {"action": "hosting.release.clone_site", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.clone_site", "mutation_risk": "low", "related_tools": ["hosting.release.list", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Clone Site", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Spin up a new /s/ bucket from an existing release_uuid after hosting.release.list picks the source snapshot — not a live file patch."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.clone_site", "mutation_risk": "low", "related_tools": ["hosting.release.list", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Clone Site", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Spin up a new /s/ bucket from an existing release_uuid after hosting.release.list picks the source snapshot — not a live file patch."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Spin up a new /s/ bucket from an existing release_uuid after hosting.release.list picks the source …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.release.list", "hosting.project.status"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_release_clone_site", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Clone a new site from a release snapshot.", "title": "Hosting Release Clone Site", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}, "validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_to_use": "Spin up a new /s/ bucket from an existing release_uuid after hosting.release.list picks the source snapshot — not a live file patch.", "write_mode": null}, {"action": "hosting.site.import_archive", "aliases": ["hosting.deploy_zip", "hosting.import_archive_chunk", "hosting.upload_chunk"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not pass local_path or chat attachment ids — use upload_grant or source_url.", "anti_patterns": ["Do not pass local_path or chat attachment ids — use upload_grant or source_url.", "Do not use hosting.deploy_files for ZIP archives.", "Large ZIP in MCP: content_base64 chunks with finalize=false (mints archive_upload_session_id), ≤384KiB decoded per chunk; last call finalize=true + publish/mode flags.", "Aliases: hosting.upload_chunk / hosting.import_archive_chunk → this action."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false, "publish": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.ingress.gen1", "core.hosting.bucket.gen1"], "id": "hosting.site.import_archive", "mutates_when": {"dry_run": false, "publish": true}, "mutation_risk": "low", "related_tools": ["hosting.project.status", "hosting.site.resolve", "hosting.site.upload_grant", "preflight.check", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Import Archive", "when_blocked": {"archive_fetch_failed": "source_url fetch failed (HTTP, timeout, or size cap) — verify URL, retry, or use upload_grant", "archive_index_empty": "index.html is present but empty or too small — rebuild the dist bundle before import", "archive_index_missing": "ZIP has no index.html at root after strip=auto — list sample_paths, fix dist/ layout, or strip=off", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "framework_not_static": "Archive or journal needs a static export (dist/, build/, out/) or a buildable Vite/Astro tree. Next.js without out/ is not static — export with next export/out or upload a Vite dist ZIP. Hugo: ZIP the generated public/ folder.", "git_unrelated_histories": "Fast-forward from upstream failed and adopt_init could not align dev. Use hosting.git.status, resolve conflicts locally, or hosting.git.init on a fresh bucket.", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "hosting_concurrent_deploy": "Deploy/import burst cap for this bucket — wait a minute, reuse idempotency_key after the prior run finishes, or hosting.deploy_files with the same session", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "hosting_missing_reference": "Static href/src/url() points at a path not in the deploy batch or live bucket — hosting.deploy_files dry_run lists missing_references; upload assets or fix links", "hosting_prune_requires_confirmation": "Publish would drop live paths absent from files[] — run dry_run, review manifest_diff.removed, then confirm_prune=true.", "hosting_quota_exceeded": "Project hosting byte quota full (live tree + workspace) — hosting.release.list, delete stale releases (hosting.release.delete), or raise hosting buff. Same recovery as hosting_archive_quota_exceeded; snapshot may soft-fail while publish succeeds.", "hosting_replace_requires_confirmation": "replace_site=true requires confirm_site_replace=true — run dry_run first to preview paths", "hosting_snapshot_rate_limited": "Upload/publish succeeded; hourly snapshot cap hit — skip manual snapshot. Poll hosting.site.edge_health if the public URL is not ready.", "invalid_zip_magic": "Body is not a ZIP archive — check Content-Type and rebuild dist as .zip", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "nested_zip_not_supported": "Nested ZIP members are rejected — export a flat dist.zip", "package_manager_unsupported": "Worker install uses npm only. Add package-lock.json and retry import_archive, or regenerate lock with npm install locally and re-upload.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "source_url_required": "Pass source_url or content_base64 on hosting.site.import_archive — or upload_grant for local bytes", "unsafe_archive_url": "Blocked URL (SSRF) — use a public HTTPS git or ZIP URL", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone.", "zip_compression_ratio_exceeded": "ZIP looks like a compression bomb — export a real build dist; nested zips are rejected", "zip_member_too_large": "A single ZIP member exceeds uncompressed cap — re-export a normal Vite/build dist (no packed huge assets inside one entry)", "zip_slip": "Archive path escapes staging — rebuild dist without parent-directory entries", "zip_too_large": "Compressed archive exceeds import cap — split the dist, use hosting.git, or resumable PATCH with X-Upload-Target: hosting", "zip_too_many_entries": "Archive has too many files — split deploy, use hosting.git journal, or REST resumable ZIP", "zip_uncompressed_limit": "Total uncompressed bytes exceed site import cap — prune assets, split deploy, or use git journal"}, "when_to_use": "Import a ZIP into a bucket via HTTPS source_url or single content_base64 blob. Vite dist: mode=replace, confirm_site_replace=true, confirm_prune=true, strip=auto, publish=true. Local file: hosting.sit"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false, "publish": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.ingress.gen1", "core.hosting.bucket.gen1"], "id": "hosting.site.import_archive", "mutates_when": {"dry_run": false, "publish": true}, "mutation_risk": "low", "related_tools": ["hosting.project.status", "hosting.site.resolve", "hosting.site.upload_grant", "preflight.check", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Import Archive", "when_blocked": {"archive_fetch_failed": "source_url fetch failed (HTTP, timeout, or size cap) — verify URL, retry, or use upload_grant", "archive_index_empty": "index.html is present but empty or too small — rebuild the dist bundle before import", "archive_index_missing": "ZIP has no index.html at root after strip=auto — list sample_paths, fix dist/ layout, or strip=off", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "framework_not_static": "Archive or journal needs a static export (dist/, build/, out/) or a buildable Vite/Astro tree. Next.js without out/ is not static — export with next export/out or upload a Vite dist ZIP. Hugo: ZIP the generated public/ folder.", "git_unrelated_histories": "Fast-forward from upstream failed and adopt_init could not align dev. Use hosting.git.status, resolve conflicts locally, or hosting.git.init on a fresh bucket.", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "hosting_concurrent_deploy": "Deploy/import burst cap for this bucket — wait a minute, reuse idempotency_key after the prior run finishes, or hosting.deploy_files with the same session", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "hosting_missing_reference": "Static href/src/url() points at a path not in the deploy batch or live bucket — hosting.deploy_files dry_run lists missing_references; upload assets or fix links", "hosting_prune_requires_confirmation": "Publish would drop live paths absent from files[] — run dry_run, review manifest_diff.removed, then confirm_prune=true.", "hosting_quota_exceeded": "Project hosting byte quota full (live tree + workspace) — hosting.release.list, delete stale releases (hosting.release.delete), or raise hosting buff. Same recovery as hosting_archive_quota_exceeded; snapshot may soft-fail while publish succeeds.", "hosting_replace_requires_confirmation": "replace_site=true requires confirm_site_replace=true — run dry_run first to preview paths", "hosting_snapshot_rate_limited": "Upload/publish succeeded; hourly snapshot cap hit — skip manual snapshot. Poll hosting.site.edge_health if the public URL is not ready.", "invalid_zip_magic": "Body is not a ZIP archive — check Content-Type and rebuild dist as .zip", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "nested_zip_not_supported": "Nested ZIP members are rejected — export a flat dist.zip", "package_manager_unsupported": "Worker install uses npm only. Add package-lock.json and retry import_archive, or regenerate lock with npm install locally and re-upload.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "source_url_required": "Pass source_url or content_base64 on hosting.site.import_archive — or upload_grant for local bytes", "unsafe_archive_url": "Blocked URL (SSRF) — use a public HTTPS git or ZIP URL", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone.", "zip_compression_ratio_exceeded": "ZIP looks like a compression bomb — export a real build dist; nested zips are rejected", "zip_member_too_large": "A single ZIP member exceeds uncompressed cap — re-export a normal Vite/build dist (no packed huge assets inside one entry)", "zip_slip": "Archive path escapes staging — rebuild dist without parent-directory entries", "zip_too_large": "Compressed archive exceeds import cap — split the dist, use hosting.git, or resumable PATCH with X-Upload-Target: hosting", "zip_too_many_entries": "Archive has too many files — split deploy, use hosting.git journal, or REST resumable ZIP", "zip_uncompressed_limit": "Total uncompressed bytes exceed site import cap — prune assets, split deploy, or use git journal"}, "when_to_use": "Import a ZIP into a bucket via HTTPS source_url or single content_base64 blob. Vite dist: mode=replace, confirm_site_replace=true, confirm_prune=true, strip=auto, publish=true. Local file: hosting.sit"}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true previews ZIP gates only (no bucket write). Static dist ZIP: publish=true goes live inline unless async=true (defer publish — call hosting.publish next). async=true on static dist enqueues a background ingest job (job_id) — poll hosting.site.build_status; large ZIP avoids sync MCP batch timeout. Source/git ZIP or repo URL returns job_id and enqueues workspace build — same poll; live unchanged until build+promote. mode=replace needs confirm_site_replace; prune needs confirm_prune. Optional idempotency_key replays a prior successful import (including job_id). One-shot content_base64 ZIPs above ~384KiB decoded are rejected (mcp_archive_inline_too_large) — use chunked import_archive (finalize=false + archive_upload_session_id, ≤384KiB per chunk) or hosting.site.upload_grant + HTTPS POST. Unpacked static trees use hosting.deploy_files upload_session_id.", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false, "publish": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Vite dist from URL", "request": {"bucket_name": "my-site", "confirm_prune": true, "confirm_site_replace": true, "mode": "replace", "project_id": 1, "publish": true, "source_url": "https://cdn.example/dist.zip", "strip": "auto"}}, {"name": "Preview paths only", "request": {"bucket_id": "<uuid>", "confirm_site_replace": true, "dry_run": true, "mode": "replace", "project_id": 1, "strip": "auto"}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Import a ZIP into a bucket via HTTPS source_url or single content_base64 blob. Vite dist: mode=repl…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"files_written": {"description": "integer", "type": "integer"}, "job_id": {"description": "string", "type": "string"}, "live_changed": {"description": "boolean", "type": "boolean"}, "stripped_prefix": {"description": "string", "type": "string"}, "url": {"description": "string", "type": "string"}, "verification_action": {"description": "string", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "pending_state": "publish=true leaves success=false until hosting.site.edge_health shows edge ready (mutation receipt committed=false).", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.status", "hosting.site.resolve", "hosting.site.upload_grant", "preflight.check", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["hosting.release.promote"], "safe_action": "hosting_site_import_archive", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Import hosted site bytes: ZIP dist publishes to live (optional publish); ZIP with package.json without dist/ enqueues workspace build on --dev (poll build_status). HTTPS git URL (GitHub/GitLab, not .z", "title": "Hosting Site Import Archive", "verification": ["hosting.project.status", "hosting.site.edge_health"], "verify": [{"action": "hosting.project.status", "predicate": "named resource is visible"}, {"action": "hosting.site.edge_health", "predicate": "named resource is visible"}], "when_blocked": {"archive_fetch_failed": "source_url fetch failed (HTTP, timeout, or size cap) — verify URL, retry, or use upload_grant", "archive_index_empty": "index.html is present but empty or too small — rebuild the dist bundle before import", "archive_index_missing": "ZIP has no index.html at root after strip=auto — list sample_paths, fix dist/ layout, or strip=off", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "framework_not_static": "Archive or journal needs a static export (dist/, build/, out/) or a buildable Vite/Astro tree. Next.js without out/ is not static — export with next export/out or upload a Vite dist ZIP. Hugo: ZIP the generated public/ folder.", "git_unrelated_histories": "Fast-forward from upstream failed and adopt_init could not align dev. Use hosting.git.status, resolve conflicts locally, or hosting.git.init on a fresh bucket.", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "hosting_concurrent_deploy": "Deploy/import burst cap for this bucket — wait a minute, reuse idempotency_key after the prior run finishes, or hosting.deploy_files with the same session", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "hosting_missing_reference": "Static href/src/url() points at a path not in the deploy batch or live bucket — hosting.deploy_files dry_run lists missing_references; upload assets or fix links", "hosting_prune_requires_confirmation": "Publish would drop live paths absent from files[] — run dry_run, review manifest_diff.removed, then confirm_prune=true.", "hosting_quota_exceeded": "Project hosting byte quota full (live tree + workspace) — hosting.release.list, delete stale releases (hosting.release.delete), or raise hosting buff. Same recovery as hosting_archive_quota_exceeded; snapshot may soft-fail while publish succeeds.", "hosting_replace_requires_confirmation": "replace_site=true requires confirm_site_replace=true — run dry_run first to preview paths", "hosting_snapshot_rate_limited": "Upload/publish succeeded; hourly snapshot cap hit — skip manual snapshot. Poll hosting.site.edge_health if the public URL is not ready.", "invalid_zip_magic": "Body is not a ZIP archive — check Content-Type and rebuild dist as .zip", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "nested_zip_not_supported": "Nested ZIP members are rejected — export a flat dist.zip", "package_manager_unsupported": "Worker install uses npm only. Add package-lock.json and retry import_archive, or regenerate lock with npm install locally and re-upload.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "source_url_required": "Pass source_url or content_base64 on hosting.site.import_archive — or upload_grant for local bytes", "unsafe_archive_url": "Blocked URL (SSRF) — use a public HTTPS git or ZIP URL", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone.", "zip_compression_ratio_exceeded": "ZIP looks like a compression bomb — export a real build dist; nested zips are rejected", "zip_member_too_large": "A single ZIP member exceeds uncompressed cap — re-export a normal Vite/build dist (no packed huge assets inside one entry)", "zip_slip": "Archive path escapes staging — rebuild dist without parent-directory entries", "zip_too_large": "Compressed archive exceeds import cap — split the dist, use hosting.git, or resumable PATCH with X-Upload-Target: hosting", "zip_too_many_entries": "Archive has too many files — split deploy, use hosting.git journal, or REST resumable ZIP", "zip_uncompressed_limit": "Total uncompressed bytes exceed site import cap — prune assets, split deploy, or use git journal"}, "when_blocked_locales": {"hosting_archive_quota_exceeded": {"en-US": "Release archive budget full — hosting.release.list + delete old releases, or raise hosting archive buff; live publish may still succeed (soft-fail snapshot)", "pt-BR": "Cota de archive cheia — hosting.release.list e apague releases antigos; publish live pode ok sem snapshot", "ru-RU": "Квота архива релизов — hosting.release.list и удалите старые снимки; публикация live может пройти без snapshot"}, "hosting_quota_exceeded": {"en-US": "Hosting byte quota full — hosting.release.list + delete old releases, or raise hosting buff; live publish may still succeed (soft-fail snapshot)", "pt-BR": "Cota de bytes do hosting cheia — hosting.release.list e apague releases antigos; publish live pode ok sem snapshot", "ru-RU": "Квота байтов хостинга — hosting.release.list и удалите старые релизы; публикация live может пройти без snapshot"}, "hosting_snapshot_rate_limited": {"en-US": "Publish ok; snapshot rate-limited — skip snapshot, poll hosting.site.edge_health", "pt-BR": "Publicação ok; limite de snapshot — pule snapshot, use hosting.site.edge_health", "ru-RU": "Публикация ок; лимит снимков — не делайте snapshot, опросите hosting.site.edge_health"}, "site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}, "validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_to_use": "Import a ZIP into a bucket via HTTPS source_url or single content_base64 blob. Vite dist: mode=replace, confirm_site_replace=true, confirm_prune=true, strip=auto, publish=true. Local file: hosting.sit", "write_mode": null}, {"action": "hosting.site.upload_grant", "aliases": ["hosting.upload_grant", "storage.upload_grant"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not embed file bytes in upload_grant params — POST multipart field file to returned url.", "anti_patterns": ["Do not embed file bytes in upload_grant params — POST multipart field file to returned url.", "Send header X-Ingress-Grant from the MCP receipt (url is /api/hosting/ingress/upload)."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "execution_class": "cheap", "genetic_tags": ["core.hosting.ingress.gen1"], "id": "hosting.site.upload_grant", "mutation_risk": "low", "related_tools": ["hosting.site.import_archive", "hosting.project.status", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Upload Grant", "when_blocked": {"archive_index_empty": "index.html is present but empty or too small — rebuild the dist bundle before import", "archive_index_missing": "ZIP has no index.html at root after strip=auto — list sample_paths, fix dist/ layout, or strip=off", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "hosting_concurrent_deploy": "Deploy/import burst cap for this bucket — wait a minute, reuse idempotency_key after the prior run finishes, or hosting.deploy_files with the same session", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "hosting_ingress_grant_rate_limited": "Wait and retry upload_grant — max 30 mints per hour per operator", "hosting_prune_requires_confirmation": "Publish would drop live paths absent from files[] — run dry_run, review manifest_diff.removed, then confirm_prune=true.", "hosting_quota_exceeded": "Project hosting byte quota full (live tree + workspace) — hosting.release.list, delete stale releases (hosting.release.delete), or raise hosting buff. Same recovery as hosting_archive_quota_exceeded; snapshot may soft-fail while publish succeeds.", "hosting_replace_requires_confirmation": "replace_site=true requires confirm_site_replace=true — run dry_run first to preview paths", "ingress_grant_consumed": "Grant already consumed after a successful upload — mint a new upload_grant for another deploy", "ingress_grant_expired": "Mint a new hosting.site.upload_grant — TTL is 15 minutes", "ingress_grant_in_use": "Another upload is using this grant — wait for it to finish or mint a new upload_grant", "ingress_grant_invalid": "Mint a new hosting.site.upload_grant — tokens are single-use and short-lived", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_zip_magic": "Body is not a ZIP archive — check Content-Type and rebuild dist as .zip", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "nested_zip_not_supported": "Nested ZIP members are rejected — export a flat dist.zip", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "upload_grant mints POST /api/hosting/ingress/upload only — send multipart field file with header X-Ingress-Grant from the grant response. Do not pass content_base64 or source_url here; use hosting.site.import_archive.", "zip_compression_ratio_exceeded": "ZIP looks like a compression bomb — export a real build dist; nested zips are rejected", "zip_member_too_large": "A single ZIP member exceeds uncompressed cap — re-export a normal Vite/build dist (no packed huge assets inside one entry)", "zip_slip": "Archive path escapes staging — rebuild dist without parent-directory entries", "zip_too_large": "Compressed archive exceeds import cap — split the dist, use hosting.git, or resumable PATCH with X-Upload-Target: hosting", "zip_too_many_entries": "Archive has too many files — split deploy, use hosting.git journal, or REST resumable ZIP", "zip_uncompressed_limit": "Total uncompressed bytes exceed site import cap — prune assets, split deploy, or use git journal"}, "when_to_use": "Mint one-time POST /api/hosting/ingress/upload (no bytes in MCP JSON). Client sends header X-Ingress-Grant and multipart field file. Does not accept content_base64 or source_url — use import_archive f"}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "execution_class": "cheap", "genetic_tags": ["core.hosting.ingress.gen1"], "id": "hosting.site.upload_grant", "mutation_risk": "low", "related_tools": ["hosting.site.import_archive", "hosting.project.status", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Upload Grant", "when_blocked": {"archive_index_empty": "index.html is present but empty or too small — rebuild the dist bundle before import", "archive_index_missing": "ZIP has no index.html at root after strip=auto — list sample_paths, fix dist/ layout, or strip=off", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "hosting_concurrent_deploy": "Deploy/import burst cap for this bucket — wait a minute, reuse idempotency_key after the prior run finishes, or hosting.deploy_files with the same session", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "hosting_ingress_grant_rate_limited": "Wait and retry upload_grant — max 30 mints per hour per operator", "hosting_prune_requires_confirmation": "Publish would drop live paths absent from files[] — run dry_run, review manifest_diff.removed, then confirm_prune=true.", "hosting_quota_exceeded": "Project hosting byte quota full (live tree + workspace) — hosting.release.list, delete stale releases (hosting.release.delete), or raise hosting buff. Same recovery as hosting_archive_quota_exceeded; snapshot may soft-fail while publish succeeds.", "hosting_replace_requires_confirmation": "replace_site=true requires confirm_site_replace=true — run dry_run first to preview paths", "ingress_grant_consumed": "Grant already consumed after a successful upload — mint a new upload_grant for another deploy", "ingress_grant_expired": "Mint a new hosting.site.upload_grant — TTL is 15 minutes", "ingress_grant_in_use": "Another upload is using this grant — wait for it to finish or mint a new upload_grant", "ingress_grant_invalid": "Mint a new hosting.site.upload_grant — tokens are single-use and short-lived", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_zip_magic": "Body is not a ZIP archive — check Content-Type and rebuild dist as .zip", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "nested_zip_not_supported": "Nested ZIP members are rejected — export a flat dist.zip", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "upload_grant mints POST /api/hosting/ingress/upload only — send multipart field file with header X-Ingress-Grant from the grant response. Do not pass content_base64 or source_url here; use hosting.site.import_archive.", "zip_compression_ratio_exceeded": "ZIP looks like a compression bomb — export a real build dist; nested zips are rejected", "zip_member_too_large": "A single ZIP member exceeds uncompressed cap — re-export a normal Vite/build dist (no packed huge assets inside one entry)", "zip_slip": "Archive path escapes staging — rebuild dist without parent-directory entries", "zip_too_large": "Compressed archive exceeds import cap — split the dist, use hosting.git, or resumable PATCH with X-Upload-Target: hosting", "zip_too_many_entries": "Archive has too many files — split deploy, use hosting.git journal, or REST resumable ZIP", "zip_uncompressed_limit": "Total uncompressed bytes exceed site import cap — prune assets, split deploy, or use git journal"}, "when_to_use": "Mint one-time POST /api/hosting/ingress/upload (no bytes in MCP JSON). Client sends header X-Ingress-Grant and multipart field file. Does not accept content_base64 or source_url — use import_archive f"}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Mints a short-lived one-time POST grant only — live bucket bytes change on multipart HTTP POST to /api/hosting/ingress/upload with header X-Ingress-Grant (field file), not in this MCP execute step.", "execution_class": "cheap", "kind": "mutate", "mutates_when": "always", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Local ZIP via HTTP POST", "note": "POST field file to url with headers.X-Ingress-Grant — not MCP bytes.", "request": {"bucket_name": "my-site", "confirm_prune": true, "confirm_site_replace": true, "mode": "replace", "project_id": 1, "publish": true, "strip": "auto"}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Mint one-time POST /api/hosting/ingress/upload (no bytes in MCP JSON). Client sends header X-Ingres…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"expires_at": {"description": "number", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "max_bytes": {"description": "integer", "type": "integer"}, "method": {"description": "string", "type": "string"}, "url": {"description": "string", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.site.import_archive", "hosting.project.status", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "hosting_site_upload_grant", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Mint a one-time POST grant for multipart ZIP upload (no bytes in MCP JSON). Agent HTTP client POSTs form field file to /api/hosting/ingress/upload with header X-Ingress-Grant.", "title": "Hosting Site Upload Grant", "verification": ["hosting.site.edge_health"], "verify": [{"action": "hosting.site.edge_health", "predicate": "named resource is visible"}], "when_blocked": {"archive_index_empty": "index.html is present but empty or too small — rebuild the dist bundle before import", "archive_index_missing": "ZIP has no index.html at root after strip=auto — list sample_paths, fix dist/ layout, or strip=off", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "hosting_concurrent_deploy": "Deploy/import burst cap for this bucket — wait a minute, reuse idempotency_key after the prior run finishes, or hosting.deploy_files with the same session", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "hosting_ingress_grant_rate_limited": "Wait and retry upload_grant — max 30 mints per hour per operator", "hosting_prune_requires_confirmation": "Publish would drop live paths absent from files[] — run dry_run, review manifest_diff.removed, then confirm_prune=true.", "hosting_quota_exceeded": "Project hosting byte quota full (live tree + workspace) — hosting.release.list, delete stale releases (hosting.release.delete), or raise hosting buff. Same recovery as hosting_archive_quota_exceeded; snapshot may soft-fail while publish succeeds.", "hosting_replace_requires_confirmation": "replace_site=true requires confirm_site_replace=true — run dry_run first to preview paths", "ingress_grant_consumed": "Grant already consumed after a successful upload — mint a new upload_grant for another deploy", "ingress_grant_expired": "Mint a new hosting.site.upload_grant — TTL is 15 minutes", "ingress_grant_in_use": "Another upload is using this grant — wait for it to finish or mint a new upload_grant", "ingress_grant_invalid": "Mint a new hosting.site.upload_grant — tokens are single-use and short-lived", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_zip_magic": "Body is not a ZIP archive — check Content-Type and rebuild dist as .zip", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "nested_zip_not_supported": "Nested ZIP members are rejected — export a flat dist.zip", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "upload_grant mints POST /api/hosting/ingress/upload only — send multipart field file with header X-Ingress-Grant from the grant response. Do not pass content_base64 or source_url here; use hosting.site.import_archive.", "zip_compression_ratio_exceeded": "ZIP looks like a compression bomb — export a real build dist; nested zips are rejected", "zip_member_too_large": "A single ZIP member exceeds uncompressed cap — re-export a normal Vite/build dist (no packed huge assets inside one entry)", "zip_slip": "Archive path escapes staging — rebuild dist without parent-directory entries", "zip_too_large": "Compressed archive exceeds import cap — split the dist, use hosting.git, or resumable PATCH with X-Upload-Target: hosting", "zip_too_many_entries": "Archive has too many files — split deploy, use hosting.git journal, or REST resumable ZIP", "zip_uncompressed_limit": "Total uncompressed bytes exceed site import cap — prune assets, split deploy, or use git journal"}, "when_blocked_locales": {"hosting_archive_quota_exceeded": {"en-US": "Release archive budget full — hosting.release.list + delete old releases, or raise hosting archive buff; live publish may still succeed (soft-fail snapshot)", "pt-BR": "Cota de archive cheia — hosting.release.list e apague releases antigos; publish live pode ok sem snapshot", "ru-RU": "Квота архива релизов — hosting.release.list и удалите старые снимки; публикация live может пройти без snapshot"}, "hosting_quota_exceeded": {"en-US": "Hosting byte quota full — hosting.release.list + delete old releases, or raise hosting buff; live publish may still succeed (soft-fail snapshot)", "pt-BR": "Cota de bytes do hosting cheia — hosting.release.list e apague releases antigos; publish live pode ok sem snapshot", "ru-RU": "Квота байтов хостинга — hosting.release.list и удалите старые релизы; публикация live может пройти без snapshot"}, "site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}, "validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_to_use": "Mint one-time POST /api/hosting/ingress/upload (no bytes in MCP JSON). Client sends header X-Ingress-Grant and multipart field file. Does not accept content_base64 or source_url — use import_archive f", "write_mode": null}, {"action": "hosting.storage.import_folder", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Import moves storage → bucket. One text edit is hosting.bucket.file.patch, not a GET.", "anti_patterns": ["Import moves storage → bucket. One text edit is hosting.bucket.file.patch, not a GET.", "Not for Vite dist (.js blocked in storage)."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.storage.import_folder", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Storage Import Folder", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Bulk-move a project storage folder into the site bucket; single-path edits stay hosting.bucket.file.patch."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.storage.import_folder", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Storage Import Folder", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Bulk-move a project storage folder into the site bucket; single-path edits stay hosting.bucket.file.patch."}, "do_not_use_when": "One-line edit on an existing bucket file — hosting.bucket.file.patch.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Bulk-move a project storage folder into the site bucket; single-path edits stay hosting.bucket.file…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_storage_import_folder", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Import a project storage folder into a hosting bucket.", "title": "Hosting Storage Import Folder", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_blocked_locales": {"validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_not_to_use": "One-line edit on an existing bucket file — hosting.bucket.file.patch.", "when_to_use": "Bulk-move a project storage folder into the site bucket; single-path edits stay hosting.bucket.file.patch.", "write_mode": null}, {"action": "hosting.project.status", "aliases": ["hosting.project-status", "hosting.project.status.ladder", "hosting.project.status.ladder.sell", "hosting.project_status", "hosting.site.get", "hosting.site.list", "hosting.site.status", "hosting.sites.get", "hosting.sites.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Ladder-only polls: leave include_workspace_meta false (default). Per-bucket sources_sha → hosting.workspace.meta.", "anti_patterns": ["Ladder-only polls: leave include_workspace_meta false (default). Per-bucket sources_sha → hosting.workspace.meta.", "Do not read file content here — use hosting.bucket.file.get with bucket_id from plane.", "Do not hosting.site.quick_start when primary_public_url is already set."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.project.status", "related_tools": ["hosting.surface.resolve", "hosting.site.resolve", "hosting.workspace.meta", "hosting.bucket.file.patch", "hosting.deploy_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Project Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id required — pass params.project_id or bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hosting plane overview — buckets and primary_public_url. This read does not start a file patch. Includes recommended_recipe_id when intent param is passed. Set include_workspace_meta=true only before "}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.project.status", "related_tools": ["hosting.surface.resolve", "hosting.site.resolve", "hosting.workspace.meta", "hosting.bucket.file.patch", "hosting.deploy_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Project Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id required — pass params.project_id or bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hosting plane overview — buckets and primary_public_url. This read does not start a file patch. Includes recommended_recipe_id when intent param is passed. Set include_workspace_meta=true only before "}, "do_not_use_when": "Never substitute for hosting.bucket.file.get when you need file bytes.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.surface.resolve", "hosting.site.resolve", "hosting.workspace.meta", "hosting.bucket.file.patch", "hosting.deploy_files"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_project_status", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Project hosting plane: Host/Sell/Scale ladder, sites summary, next_actions.", "title": "Inspect Project Hosting", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id required — pass params.project_id or bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_not_to_use": "Never substitute for hosting.bucket.file.get when you need file bytes.", "when_to_use": "Hosting plane overview — buckets and primary_public_url. This read does not start a file patch. Includes recommended_recipe_id when intent param is passed. Set include_workspace_meta=true only before", "write_mode": null}, {"action": "hosting.quota.breakdown", "aliases": ["hosting.bucket.quota", "hosting.bucket.usage"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not treat storage.get_quota used=0 as hosting headroom — use this breakdown.", "anti_patterns": ["Do not treat storage.get_quota used=0 as hosting headroom — use this breakdown.", "Do not bulk_delete assets/ to free quota before dry_run gc.orphans."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.quota.breakdown", "related_tools": ["hosting.project.status", "hosting.gc.orphans", "hosting.quota.recount"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Quota Breakdown", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only byte split: live tree, workspace, _gen staging, archives. Use when hosting_quota_exceeded or storage hub hosting bytes look wrong. Does not delete. Follow with hosting.gc.orphans dry_run."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.quota.breakdown", "related_tools": ["hosting.project.status", "hosting.gc.orphans", "hosting.quota.recount"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Quota Breakdown", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only byte split: live tree, workspace, _gen staging, archives. Use when hosting_quota_exceeded or storage hub hosting bytes look wrong. Does not delete. Follow with hosting.gc.orphans dry_run."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Read-only byte split: live tree, workspace, _gen staging, archives. Use when hosting_quota_exceeded…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.status", "hosting.gc.orphans", "hosting.quota.recount"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_quota_breakdown", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Read-only hosting quota components (live, staging _gen, workspace, archives).", "title": "Hosting Quota Breakdown", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Read-only byte split: live tree, workspace, _gen staging, archives. Use when hosting_quota_exceeded or storage hub hosting bytes look wrong. Does not delete. Follow with hosting.gc.orphans dry_run.", "write_mode": null}, {"action": "hosting.quota.recount", "annotations": {"destructiveHint": true, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.quota.recount", "mutates_when": {"dry_run": false}, "mutation_risk": "low", "related_tools": ["hosting.quota.breakdown"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Quota Recount", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reconcile DNA quota counter with on-disk measure. dry_run defaults true. apply writes the measured total — owner write, not a file delete."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.quota.recount", "mutates_when": {"dry_run": false}, "mutation_risk": "low", "related_tools": ["hosting.quota.breakdown"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Quota Recount", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reconcile DNA quota counter with on-disk measure. dry_run defaults true. apply writes the measured total — owner write, not a file delete."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true evaluates only; dry_run=false applies changes", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Reconcile DNA quota counter with on-disk measure. dry_run defaults true. apply writes the measured …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.quota.breakdown"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_quota_recount", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Reconcile DNA hosting quota with on-disk measure (owner write for apply).", "title": "Hosting Quota Recount", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Reconcile DNA quota counter with on-disk measure. dry_run defaults true. apply writes the measured total — owner write, not a file delete.", "write_mode": null}, {"action": "hosting.gc.orphans", "annotations": {"destructiveHint": true, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.gc.orphans", "mutates_when": {"dry_run": false}, "mutation_risk": "low", "related_tools": ["hosting.quota.breakdown", "hosting.quota.recount"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Gc Orphans", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drop abandoned _gen upload sessions older than older_than_hours. dry_run defaults true. Does not touch live current or releases."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.gc.orphans", "mutates_when": {"dry_run": false}, "mutation_risk": "low", "related_tools": ["hosting.quota.breakdown", "hosting.quota.recount"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Gc Orphans", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drop abandoned _gen upload sessions older than older_than_hours. dry_run defaults true. Does not touch live current or releases."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true evaluates only; dry_run=false applies changes", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Drop abandoned _gen upload sessions older than older_than_hours. dry_run defaults true. Does not to…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.quota.breakdown", "hosting.quota.recount"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_gc_orphans", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Remove abandoned _gen staging dirs older than TTL (dry_run default).", "title": "Hosting Gc Orphans", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Drop abandoned _gen upload sessions older than older_than_hours. dry_run defaults true. Does not touch live current or releases.", "write_mode": null}, {"action": "hosting.site.preset.apply", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Rules are advisory. This call does not persist headers.", "anti_patterns": ["Rules are advisory. This call does not persist headers."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.preset.apply", "mutation_risk": "low", "related_tools": ["hosting.deploy_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Preset Apply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Returns recommended Cache-Control rules for vite_pwa, spa, or static. Does not write DNA or nginx. Apply the rules in the build, then hosting.deploy_files."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.preset.apply", "mutation_risk": "low", "related_tools": ["hosting.deploy_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Preset Apply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Returns recommended Cache-Control rules for vite_pwa, spa, or static. Does not write DNA or nginx. Apply the rules in the build, then hosting.deploy_files."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Returns recommended Cache-Control rules for vite_pwa, spa, or static. Does not write DNA or nginx. …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.deploy_files"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_site_preset_apply", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Apply recommended edge/header preset (vite_pwa, spa, static).", "title": "Hosting Site Preset Apply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Returns recommended Cache-Control rules for vite_pwa, spa, or static. Does not write DNA or nginx. Apply the rules in the build, then hosting.deploy_files.", "write_mode": null}, {"action": "hosting.site.purge", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Success with purged=0 is honest — there is no CDN to invalidate.", "anti_patterns": ["Success with purged=0 is honest — there is no CDN to invalidate."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.purge", "related_tools": ["hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Purge", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Origin /s/ has no CDN. Returns purged=0 reason=origin_only. Change Cache-Control via deploy, do not expect a purge to drop bytes."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.purge", "related_tools": ["hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Purge", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Origin /s/ has no CDN. Returns purged=0 reason=origin_only. Change Cache-Control via deploy, do not expect a purge to drop bytes."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Origin /s/ has no CDN. Returns purged=0 reason=origin_only. Change Cache-Control via deploy, do not…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_site_purge", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Invalidate edge/CDN cache for site paths (origin no-op when no CDN).", "title": "Hosting Site Purge", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Origin /s/ has no CDN. Returns purged=0 reason=origin_only. Change Cache-Control via deploy, do not expect a purge to drop bytes.", "write_mode": null}, {"action": "hosting.site.prune", "annotations": {"destructiveHint": true, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "dry_run first. keep_releases never deletes the live current tree.", "anti_patterns": ["dry_run first. keep_releases never deletes the live current tree.", "Abandoned upload sessions are hosting.gc.orphans, not prune."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.prune", "mutates_when": {"dry_run": false}, "mutation_risk": "low", "related_tools": ["hosting.release.list", "hosting.gc.orphans"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Prune", "when_blocked": {"bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete inactive on-disk releases beyond keep_releases (live current stays). dry_run defaults true. Staging orphans are hosting.gc.orphans, not this tool."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.prune", "mutates_when": {"dry_run": false}, "mutation_risk": "low", "related_tools": ["hosting.release.list", "hosting.gc.orphans"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Prune", "when_blocked": {"bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete inactive on-disk releases beyond keep_releases (live current stays). dry_run defaults true. Staging orphans are hosting.gc.orphans, not this tool."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true evaluates only; dry_run=false applies changes", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Delete inactive on-disk releases beyond keep_releases (live current stays). dry_run defaults true. …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.release.list", "hosting.gc.orphans"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_site_prune", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Prune stale hashed assets not in last K releases (dry_run default).", "title": "Hosting Site Prune", "when_blocked": {"bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}}, "when_to_use": "Delete inactive on-disk releases beyond keep_releases (live current stays). dry_run defaults true. Staging orphans are hosting.gc.orphans, not this tool.", "write_mode": null}, {"action": "hosting.site.retention.set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.retention.set", "related_tools": ["hosting.project.status", "hosting.release.list", "hosting.site.prune"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Retention Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "L2 admin RBAC — preflight.check or permissions.effective action=hosting.deploy_files (action_params.publish=true, slim files:[{path,bytes}] for probes); rbac.check_permission(admin). If admin granted but deploy/preflight denies: stale permissions_bitmap — reconnect OAuth; ops scripts use execution_intent=direct; core bitmap_session_reconcile + hydrate_mcp_execute_principal.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Raise or lower how many immutable hosting.release.snapshot rows are kept per site (DNA quota.releases_max_per_site). Pair with hosting.release.list before pruning."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.retention.set", "related_tools": ["hosting.project.status", "hosting.release.list", "hosting.site.prune"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Retention Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "L2 admin RBAC — preflight.check or permissions.effective action=hosting.deploy_files (action_params.publish=true, slim files:[{path,bytes}] for probes); rbac.check_permission(admin). If admin granted but deploy/preflight denies: stale permissions_bitmap — reconnect OAuth; ops scripts use execution_intent=direct; core bitmap_session_reconcile + hydrate_mcp_execute_principal.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Raise or lower how many immutable hosting.release.snapshot rows are kept per site (DNA quota.releases_max_per_site). Pair with hosting.release.list before pruning."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"conditional_mutate": "Updates DNA quota.releases_max_per_site (always mutates on success)", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Raise or lower how many immutable hosting.release.snapshot rows are kept per site (DNA quota.releas…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.status", "hosting.release.list", "hosting.site.prune"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_site_retention_set", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Set per-project archive release count cap (DNA quota.releases_max_per_site).", "title": "Hosting Site Retention Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "L2 admin RBAC — preflight.check or permissions.effective action=hosting.deploy_files (action_params.publish=true, slim files:[{path,bytes}] for probes); rbac.check_permission(admin). If admin granted but deploy/preflight denies: stale permissions_bitmap — reconnect OAuth; ops scripts use execution_intent=direct; core bitmap_session_reconcile + hydrate_mcp_execute_principal.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Raise or lower how many immutable hosting.release.snapshot rows are kept per site (DNA quota.releases_max_per_site). Pair with hosting.release.list before pruning.", "write_mode": null}, {"action": "hosting.surface.resolve", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.surface.resolve", "related_tools": ["hosting.project.status", "hosting.workspace.init", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Surface Resolve", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only deploy surface router — returns recommended_recipe_id for agents. Execute that recipe next; do not discovery.search when intent is known."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.surface.resolve", "related_tools": ["hosting.project.status", "hosting.workspace.init", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Surface Resolve", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only deploy surface router — returns recommended_recipe_id for agents. Execute that recipe next; do not discovery.search when intent is known."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Read-only deploy surface router — returns recommended_recipe_id for agents. Execute that recipe nex…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.status", "hosting.workspace.init", "hosting.site.build"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_surface_resolve", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Read-only deploy surface router: map intent to recipe_id (agents).", "title": "Hosting Surface Resolve", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}}, "when_to_use": "Read-only deploy surface router — returns recommended_recipe_id for agents. Execute that recipe next; do not discovery.search when intent is known.", "write_mode": null}, {"action": "hosting.project.set_primary_site", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.project.set_primary_site", "mutation_risk": "low", "related_tools": ["hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Project Set Primary Site", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "When several buckets exist, set which one is canonical primary — run hosting.project.status first, then patch/deploy against that bucket_id."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.project.set_primary_site", "mutation_risk": "low", "related_tools": ["hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Project Set Primary Site", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "When several buckets exist, set which one is canonical primary — run hosting.project.status first, then patch/deploy against that bucket_id."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "When several buckets exist, set which one is canonical primary — run hosting.project.status first, …", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.status"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_project_set_primary_site", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Set the project's primary public site URL when multiple sites exist (PH-18).", "title": "Hosting Project Set Primary Site", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}, "validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_to_use": "When several buckets exist, set which one is canonical primary — run hosting.project.status first, then patch/deploy against that bucket_id.", "write_mode": null}, {"action": "hosting.bucket.publish", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.publish", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket Publish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Publish live /s/ bytes for a bucket (gates + manifest + edge health)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.publish", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket Publish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Publish live /s/ bytes for a bucket (gates + manifest + edge health)."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Publish live /s/ bytes for a bucket (gates + manifest + edge health).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "production_publish", "safe_action": "hosting_bucket_publish", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Publish live /s/ bytes for a bucket (gates + manifest + edge health).", "title": "Hosting Bucket Publish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Publish live /s/ bytes for a bucket (gates + manifest + edge health).", "write_mode": null}, {"action": "hosting.bucket.preview_publish", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.preview_publish", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket Preview Publish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Copy live bucket tree to preview plane and refresh preview symlink."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.preview_publish", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket Preview Publish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Copy live bucket tree to preview plane and refresh preview symlink."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Copy live bucket tree to preview plane and refresh preview symlink.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "production_publish", "safe_action": "hosting_bucket_preview_publish", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Copy live bucket tree to preview plane and refresh preview symlink.", "title": "Hosting Bucket Preview Publish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Copy live bucket tree to preview plane and refresh preview symlink.", "write_mode": null}, {"action": "hosting.site.edge_health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.edge_health", "related_tools": ["hosting.deploy_files", "hosting.release.promote", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Edge Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only edge probe — after publish, poll until edge_ready=true. When edge_ready=true the result is probe_kind=read_only, success=true, committed=false and has no mutation accepted flag. A hint hosti"}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.edge_health", "related_tools": ["hosting.deploy_files", "hosting.release.promote", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Edge Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only edge probe — after publish, poll until edge_ready=true. When edge_ready=true the result is probe_kind=read_only, success=true, committed=false and has no mutation accepted flag. A hint hosti"}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Read-only edge probe — after publish, poll until edge_ready=true. When edge_ready=true the result i…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.deploy_files", "hosting.release.promote", "hosting.project.status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_site_edge_health", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Check nginx edge readiness (symlinks, index.html) for a hosting bucket.", "title": "Check Edge Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}}, "when_to_use": "Read-only edge probe — after publish, poll until edge_ready=true. When edge_ready=true the result is probe_kind=read_only, success=true, committed=false and has no mutation accepted flag. A hint hosti", "write_mode": null}, {"action": "hosting.site.build", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not deploy_files dist/ when workspace + site.build.yaml exists — hosting.site.build publishes compile output.", "anti_patterns": ["Do not deploy_files dist/ when workspace + site.build.yaml exists — hosting.site.build publishes compile output.", "Dev-first: git push HEAD:dev → poll hosting.site.build_status → open --dev/ URL; then main or promote_branch target=prod.", "Default async=true: poll hosting.site.build_status in a later MCP execute (HOSTING_BATCH_POLL_SAFE).", "Do not bulk-copy live current/ via deploy_files for dev preview — use target=dev build or workspace import.", "After enqueue copy job_id — poll hosting.site.build_status only; do not re-pass bucket_name/target on poll."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.build", "mutation_risk": "low", "related_tools": ["hosting.workspace.init", "hosting.workspace.file.put", "hosting.site.build_status", "hosting.site.build_cancel", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Build", "when_blocked": {"async_required_for_vite": "node_vite builds must use async=true (default). Poll hosting.site.build_status — do not await vite inside a sync MCP execute (neural_bus / batch wall-clock).", "batch_semantic_anchor_required": "Default async=true still needs a batch anchor: options.execution_intent=direct, options.goal, or preflight.check. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor.", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "build_already_queued": "Poll hosting.site.build_status; a new dev push refreshes pending/running sources_sha", "build_cmd_failed": "Read error_tail and failed_cmd. Fix package.json/site.build.yaml in workspace (patch_plane=workspace). Land on dev: git push agentstack HEAD:dev or hosting.git.promote_branch ref=HEAD target=dev with git_push on patch. Poll hosting.site.build_status. Green dev preview → hosting.git.promote_branch ref=dev target=prod (not hosting.site.build target=prod as first go-live).", "build_cwd_missing": "site.build.yaml cwd is not in the journal. Fix the recipe, push dev, poll build_status.", "build_not_enqueued": "Worker-only role cannot enqueue — use AGENTSTACK_PROCESS_ROLE=all|api or async=false sync build", "build_timeout": "Raise build_timeout_seconds or shrink the step, push dev, poll hosting.site.build_status.", "bytes_exceeded": "Staged build output exceeds the byte cap. Shrink the dist, push dev, poll hosting.site.build_status.", "changelog_degraded": "Release published but public changelog.json was not refreshed (git read error, output size cap, or preserve-stale path). completed jobs expose changelog_degraded; when site.build.yaml sets changelog_strict=true the job fails with this code. hosting.git.log for the operator slice; fix journal or lower changelog_limit; rebuild with force=true.", "competence_blocked": "read_only competence_tier blocks mutations — set dev_operator on the session or use Storage Hub Sources UI (PTC hosting.workspace_build) for human publish", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "enqueue_lock_busy": "Retry hosting.site.build with the same project_id and bucket — the lock has no job_id yet. Do not poll hosting.site.build_status until enqueue returns job_id.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "git_argv_rejected": "Server git allowlist blocked a prod worktree step (often reset --hard HEAD after ensure_prod_worktree). Check system.version build_id/git_sha — stale image if fix missing. Until RebuildBackend ships hosting_git_sync reset allowlist: (1) hosting.site.build target=dev publish=true async=true, poll build_status; (2) hosting.release.list; (3) hosting.release.promote with release_uuid only (omit bucket_id on nano site ids); (4) hosting.site.edge_health. Do not loop promote_branch target=prod on the same error.", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "journal_context_missing": "Platform shell worker layout: monorepo siblings beside the journal (assert-journal-build-context.mjs). Set PLATFORM_BUILD_CONTEXT_ROOTS to the host checkout on api+worker, or run platform_shell_seed once. Tenant apps: prefer project 1 sdk/shared-ui git journals + .gitmodules symlink bind — not import_tree per app.", "journal_not_initialized": "Git journal missing under the bucket workspace — hosting.git.init before git push or site.build.", "journal_requires_push": "Catalog git_journal bucket — workspace SHA builds are disabled. Run hosting.git.init, push refs/heads/dev (preview), then main or promote_branch for prod.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "module_not_resolved": "error_tail names the missing import. Fix the journal resolve or dependency, push dev, poll hosting.site.build_status, test the --dev URL, then target=prod.", "npm_install_failed": "error_tail is the npm error. Fix the lockfile or sibling package, push dev, poll hosting.site.build_status. Promote with target=prod only after the preview completes.", "platform_shell_layout_missing": "site.build.yaml is the platform monorepo file but this bucket has no agentstack-unified-sdk tree. Delete that yaml and run hosting.workspace.init with profile static or node_vite. Do not import_tree the SDK into this bucket. Platform shell seed is ops-only; app SDK pins are .gitmodules.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen the key with apikeys.create preset user_full, or Device Code --scope-preset=full. Same denial on hosting.git.init, hosting.workspace.init, and hosting.site.build.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_build_in_progress": "Another site.build holds the bucket lock — poll hosting.site.build_status with job_id from enqueue or build_already_queued", "site_not_found": "hosting.project.status — confirm primary site before file ops", "submodule_link_missing": "App .gitmodules points at agentstack.tech git but projects/1/_sources/{sdk|shared-ui} is missing, empty, or vendor/ could not symlink. hosting.git.init bucket_name=sdk (and shared-ui if pinned), then seed once (ops setup_platform_git_library.py --library sdk, or git push to /api/git/1/sdk.git). Fix .gitmodules to https://agentstack.tech/api/git/1/sdk.git; package.json file:vendor/...; poll build_status. No worker git clone and no import_tree SDK into tenant buckets.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "workspace_sources_sha_truncated": "Source hash walks the whole tree. Bulk copy is hosting.workspace.import_tree, then hosting.site.build. hosting.deploy_files writes live bytes, not workspace sources."}, "when_to_use": "Compile bucket workspace/ (site.build.yaml) into a release. target=dev writes preview and /s/{pid}/{name}--dev/. target=prod moves current. Push refs/heads/dev to build the preview. Push refs/heads/ma"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "hosting", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.build", "mutation_risk": "low", "related_tools": ["hosting.workspace.init", "hosting.workspace.file.put", "hosting.site.build_status", "hosting.site.build_cancel", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Build", "when_blocked": {"async_required_for_vite": "node_vite builds must use async=true (default). Poll hosting.site.build_status — do not await vite inside a sync MCP execute (neural_bus / batch wall-clock).", "batch_semantic_anchor_required": "Default async=true still needs a batch anchor: options.execution_intent=direct, options.goal, or preflight.check. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor.", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "build_already_queued": "Poll hosting.site.build_status; a new dev push refreshes pending/running sources_sha", "build_cmd_failed": "Read error_tail and failed_cmd. Fix package.json/site.build.yaml in workspace (patch_plane=workspace). Land on dev: git push agentstack HEAD:dev or hosting.git.promote_branch ref=HEAD target=dev with git_push on patch. Poll hosting.site.build_status. Green dev preview → hosting.git.promote_branch ref=dev target=prod (not hosting.site.build target=prod as first go-live).", "build_cwd_missing": "site.build.yaml cwd is not in the journal. Fix the recipe, push dev, poll build_status.", "build_not_enqueued": "Worker-only role cannot enqueue — use AGENTSTACK_PROCESS_ROLE=all|api or async=false sync build", "build_timeout": "Raise build_timeout_seconds or shrink the step, push dev, poll hosting.site.build_status.", "bytes_exceeded": "Staged build output exceeds the byte cap. Shrink the dist, push dev, poll hosting.site.build_status.", "changelog_degraded": "Release published but public changelog.json was not refreshed (git read error, output size cap, or preserve-stale path). completed jobs expose changelog_degraded; when site.build.yaml sets changelog_strict=true the job fails with this code. hosting.git.log for the operator slice; fix journal or lower changelog_limit; rebuild with force=true.", "competence_blocked": "read_only competence_tier blocks mutations — set dev_operator on the session or use Storage Hub Sources UI (PTC hosting.workspace_build) for human publish", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "enqueue_lock_busy": "Retry hosting.site.build with the same project_id and bucket — the lock has no job_id yet. Do not poll hosting.site.build_status until enqueue returns job_id.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "git_argv_rejected": "Server git allowlist blocked a prod worktree step (often reset --hard HEAD after ensure_prod_worktree). Check system.version build_id/git_sha — stale image if fix missing. Until RebuildBackend ships hosting_git_sync reset allowlist: (1) hosting.site.build target=dev publish=true async=true, poll build_status; (2) hosting.release.list; (3) hosting.release.promote with release_uuid only (omit bucket_id on nano site ids); (4) hosting.site.edge_health. Do not loop promote_branch target=prod on the same error.", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "journal_context_missing": "Platform shell worker layout: monorepo siblings beside the journal (assert-journal-build-context.mjs). Set PLATFORM_BUILD_CONTEXT_ROOTS to the host checkout on api+worker, or run platform_shell_seed once. Tenant apps: prefer project 1 sdk/shared-ui git journals + .gitmodules symlink bind — not import_tree per app.", "journal_not_initialized": "Git journal missing under the bucket workspace — hosting.git.init before git push or site.build.", "journal_requires_push": "Catalog git_journal bucket — workspace SHA builds are disabled. Run hosting.git.init, push refs/heads/dev (preview), then main or promote_branch for prod.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "module_not_resolved": "error_tail names the missing import. Fix the journal resolve or dependency, push dev, poll hosting.site.build_status, test the --dev URL, then target=prod.", "npm_install_failed": "error_tail is the npm error. Fix the lockfile or sibling package, push dev, poll hosting.site.build_status. Promote with target=prod only after the preview completes.", "platform_shell_layout_missing": "site.build.yaml is the platform monorepo file but this bucket has no agentstack-unified-sdk tree. Delete that yaml and run hosting.workspace.init with profile static or node_vite. Do not import_tree the SDK into this bucket. Platform shell seed is ops-only; app SDK pins are .gitmodules.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen the key with apikeys.create preset user_full, or Device Code --scope-preset=full. Same denial on hosting.git.init, hosting.workspace.init, and hosting.site.build.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_build_in_progress": "Another site.build holds the bucket lock — poll hosting.site.build_status with job_id from enqueue or build_already_queued", "site_not_found": "hosting.project.status — confirm primary site before file ops", "submodule_link_missing": "App .gitmodules points at agentstack.tech git but projects/1/_sources/{sdk|shared-ui} is missing, empty, or vendor/ could not symlink. hosting.git.init bucket_name=sdk (and shared-ui if pinned), then seed once (ops setup_platform_git_library.py --library sdk, or git push to /api/git/1/sdk.git). Fix .gitmodules to https://agentstack.tech/api/git/1/sdk.git; package.json file:vendor/...; poll build_status. No worker git clone and no import_tree SDK into tenant buckets.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "workspace_sources_sha_truncated": "Source hash walks the whole tree. Bulk copy is hosting.workspace.import_tree, then hosting.site.build. hosting.deploy_files writes live bytes, not workspace sources."}, "when_to_use": "Compile bucket workspace/ (site.build.yaml) into a release. target=dev writes preview and /s/{pid}/{name}--dev/. target=prod moves current. Push refs/heads/dev to build the preview. Push refs/heads/ma"}, "do_not_use_when": "Push to dev expecting preview without git — use git push dev or hosting.site.build target=dev. Do not use target=prod before dev preview is verified.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"conditional_mutate": "Always mutates on success (async=true enqueues — poll hosting.site.build_status; async=false runs sync compile in the request). Scheduling mode is not read-class.", "execution_class": "cheap", "kind": "mutate", "mutates_when": "always", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Enqueue dev preview", "request": {"params": {"bucket_name": "frontend", "project_id": 1, "publish": true, "target": "dev"}, "tool": "hosting.site.build"}}, {"name": "Go live after green dev preview", "request": {"params": {"bucket_name": "frontend", "project_id": 1, "publish": true, "ref": "dev", "target": "prod"}, "tool": "hosting.git.promote_branch"}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_BATCH_SEMANTIC_ANCHOR": "Sync hosting mutations need a batch anchor: options.execution_intent=direct, options.goal, or preflight.check in the same execute. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor. Poll hosting.site.build_status in a separate execute — one job_id per poll loop; honor poll_backoff_ms; stop when status is completed|failed|cancelled or on job_not_found (re-list via hosting.project.status then hosting.site.build).", "HOSTING_BUILD_PROOF_SIDECARS": "After hosting.site.build publish, live/preview trees expose build-id.txt and sources-sha.txt for edge probes, plus changelog.json (JSON Feed) and changelog.html when git projection succeeds. hosting.workspace.meta sources_sha is the workspace hash before build — sidecars update after publish. Do not hand-PUT sidecars; rebuild or ensure_proof_tree_provenance on ops paths.", "HOSTING_COPYTREE_ANTIPATTERN": "Do not hosting.deploy_files an entire compiled SPA into preview/dev. Use hosting.site.build target=dev, hosting.workspace.import_tree, or ops seed_dev_preview_minimal — never bulk-copy live current/ as deploy_files. Symlink fallback on disk copies public live root only (not releases/).", "HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_MCP_AUTH_FOR_MUTATIONS": "hosting.* writes need session_ready + can_execute_mutation + service caps (user_full / Connect OAuth). service_cap_denied on hosting.workspace.init: widen API key (apikeys.create preset user_full) or Device Code --scope-preset=full — same recovery as other MCP mutations. VPS SSH scripts are ops fallback only; agents should use MCP with context.project_id on every execute. CLI bridge: node provided_plugins/cursor-plugin/scripts/mcp-execute.mjs --project-id <pid> --execution-intent direct <action> --params '{...}' (avoids batch_semantic_anchor_required).", "HOSTING_SUBMODULE_LINK_MISSING": "App .gitmodules URL https://agentstack.tech/api/git/1/sdk.git (or shared-ui) must resolve to projects/1/_sources/{bucket} on the worker. One-time: hosting.git.init project_id=1 bucket_name=sdk and shared-ui (or ops setup_platform_git_library.py). The build symlinks vendor/ — no import_tree or git submodule update on the worker. Fix .gitmodules paths, push HEAD:dev, poll build_status.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": [{"action": "hosting.site.build_status", "params": {"job_id": "<from enqueue>"}, "why": "Poll until completed or failed. job_id only — project_id not required on poll."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "pending_state": "Default async=true enqueues a job — success is not final until hosting.site.build_status reports completed or failed. Poll in a later MCP execute (see HOSTING_BATCH_POLL_SAFE).", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.workspace.init", "hosting.workspace.file.put", "hosting.site.build_status", "hosting.site.build_cancel", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_site_build", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Run site.build.yaml in bucket workspace into staging; default async. target=dev → preview /s/{project_id}/{bucket}--dev/. target=prod rebuilds main only — after green dev use hosting.git.promote_branc", "title": "Hosting Site Build", "verification": "job_id from enqueue → hosting.site.build_status (one job_id per poll execute).", "when_blocked": {"async_required_for_vite": "node_vite builds must use async=true (default). Poll hosting.site.build_status — do not await vite inside a sync MCP execute (neural_bus / batch wall-clock).", "batch_semantic_anchor_required": "Default async=true still needs a batch anchor: options.execution_intent=direct, options.goal, or preflight.check. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor.", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "build_already_queued": "Poll hosting.site.build_status; a new dev push refreshes pending/running sources_sha", "build_cmd_failed": "Read error_tail and failed_cmd. Fix package.json/site.build.yaml in workspace (patch_plane=workspace). Land on dev: git push agentstack HEAD:dev or hosting.git.promote_branch ref=HEAD target=dev with git_push on patch. Poll hosting.site.build_status. Green dev preview → hosting.git.promote_branch ref=dev target=prod (not hosting.site.build target=prod as first go-live).", "build_cwd_missing": "site.build.yaml cwd is not in the journal. Fix the recipe, push dev, poll build_status.", "build_not_enqueued": "Worker-only role cannot enqueue — use AGENTSTACK_PROCESS_ROLE=all|api or async=false sync build", "build_timeout": "Raise build_timeout_seconds or shrink the step, push dev, poll hosting.site.build_status.", "bytes_exceeded": "Staged build output exceeds the byte cap. Shrink the dist, push dev, poll hosting.site.build_status.", "changelog_degraded": "Release published but public changelog.json was not refreshed (git read error, output size cap, or preserve-stale path). completed jobs expose changelog_degraded; when site.build.yaml sets changelog_strict=true the job fails with this code. hosting.git.log for the operator slice; fix journal or lower changelog_limit; rebuild with force=true.", "competence_blocked": "read_only competence_tier blocks mutations — set dev_operator on the session or use Storage Hub Sources UI (PTC hosting.workspace_build) for human publish", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "enqueue_lock_busy": "Retry hosting.site.build with the same project_id and bucket — the lock has no job_id yet. Do not poll hosting.site.build_status until enqueue returns job_id.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "git_argv_rejected": "Server git allowlist blocked a prod worktree step (often reset --hard HEAD after ensure_prod_worktree). Check system.version build_id/git_sha — stale image if fix missing. Until RebuildBackend ships hosting_git_sync reset allowlist: (1) hosting.site.build target=dev publish=true async=true, poll build_status; (2) hosting.release.list; (3) hosting.release.promote with release_uuid only (omit bucket_id on nano site ids); (4) hosting.site.edge_health. Do not loop promote_branch target=prod on the same error.", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "journal_context_missing": "Platform shell worker layout: monorepo siblings beside the journal (assert-journal-build-context.mjs). Set PLATFORM_BUILD_CONTEXT_ROOTS to the host checkout on api+worker, or run platform_shell_seed once. Tenant apps: prefer project 1 sdk/shared-ui git journals + .gitmodules symlink bind — not import_tree per app.", "journal_not_initialized": "Git journal missing under the bucket workspace — hosting.git.init before git push or site.build.", "journal_requires_push": "Catalog git_journal bucket — workspace SHA builds are disabled. Run hosting.git.init, push refs/heads/dev (preview), then main or promote_branch for prod.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "module_not_resolved": "error_tail names the missing import. Fix the journal resolve or dependency, push dev, poll hosting.site.build_status, test the --dev URL, then target=prod.", "npm_install_failed": "error_tail is the npm error. Fix the lockfile or sibling package, push dev, poll hosting.site.build_status. Promote with target=prod only after the preview completes.", "platform_shell_layout_missing": "site.build.yaml is the platform monorepo file but this bucket has no agentstack-unified-sdk tree. Delete that yaml and run hosting.workspace.init with profile static or node_vite. Do not import_tree the SDK into this bucket. Platform shell seed is ops-only; app SDK pins are .gitmodules.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen the key with apikeys.create preset user_full, or Device Code --scope-preset=full. Same denial on hosting.git.init, hosting.workspace.init, and hosting.site.build.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_build_in_progress": "Another site.build holds the bucket lock — poll hosting.site.build_status with job_id from enqueue or build_already_queued", "site_not_found": "hosting.project.status — confirm primary site before file ops", "submodule_link_missing": "App .gitmodules points at agentstack.tech git but projects/1/_sources/{sdk|shared-ui} is missing, empty, or vendor/ could not symlink. hosting.git.init bucket_name=sdk (and shared-ui if pinned), then seed once (ops setup_platform_git_library.py --library sdk, or git push to /api/git/1/sdk.git). Fix .gitmodules to https://agentstack.tech/api/git/1/sdk.git; package.json file:vendor/...; poll build_status. No worker git clone and no import_tree SDK into tenant buckets.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "workspace_sources_sha_truncated": "Source hash walks the whole tree. Bulk copy is hosting.workspace.import_tree, then hosting.site.build. hosting.deploy_files writes live bytes, not workspace sources."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}}, "when_not_to_use": "Push to dev expecting preview without git — use git push dev or hosting.site.build target=dev. Do not use target=prod before dev preview is verified.", "when_to_use": "Compile bucket workspace/ (site.build.yaml) into a release. target=dev writes preview and /s/{pid}/{name}--dev/. target=prod moves current. Push refs/heads/dev to build the preview. Push refs/heads/ma", "write_mode": null}, {"action": "hosting.site.build_status", "aliases": ["hosting.build.status", "hosting.site.build.poll", "hosting.site.build.status"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Poll only — not a build trigger. Re-enqueue via hosting.site.build when job failed or stale.", "anti_patterns": ["Poll only — not a build trigger. Re-enqueue via hosting.site.build when job failed or stale.", "Params are job_id only — do not pass bucket_name, target, publish, or force from hosting.site.build.", "Aliases hosting.site.build.status / hosting.build.status share the same poll schema."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.build_status", "related_tools": ["hosting.site.build", "hosting.site.build_cancel", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Build Status", "when_blocked": {"build_cmd_failed": "Read error_tail and failed_cmd. Fix package.json/site.build.yaml in workspace (patch_plane=workspace). Land on dev: git push agentstack HEAD:dev or hosting.git.promote_branch ref=HEAD target=dev with git_push on patch. Poll hosting.site.build_status. Green dev preview → hosting.git.promote_branch ref=dev target=prod (not hosting.site.build target=prod as first go-live).", "build_cwd_missing": "site.build.yaml cwd is not in the journal. Fix the recipe, push dev, poll build_status.", "build_job_stale_running": "Worker died mid-build — job failed automatically. Re-run hosting.site.build with force=true or push dev again after fixing workspace.", "build_timeout": "Raise build_timeout_seconds or shrink the step, push dev, poll hosting.site.build_status.", "bytes_exceeded": "Staged build output exceeds the byte cap. Shrink the dist, push dev, poll hosting.site.build_status.", "changelog_degraded": "Release published but public changelog.json was not refreshed (git read error, output size cap, or preserve-stale path). completed jobs expose changelog_degraded; when site.build.yaml sets changelog_strict=true the job fails with this code. hosting.git.log for the operator slice; fix journal or lower changelog_limit; rebuild with force=true.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "job_id_required": "Missing job_id — run hosting.site.build first and poll with the returned job_id.", "job_lost_after_restart": "Job file is gone after restart — do not poll the same id. hosting.project.status → hosting.site.build (new enqueue) → poll the new job_id only.", "job_not_found": "Unknown or expired job_id — do not poll the same id for minutes. hosting.project.status → hosting.site.build (new enqueue) → poll the new job_id only.", "journal_context_missing": "Platform shell worker layout: monorepo siblings beside the journal (assert-journal-build-context.mjs). Set PLATFORM_BUILD_CONTEXT_ROOTS to the host checkout on api+worker, or run platform_shell_seed once. Tenant apps: prefer project 1 sdk/shared-ui git journals + .gitmodules symlink bind — not import_tree per app.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "module_not_resolved": "error_tail names the missing import. Fix the journal resolve or dependency, push dev, poll hosting.site.build_status, test the --dev URL, then target=prod.", "npm_install_failed": "error_tail is the npm error. Fix the lockfile or sibling package, push dev, poll hosting.site.build_status. Promote with target=prod only after the preview completes.", "platform_shell_layout_missing": "site.build.yaml is the platform monorepo file but this bucket has no agentstack-unified-sdk tree. Delete that yaml and run hosting.workspace.init with profile static or node_vite. Do not import_tree the SDK into this bucket. Platform shell seed is ops-only; app SDK pins are .gitmodules.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "submodule_link_missing": "App .gitmodules points at agentstack.tech git but projects/1/_sources/{sdk|shared-ui} is missing, empty, or vendor/ could not symlink. hosting.git.init bucket_name=sdk (and shared-ui if pinned), then seed once (ops setup_platform_git_library.py --library sdk, or git push to /api/git/1/sdk.git). Fix .gitmodules to https://agentstack.tech/api/git/1/sdk.git; package.json file:vendor/...; poll build_status. No worker git clone and no import_tree SDK into tenant buckets.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "hosting.site.build_status accepts job_id only — not bucket_name, target, or project_id. Copy job_id from hosting.site.build (or build_already_queued) enqueue response; re-enqueue with hosting.site.build when you need a new build."}, "when_to_use": "Poll hosting.site.build when async=true (default). job_id from the enqueue response. On failed: job.error_code maps to when_blocked — platform_shell_layout_missing → delete site.build.yaml and hosting"}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.build_status", "related_tools": ["hosting.site.build", "hosting.site.build_cancel", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Build Status", "when_blocked": {"build_cmd_failed": "Read error_tail and failed_cmd. Fix package.json/site.build.yaml in workspace (patch_plane=workspace). Land on dev: git push agentstack HEAD:dev or hosting.git.promote_branch ref=HEAD target=dev with git_push on patch. Poll hosting.site.build_status. Green dev preview → hosting.git.promote_branch ref=dev target=prod (not hosting.site.build target=prod as first go-live).", "build_cwd_missing": "site.build.yaml cwd is not in the journal. Fix the recipe, push dev, poll build_status.", "build_job_stale_running": "Worker died mid-build — job failed automatically. Re-run hosting.site.build with force=true or push dev again after fixing workspace.", "build_timeout": "Raise build_timeout_seconds or shrink the step, push dev, poll hosting.site.build_status.", "bytes_exceeded": "Staged build output exceeds the byte cap. Shrink the dist, push dev, poll hosting.site.build_status.", "changelog_degraded": "Release published but public changelog.json was not refreshed (git read error, output size cap, or preserve-stale path). completed jobs expose changelog_degraded; when site.build.yaml sets changelog_strict=true the job fails with this code. hosting.git.log for the operator slice; fix journal or lower changelog_limit; rebuild with force=true.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "job_id_required": "Missing job_id — run hosting.site.build first and poll with the returned job_id.", "job_lost_after_restart": "Job file is gone after restart — do not poll the same id. hosting.project.status → hosting.site.build (new enqueue) → poll the new job_id only.", "job_not_found": "Unknown or expired job_id — do not poll the same id for minutes. hosting.project.status → hosting.site.build (new enqueue) → poll the new job_id only.", "journal_context_missing": "Platform shell worker layout: monorepo siblings beside the journal (assert-journal-build-context.mjs). Set PLATFORM_BUILD_CONTEXT_ROOTS to the host checkout on api+worker, or run platform_shell_seed once. Tenant apps: prefer project 1 sdk/shared-ui git journals + .gitmodules symlink bind — not import_tree per app.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "module_not_resolved": "error_tail names the missing import. Fix the journal resolve or dependency, push dev, poll hosting.site.build_status, test the --dev URL, then target=prod.", "npm_install_failed": "error_tail is the npm error. Fix the lockfile or sibling package, push dev, poll hosting.site.build_status. Promote with target=prod only after the preview completes.", "platform_shell_layout_missing": "site.build.yaml is the platform monorepo file but this bucket has no agentstack-unified-sdk tree. Delete that yaml and run hosting.workspace.init with profile static or node_vite. Do not import_tree the SDK into this bucket. Platform shell seed is ops-only; app SDK pins are .gitmodules.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "submodule_link_missing": "App .gitmodules points at agentstack.tech git but projects/1/_sources/{sdk|shared-ui} is missing, empty, or vendor/ could not symlink. hosting.git.init bucket_name=sdk (and shared-ui if pinned), then seed once (ops setup_platform_git_library.py --library sdk, or git push to /api/git/1/sdk.git). Fix .gitmodules to https://agentstack.tech/api/git/1/sdk.git; package.json file:vendor/...; poll build_status. No worker git clone and no import_tree SDK into tenant buckets.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "hosting.site.build_status accepts job_id only — not bucket_name, target, or project_id. Copy job_id from hosting.site.build (or build_already_queued) enqueue response; re-enqueue with hosting.site.build when you need a new build."}, "when_to_use": "Poll hosting.site.build when async=true (default). job_id from the enqueue response. On failed: job.error_code maps to when_blocked — platform_shell_layout_missing → delete site.build.yaml and hosting"}, "do_not_use_when": "Enqueue or change target — use hosting.site.build with bucket_name + target; status is poll-only with job_id from enqueue.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Poll build job", "request": {"params": {"job_id": "00000000-0000-0000-0000-000000000000"}, "tool": "hosting.site.build_status"}}, {"name": "Running job response", "response": {"job": {"job_id": "…", "status": "running", "target": "dev"}, "ok": true, "verification_action": "hosting.site.build_status"}}, {"name": "Failed gate response", "response": {"error_code": "hosting_gate_failed", "job": {"error": "hosting_gate_failed:missing_index_html", "error_code": "hosting_gate_failed", "status": "failed"}, "ok": true}}], "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_BUILD_PROOF_SIDECARS": "After hosting.site.build publish, live/preview trees expose build-id.txt and sources-sha.txt for edge probes, plus changelog.json (JSON Feed) and changelog.html when git projection succeeds. hosting.workspace.meta sources_sha is the workspace hash before build — sidecars update after publish. Do not hand-PUT sidecars; rebuild or ensure_proof_tree_provenance on ops paths.", "HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_SUBMODULE_LINK_MISSING": "App .gitmodules URL https://agentstack.tech/api/git/1/sdk.git (or shared-ui) must resolve to projects/1/_sources/{bucket} on the worker. One-time: hosting.git.init project_id=1 bucket_name=sdk and shared-ui (or ops setup_platform_git_library.py). The build symlinks vendor/ — no import_tree or git submodule update on the worker. Fix .gitmodules paths, push HEAD:dev, poll build_status.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": [{"action": "hosting.site.build_status", "params": {"job_id": "<from enqueue>"}, "why": "Poll until completed or failed."}, {"action": "hosting.git.promote_branch", "params": {"bucket_name": "<from prior result>", "project_id": "<context.project_id>", "ref": "dev", "target": "prod"}, "why": "After dev job=completed: open /s/{project_id}/{bucket_name}--dev/ then promote to prod."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.site.build", "hosting.site.build_cancel", "hosting.site.edge_health"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_site_build_status", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Poll async hosting.site.build job by job_id.", "title": "Hosting Site Build Status", "verification": "Terminal: completed → check changelog_degraded / changelog_skip_reason on poll body; optional hosting.site.edge_health; failed → error_code → HOSTING_WHEN_BLOCKED ladder; re-enqueue via hosting.site.build.", "when_blocked": {"build_cmd_failed": "Read error_tail and failed_cmd. Fix package.json/site.build.yaml in workspace (patch_plane=workspace). Land on dev: git push agentstack HEAD:dev or hosting.git.promote_branch ref=HEAD target=dev with git_push on patch. Poll hosting.site.build_status. Green dev preview → hosting.git.promote_branch ref=dev target=prod (not hosting.site.build target=prod as first go-live).", "build_cwd_missing": "site.build.yaml cwd is not in the journal. Fix the recipe, push dev, poll build_status.", "build_job_stale_running": "Worker died mid-build — job failed automatically. Re-run hosting.site.build with force=true or push dev again after fixing workspace.", "build_timeout": "Raise build_timeout_seconds or shrink the step, push dev, poll hosting.site.build_status.", "bytes_exceeded": "Staged build output exceeds the byte cap. Shrink the dist, push dev, poll hosting.site.build_status.", "changelog_degraded": "Release published but public changelog.json was not refreshed (git read error, output size cap, or preserve-stale path). completed jobs expose changelog_degraded; when site.build.yaml sets changelog_strict=true the job fails with this code. hosting.git.log for the operator slice; fix journal or lower changelog_limit; rebuild with force=true.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "job_id_required": "Missing job_id — run hosting.site.build first and poll with the returned job_id.", "job_lost_after_restart": "Job file is gone after restart — do not poll the same id. hosting.project.status → hosting.site.build (new enqueue) → poll the new job_id only.", "job_not_found": "Unknown or expired job_id — do not poll the same id for minutes. hosting.project.status → hosting.site.build (new enqueue) → poll the new job_id only.", "journal_context_missing": "Platform shell worker layout: monorepo siblings beside the journal (assert-journal-build-context.mjs). Set PLATFORM_BUILD_CONTEXT_ROOTS to the host checkout on api+worker, or run platform_shell_seed once. Tenant apps: prefer project 1 sdk/shared-ui git journals + .gitmodules symlink bind — not import_tree per app.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "module_not_resolved": "error_tail names the missing import. Fix the journal resolve or dependency, push dev, poll hosting.site.build_status, test the --dev URL, then target=prod.", "npm_install_failed": "error_tail is the npm error. Fix the lockfile or sibling package, push dev, poll hosting.site.build_status. Promote with target=prod only after the preview completes.", "platform_shell_layout_missing": "site.build.yaml is the platform monorepo file but this bucket has no agentstack-unified-sdk tree. Delete that yaml and run hosting.workspace.init with profile static or node_vite. Do not import_tree the SDK into this bucket. Platform shell seed is ops-only; app SDK pins are .gitmodules.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "submodule_link_missing": "App .gitmodules points at agentstack.tech git but projects/1/_sources/{sdk|shared-ui} is missing, empty, or vendor/ could not symlink. hosting.git.init bucket_name=sdk (and shared-ui if pinned), then seed once (ops setup_platform_git_library.py --library sdk, or git push to /api/git/1/sdk.git). Fix .gitmodules to https://agentstack.tech/api/git/1/sdk.git; package.json file:vendor/...; poll build_status. No worker git clone and no import_tree SDK into tenant buckets.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "hosting.site.build_status accepts job_id only — not bucket_name, target, or project_id. Copy job_id from hosting.site.build (or build_already_queued) enqueue response; re-enqueue with hosting.site.build when you need a new build."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}, "validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_not_to_use": "Enqueue or change target — use hosting.site.build with bucket_name + target; status is poll-only with job_id from enqueue.", "when_to_use": "Poll hosting.site.build when async=true (default). job_id from the enqueue response. On failed: job.error_code maps to when_blocked — platform_shell_layout_missing → delete site.build.yaml and hosting", "write_mode": null}, {"action": "hosting.site.build_cancel", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.build_cancel", "mutation_risk": "high", "related_tools": ["hosting.site.build_status", "hosting.site.build", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Build Cancel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "job_id_required": "Pass job_id from hosting.site.build enqueue response", "job_not_found": "Unknown or expired job_id — do not poll the same id for minutes. hosting.project.status → hosting.site.build (new enqueue) → poll the new job_id only.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_cancellable": "Job already terminal — poll hosting.site.build_status; enqueue a new hosting.site.build with force after a successful cancel of pending|running only.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cancel a pending or running async build using job_id from hosting.site.build_status. Does not revert a completed release — use hosting.release.promote rollback when live is wrong."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.build_cancel", "mutation_risk": "high", "related_tools": ["hosting.site.build_status", "hosting.site.build", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Build Cancel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "job_id_required": "Pass job_id from hosting.site.build enqueue response", "job_not_found": "Unknown or expired job_id — do not poll the same id for minutes. hosting.project.status → hosting.site.build (new enqueue) → poll the new job_id only.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_cancellable": "Job already terminal — poll hosting.site.build_status; enqueue a new hosting.site.build with force after a successful cancel of pending|running only.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cancel a pending or running async build using job_id from hosting.site.build_status. Does not revert a completed release — use hosting.release.promote rollback when live is wrong."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Cancels pending or running build for bucket target (dev|prod). No-op when job already terminal.", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Cancel a pending or running async build using job_id from hosting.site.build_status. Does not rever…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.site.build_status", "hosting.site.build", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "hosting_site_build_cancel", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Cancel a pending or running hosting.site.build job.", "title": "Hosting Site Build Cancel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "job_id_required": "Pass job_id from hosting.site.build enqueue response", "job_not_found": "Unknown or expired job_id — do not poll the same id for minutes. hosting.project.status → hosting.site.build (new enqueue) → poll the new job_id only.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_cancellable": "Job already terminal — poll hosting.site.build_status; enqueue a new hosting.site.build with force after a successful cancel of pending|running only.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Cancel a pending or running async build using job_id from hosting.site.build_status. Does not revert a completed release — use hosting.release.promote rollback when live is wrong.", "write_mode": null}, {"action": "hosting.git.migrate", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.migrate", "mutates_when": {"dry_run": false}, "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Migrate", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "git_repo_missing": "Existing bucket: hosting.git.init with bucket_name or bucket_id. hosting.site.quick_start only when hosting.project.status shows no site.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Repair AgentGit journal/worktree/hooks for legacy buckets. dry_run=true lists steps only; dry_run=false refreshes hooks and may rewrite post-receive when project_id and bucket_id are set."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.migrate", "mutates_when": {"dry_run": false}, "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Migrate", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "git_repo_missing": "Existing bucket: hosting.git.init with bucket_name or bucket_id. hosting.site.quick_start only when hosting.project.status shows no site.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Repair AgentGit journal/worktree/hooks for legacy buckets. dry_run=true lists steps only; dry_run=false refreshes hooks and may rewrite post-receive when project_id and bucket_id are set."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true returns planned adopt/migrate steps only; dry_run=false rewrites workspace git layout and protected sources binding", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Repair AgentGit journal/worktree/hooks for legacy buckets. dry_run=true lists steps only; dry_run=f…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "hosting_git_migrate", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Repair AgentGit journal/worktree/hooks for legacy hosting buckets.", "title": "Hosting Git Migrate", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "git_repo_missing": "Existing bucket: hosting.git.init with bucket_name or bucket_id. hosting.site.quick_start only when hosting.project.status shows no site.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Repair AgentGit journal/worktree/hooks for legacy buckets. dry_run=true lists steps only; dry_run=false refreshes hooks and may rewrite post-receive when project_id and bucket_id are set.", "write_mode": null}, {"action": "hosting.workspace.init", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.init", "mutation_risk": "low", "related_tools": ["hosting.workspace.file.put", "hosting.site.build", "hosting.workspace.meta"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace Init", "when_blocked": {"batch_semantic_anchor_required": "Default async=true still needs a batch anchor: options.execution_intent=direct, options.goal, or preflight.check. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor.", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen the key with apikeys.create preset user_full, or Device Code --scope-preset=full. Same denial on hosting.git.init, hosting.workspace.init, and hosting.site.build.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create workspace/site.build.yaml beside releases/current for any project bucket. Then hosting.workspace.file.put and hosting.site.build."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.init", "mutation_risk": "low", "related_tools": ["hosting.workspace.file.put", "hosting.site.build", "hosting.workspace.meta"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace Init", "when_blocked": {"batch_semantic_anchor_required": "Default async=true still needs a batch anchor: options.execution_intent=direct, options.goal, or preflight.check. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor.", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen the key with apikeys.create preset user_full, or Device Code --scope-preset=full. Same denial on hosting.git.init, hosting.workspace.init, and hosting.site.build.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create workspace/site.build.yaml beside releases/current for any project bucket. Then hosting.workspace.file.put and hosting.site.build."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Greenfield React journal", "request": {"params": {"bucket_name": "frontend", "profile": "node_vite", "project_id": 1}, "tool": "hosting.workspace.init"}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_BATCH_SEMANTIC_ANCHOR": "Sync hosting mutations need a batch anchor: options.execution_intent=direct, options.goal, or preflight.check in the same execute. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor. Poll hosting.site.build_status in a separate execute — one job_id per poll loop; honor poll_backoff_ms; stop when status is completed|failed|cancelled or on job_not_found (re-list via hosting.project.status then hosting.site.build).", "HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_MCP_AUTH_FOR_MUTATIONS": "hosting.* writes need session_ready + can_execute_mutation + service caps (user_full / Connect OAuth). service_cap_denied on hosting.workspace.init: widen API key (apikeys.create preset user_full) or Device Code --scope-preset=full — same recovery as other MCP mutations. VPS SSH scripts are ops fallback only; agents should use MCP with context.project_id on every execute. CLI bridge: node provided_plugins/cursor-plugin/scripts/mcp-execute.mjs --project-id <pid> --execution-intent direct <action> --params '{...}' (avoids batch_semantic_anchor_required).", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.workspace.file.put", "hosting.site.build", "hosting.workspace.meta"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_workspace_init", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Prepare bucket workspace/ (the tree hosting.site.build compiles). seed_from_live copies live only when index.html is absent. mirror_from_live overwrites workspace copies from the live site so a later ", "title": "Hosting Workspace Init", "when_blocked": {"batch_semantic_anchor_required": "Default async=true still needs a batch anchor: options.execution_intent=direct, options.goal, or preflight.check. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor.", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen the key with apikeys.create preset user_full, or Device Code --scope-preset=full. Same denial on hosting.git.init, hosting.workspace.init, and hosting.site.build.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}}, "when_to_use": "Create workspace/site.build.yaml beside releases/current for any project bucket. Then hosting.workspace.file.put and hosting.site.build.", "write_mode": null}, {"action": "hosting.workspace.meta", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.meta", "related_tools": ["hosting.workspace.init", "hosting.workspace.files.list", "hosting.site.build", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace Meta", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Light read for one bucket — workspace_initialized, sources_sha, operator_ssh_workspace_root. Prefer over hosting.project.status with include_workspace_meta when UI only needs one site."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.meta", "related_tools": ["hosting.workspace.init", "hosting.workspace.files.list", "hosting.site.build", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace Meta", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Light read for one bucket — workspace_initialized, sources_sha, operator_ssh_workspace_root. Prefer over hosting.project.status with include_workspace_meta when UI only needs one site."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Light read for one bucket — workspace_initialized, sources_sha, operator_ssh_workspace_root. Prefer…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.workspace.init", "hosting.workspace.files.list", "hosting.site.build", "hosting.project.status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_workspace_meta", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Per-bucket workspace init flag and sources_sha (no full project.status scan).", "title": "Hosting Workspace Meta", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Light read for one bucket — workspace_initialized, sources_sha, operator_ssh_workspace_root. Prefer over hosting.project.status with include_workspace_meta when UI only needs one site.", "write_mode": null}, {"action": "hosting.workspace.files.list", "aliases": ["hosting.workspace.file.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.files.list", "related_tools": ["hosting.workspace.file.get", "hosting.workspace.file.put"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace Files List", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List source paths under bucket workspace/ (not the live current tree)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.files.list", "related_tools": ["hosting.workspace.file.get", "hosting.workspace.file.put"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace Files List", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List source paths under bucket workspace/ (not the live current tree)."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "List source paths under bucket workspace/ (not the live current tree).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.workspace.file.get", "hosting.workspace.file.put"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_workspace_files_list", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "List source files in bucket workspace/ (not the live current tree).", "title": "Hosting Workspace Files List", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "List source paths under bucket workspace/ (not the live current tree).", "write_mode": null}, {"action": "hosting.workspace.file.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.file.get", "related_tools": ["hosting.workspace.file.put", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace File Get", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "path_required": "Pass path relative to workspace/ — hosting.workspace.files.list to discover paths", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "workspace_file_missing": "File absent in workspace/ — hosting.workspace.init or seed_from_live", "workspace_path_escape": "Path escapes workspace root — use a relative path under workspace/", "workspace_path_invalid": "Path must be relative under workspace/ without .. segments"}, "when_to_use": "Read a source file in workspace/ before editing. Live served bytes are hosting.bucket.file.get."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.file.get", "related_tools": ["hosting.workspace.file.put", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace File Get", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "path_required": "Pass path relative to workspace/ — hosting.workspace.files.list to discover paths", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "workspace_file_missing": "File absent in workspace/ — hosting.workspace.init or seed_from_live", "workspace_path_escape": "Path escapes workspace root — use a relative path under workspace/", "workspace_path_invalid": "Path must be relative under workspace/ without .. segments"}, "when_to_use": "Read a source file in workspace/ before editing. Live served bytes are hosting.bucket.file.get."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Read a source file in workspace/ before editing. Live served bytes are hosting.bucket.file.get.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.workspace.file.put", "hosting.site.build"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_workspace_file_get", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Read a source file from bucket workspace/ (edit tree, not live /s/).", "title": "Hosting Workspace File Get", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "path_required": "Pass path relative to workspace/ — hosting.workspace.files.list to discover paths", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "workspace_file_missing": "File absent in workspace/ — hosting.workspace.init or seed_from_live", "workspace_path_escape": "Path escapes workspace root — use a relative path under workspace/", "workspace_path_invalid": "Path must be relative under workspace/ without .. segments"}, "when_blocked_locales": {}, "when_to_use": "Read a source file in workspace/ before editing. Live served bytes are hosting.bucket.file.get.", "write_mode": null}, {"action": "hosting.workspace.file.put", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.file.put", "mutation_risk": "low", "related_tools": ["hosting.workspace.files.list", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace File Put", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "content_required": "Pass UTF-8 content or content_base64 for workspace writes — hosting.workspace.file.get before full replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "path_required": "Pass path relative to workspace/ — hosting.workspace.files.list to discover paths", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "workspace_file_too_large": "Split file or use hosting.deploy_files for large assets", "workspace_path_escape": "Path escapes workspace root — use a relative path under workspace/", "workspace_path_invalid": "Path must be relative under workspace/ without .. segments"}, "when_to_use": "Write source into workspace/ next to the compiled site. Publish with hosting.site.build. Binary assets: content_base64 (same as hosting.files.put)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.file.put", "mutation_risk": "low", "related_tools": ["hosting.workspace.files.list", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace File Put", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "content_required": "Pass UTF-8 content or content_base64 for workspace writes — hosting.workspace.file.get before full replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "path_required": "Pass path relative to workspace/ — hosting.workspace.files.list to discover paths", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "workspace_file_too_large": "Split file or use hosting.deploy_files for large assets", "workspace_path_escape": "Path escapes workspace root — use a relative path under workspace/", "workspace_path_invalid": "Path must be relative under workspace/ without .. segments"}, "when_to_use": "Write source into workspace/ next to the compiled site. Publish with hosting.site.build. Binary assets: content_base64 (same as hosting.files.put)."}, "do_not_use_when": "Operator laptop without MCP/API session — use platform_tooling.py vps fs put/push against operator_ssh_workspace_root from hosting.workspace.meta (SSH break-glass only).", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "error_hints": [{"code": "validation_error", "tip": "Strip data: URL prefix; never pass PLACEHOLDER / YOUR_TOKEN literals as base64. Prefer UTF-8 content or hosting.bucket.file.patch search_replace over base64."}], "examples": [{"name": "Put React source", "request": {"params": {"bucket_name": "frontend", "content": "export default function App() { return <h1>Hi</h1>; }", "path": "src/App.tsx", "project_id": 1}, "tool": "hosting.workspace.file.put"}}, {"name": "Equivalent patch plane", "request": {"params": {"bucket_name": "frontend", "git_commit": true, "git_push": true, "patch_plane": "workspace", "path": "src/App.tsx", "project_id": 1, "write_mode": "replace"}, "tool": "hosting.bucket.file.patch"}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_BASE64_DECODE": "Strip data: URL prefix; never pass PLACEHOLDER / YOUR_TOKEN literals as base64. Prefer UTF-8 content or hosting.bucket.file.patch search_replace over base64.", "HOSTING_BASE64_PADDING": "content_base64 validation_error: strip whitespace, add = until length % 4 — invalid padding fails before decode.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.workspace.files.list", "hosting.site.build"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_workspace_file_put", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Write a source file into bucket workspace/. Publish with hosting.site.build.", "title": "Hosting Workspace File Put", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "content_required": "Pass UTF-8 content or content_base64 for workspace writes — hosting.workspace.file.get before full replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "path_required": "Pass path relative to workspace/ — hosting.workspace.files.list to discover paths", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "workspace_file_too_large": "Split file or use hosting.deploy_files for large assets", "workspace_path_escape": "Path escapes workspace root — use a relative path under workspace/", "workspace_path_invalid": "Path must be relative under workspace/ without .. segments"}, "when_blocked_locales": {}, "when_not_to_use": "Operator laptop without MCP/API session — use platform_tooling.py vps fs put/push against operator_ssh_workspace_root from hosting.workspace.meta (SSH break-glass only).", "when_to_use": "Write source into workspace/ next to the compiled site. Publish with hosting.site.build. Binary assets: content_base64 (same as hosting.files.put).", "write_mode": null}, {"action": "hosting.workspace.file.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.file.delete", "mutation_risk": "high", "related_tools": ["hosting.workspace.files.list", "hosting.workspace.file.put", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace File Delete", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "path_required": "Pass path relative to workspace/ — hosting.workspace.files.list to discover paths", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "workspace_file_missing": "File absent in workspace/ — hosting.workspace.init or seed_from_live", "workspace_path_escape": "Path escapes workspace root — use a relative path under workspace/", "workspace_path_invalid": "Path must be relative under workspace/ without .. segments"}, "when_to_use": "Remove a workspace source path. Does not delete live /s/ bytes — use hosting.site.build after edits."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.file.delete", "mutation_risk": "high", "related_tools": ["hosting.workspace.files.list", "hosting.workspace.file.put", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace File Delete", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "path_required": "Pass path relative to workspace/ — hosting.workspace.files.list to discover paths", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "workspace_file_missing": "File absent in workspace/ — hosting.workspace.init or seed_from_live", "workspace_path_escape": "Path escapes workspace root — use a relative path under workspace/", "workspace_path_invalid": "Path must be relative under workspace/ without .. segments"}, "when_to_use": "Remove a workspace source path. Does not delete live /s/ bytes — use hosting.site.build after edits."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Remove a workspace source path. Does not delete live /s/ bytes — use hosting.site.build after edits.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.workspace.files.list", "hosting.workspace.file.put", "hosting.site.build"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_workspace_file_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete a source file from bucket workspace/ (not live current).", "title": "Hosting Workspace File Delete", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "path_required": "Pass path relative to workspace/ — hosting.workspace.files.list to discover paths", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "workspace_file_missing": "File absent in workspace/ — hosting.workspace.init or seed_from_live", "workspace_path_escape": "Path escapes workspace root — use a relative path under workspace/", "workspace_path_invalid": "Path must be relative under workspace/ without .. segments"}, "when_blocked_locales": {}, "when_to_use": "Remove a workspace source path. Does not delete live /s/ bytes — use hosting.site.build after edits.", "write_mode": null}, {"action": "hosting.verify", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Post-publish smoke only — not hosting.bucket.file.get.", "anti_patterns": ["Post-publish smoke only — not hosting.bucket.file.get.", "Do not poll before deploy finishes — run after hosting.deploy_files or patch publish.", "Do not call hosting.verify and hosting.site.edge_health in the same loop — pick one."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.verify", "related_tools": ["hosting.site.edge_health", "hosting.release.promote", "hosting.deploy_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Verify", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Post-publish smoke — alias of hosting.site.edge_health with verify_kind=edge_health."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.verify", "related_tools": ["hosting.site.edge_health", "hosting.release.promote", "hosting.deploy_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Verify", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Post-publish smoke — alias of hosting.site.edge_health with verify_kind=edge_health."}, "do_not_use_when": "Before live bytes exist — verify after publish or patch with publish=true.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Post-publish smoke — alias of hosting.site.edge_health with verify_kind=edge_health.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.site.edge_health", "hosting.release.promote", "hosting.deploy_files"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_verify", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Verify live/preview hosting health (alias of hosting.site.edge_health; intent taxonomy edge_health).", "title": "Hosting Verify", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}}, "when_not_to_use": "Before live bytes exist — verify after publish or patch with publish=true.", "when_to_use": "Post-publish smoke — alias of hosting.site.edge_health with verify_kind=edge_health.", "write_mode": null}, {"action": "hosting.deploy_files", "aliases": ["hosting.deploy", "hosting.deploy.files", "hosting.publish", "hosting.upload_session"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "replace_site=true requires confirm_site_replace=true — default overlay preserves live pages.", "anti_patterns": ["replace_site=true requires confirm_site_replace=true — default overlay preserves live pages.", "Do not deploy_files for one-line CSS — use hosting.bucket.file.patch.", "Write one file with hosting.files.put. List with hosting.bucket.files.list.", "dry_run previews paths and does not write. publish defaults true and needs index.html on the live tree.", "dry_run fail-closed: gate_would_pass=false when missing_references or static_gate_issues (secrets, bytes, index) — fix before publish.", "reference_warnings (foreign_project / foreign_site_slug): cross-site /s/{pid}/{slug}/ links are informational — not missing_references; prefer same-site relative paths."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false, "publish": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.deploy_files", "mutates_when": {"dry_run": false, "publish": true}, "mutation_risk": "low", "related_tools": ["permissions.effective", "preflight.check", "hosting.site.resolve", "hosting.site.edge_health", "hosting.release.promote"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Hosting Deploy Files", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "hosting_inline_file_too_large": "Inline MCP cap 2MiB/file — hosting.site.upload_grant (alias storage.upload_grant) + HTTP POST for ZIP; or hosting.deploy_files with finalize=false and reuse upload_session_id from response; not one giant app.js in JSON", "hosting_missing_reference": "Static href/src/url() points at a path not in the deploy batch or live bucket — hosting.deploy_files dry_run lists missing_references; upload assets or fix links", "hosting_prune_requires_confirmation": "Publish would drop live paths absent from files[] — run dry_run, review manifest_diff.removed, then confirm_prune=true.", "hosting_quota_exceeded": "Project hosting byte quota full (live tree + workspace) — hosting.release.list, delete stale releases (hosting.release.delete), or raise hosting buff. Same recovery as hosting_archive_quota_exceeded; snapshot may soft-fail while publish succeeds.", "hosting_replace_requires_confirmation": "replace_site=true requires confirm_site_replace=true — run dry_run first to preview paths", "hosting_snapshot_rate_limited": "Upload/publish succeeded; hourly snapshot cap hit — skip manual snapshot. Poll hosting.site.edge_health if the public URL is not ready.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "L2 admin RBAC — preflight.check or permissions.effective action=hosting.deploy_files (action_params.publish=true, slim files:[{path,bytes}] for probes); rbac.check_permission(admin). If admin granted but deploy/preflight denies: stale permissions_bitmap — reconnect OAuth; ops scripts use execution_intent=direct; core bitmap_session_reconcile + hydrate_mcp_execute_principal.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Upload static files to a hosting bucket (HTML, assets, text batches — not ZIP archives). ZIP / Vite dist: hosting.site.import_archive or hosting.site.upload_grant. Before large publish: permissions.ef"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false, "publish": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.deploy_files", "mutates_when": {"dry_run": false, "publish": true}, "mutation_risk": "low", "related_tools": ["permissions.effective", "preflight.check", "hosting.site.resolve", "hosting.site.edge_health", "hosting.release.promote"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Hosting Deploy Files", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "hosting_inline_file_too_large": "Inline MCP cap 2MiB/file — hosting.site.upload_grant (alias storage.upload_grant) + HTTP POST for ZIP; or hosting.deploy_files with finalize=false and reuse upload_session_id from response; not one giant app.js in JSON", "hosting_missing_reference": "Static href/src/url() points at a path not in the deploy batch or live bucket — hosting.deploy_files dry_run lists missing_references; upload assets or fix links", "hosting_prune_requires_confirmation": "Publish would drop live paths absent from files[] — run dry_run, review manifest_diff.removed, then confirm_prune=true.", "hosting_quota_exceeded": "Project hosting byte quota full (live tree + workspace) — hosting.release.list, delete stale releases (hosting.release.delete), or raise hosting buff. Same recovery as hosting_archive_quota_exceeded; snapshot may soft-fail while publish succeeds.", "hosting_replace_requires_confirmation": "replace_site=true requires confirm_site_replace=true — run dry_run first to preview paths", "hosting_snapshot_rate_limited": "Upload/publish succeeded; hourly snapshot cap hit — skip manual snapshot. Poll hosting.site.edge_health if the public URL is not ready.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "L2 admin RBAC — preflight.check or permissions.effective action=hosting.deploy_files (action_params.publish=true, slim files:[{path,bytes}] for probes); rbac.check_permission(admin). If admin granted but deploy/preflight denies: stale permissions_bitmap — reconnect OAuth; ops scripts use execution_intent=direct; core bitmap_session_reconcile + hydrate_mcp_execute_principal.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Upload static files to a hosting bucket (HTML, assets, text batches — not ZIP archives). ZIP / Vite dist: hosting.site.import_archive or hosting.site.upload_grant. Before large publish: permissions.ef"}, "do_not_use_when": "Single-file text edit on existing /s/ path.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_param_sensitive": true, "conditional_mutate": "Omitted publish goes live. dry_run=true returns manifest_diff only. publish=false finalizes without going live. confirm_prune when removed[] is non-empty.", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false, "publish": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "error_hints": [{"code": "validation_error", "tip": "Strip data: URL prefix; never pass PLACEHOLDER / YOUR_TOKEN literals as base64. Prefer UTF-8 content or hosting.bucket.file.patch search_replace over base64."}], "examples": [{"name": "Dry-run path preview (L2 read-class)", "request": {"params": {"dry_run": true, "files": [{"content_base64": "PGg+PC9oPg==", "path": "docs/index.html"}], "project_id": 1444, "publish": false}, "tool": "hosting.deploy_files"}, "response": {"data": {"dry_run": true, "paths": ["docs/index.html"]}, "success": true}}, {"name": "Before live publish — preflight + permissions", "request": {"params": {"action": "hosting.deploy_files", "action_params": {"files": [{"bytes": 1200, "path": "docs/index.html"}], "publish": true}, "execution_intent": "direct", "project_id": 1444}, "tool": "preflight.check"}, "response": {"data": {"effect_policy_allowed": true}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_BASE64_DECODE": "Strip data: URL prefix; never pass PLACEHOLDER / YOUR_TOKEN literals as base64. Prefer UTF-8 content or hosting.bucket.file.patch search_replace over base64.", "HOSTING_BASE64_PADDING": "content_base64 validation_error: strip whitespace, add = until length % 4 — invalid padding fails before decode.", "HOSTING_COPYTREE_ANTIPATTERN": "Do not hosting.deploy_files an entire compiled SPA into preview/dev. Use hosting.site.build target=dev, hosting.workspace.import_tree, or ops seed_dev_preview_minimal — never bulk-copy live current/ as deploy_files. Symlink fallback on disk copies public live root only (not releases/).", "HOSTING_GENERATION_ENV_OMIT": "Omit generation_env_uuid on hosting.* byte writes — site edits do not fork. A stale uuid in batch context fails auto-fork; let the server keep the sandbox head. generation_fork_required on hosting.deploy_files is a status-projection defect: another generation.fork does not repair the bytes.", "HOSTING_POST_DEPLOY_VERIFY": "After hosting.deploy_files publish on flagship tenants: run agentstack-core/scripts/unity/unity_post_deploy_verify_1444.py (--prod-only or --quick). Published HTML/JSON report includes priemka_coverage (68 checklist items) — do not treat report.ok as full priemka sign-off when manual/partial counts remain.", "HOSTING_REPLACE_SITE_CONFIRM": "replace_site=true wipes live pages — pass confirm_site_replace=true after dry_run. Default overlay: replace_site=false (merge upload).", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Upload static files to a hosting bucket (HTML, assets, text batches — not ZIP archives). ZIP / Vite…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"paths": {"description": "array", "items": {"type": "string"}, "type": "array"}, "skipped": {"description": "boolean", "type": "boolean"}, "url": {"description": "string", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "pending_state": "publish=true leaves success=false until hosting.site.edge_health shows edge ready (mutation receipt committed=false).", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["permissions.effective", "preflight.check", "hosting.site.resolve", "hosting.site.edge_health", "hosting.release.promote"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["hosting.release.promote"], "safe_action": "hosting_deploy_files", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Batch-upload files to a bucket and optionally publish (max 50 files per call, 2MiB inline per file). Large trees: chunk with finalize=false (server returns upload_session_id), then repeat with same up", "title": "Hosting Deploy Files", "verification": ["hosting.project.status", "hosting.site.edge_health"], "verify": [{"action": "hosting.project.status", "predicate": "named resource is visible"}, {"action": "hosting.site.edge_health", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "hosting_inline_file_too_large": "Inline MCP cap 2MiB/file — hosting.site.upload_grant (alias storage.upload_grant) + HTTP POST for ZIP; or hosting.deploy_files with finalize=false and reuse upload_session_id from response; not one giant app.js in JSON", "hosting_missing_reference": "Static href/src/url() points at a path not in the deploy batch or live bucket — hosting.deploy_files dry_run lists missing_references; upload assets or fix links", "hosting_prune_requires_confirmation": "Publish would drop live paths absent from files[] — run dry_run, review manifest_diff.removed, then confirm_prune=true.", "hosting_quota_exceeded": "Project hosting byte quota full (live tree + workspace) — hosting.release.list, delete stale releases (hosting.release.delete), or raise hosting buff. Same recovery as hosting_archive_quota_exceeded; snapshot may soft-fail while publish succeeds.", "hosting_replace_requires_confirmation": "replace_site=true requires confirm_site_replace=true — run dry_run first to preview paths", "hosting_snapshot_rate_limited": "Upload/publish succeeded; hourly snapshot cap hit — skip manual snapshot. Poll hosting.site.edge_health if the public URL is not ready.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "L2 admin RBAC — preflight.check or permissions.effective action=hosting.deploy_files (action_params.publish=true, slim files:[{path,bytes}] for probes); rbac.check_permission(admin). If admin granted but deploy/preflight denies: stale permissions_bitmap — reconnect OAuth; ops scripts use execution_intent=direct; core bitmap_session_reconcile + hydrate_mcp_execute_principal.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_blocked_locales": {"hosting_archive_quota_exceeded": {"en-US": "Release archive budget full — hosting.release.list + delete old releases, or raise hosting archive buff; live publish may still succeed (soft-fail snapshot)", "pt-BR": "Cota de archive cheia — hosting.release.list e apague releases antigos; publish live pode ok sem snapshot", "ru-RU": "Квота архива релизов — hosting.release.list и удалите старые снимки; публикация live может пройти без snapshot"}, "hosting_quota_exceeded": {"en-US": "Hosting byte quota full — hosting.release.list + delete old releases, or raise hosting buff; live publish may still succeed (soft-fail snapshot)", "pt-BR": "Cota de bytes do hosting cheia — hosting.release.list e apague releases antigos; publish live pode ok sem snapshot", "ru-RU": "Квота байтов хостинга — hosting.release.list и удалите старые релизы; публикация live может пройти без snapshot"}, "hosting_snapshot_rate_limited": {"en-US": "Publish ok; snapshot rate-limited — skip snapshot, poll hosting.site.edge_health", "pt-BR": "Publicação ok; limite de snapshot — pule snapshot, use hosting.site.edge_health", "ru-RU": "Публикация ок; лимит снимков — не делайте snapshot, опросите hosting.site.edge_health"}, "site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}, "validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_not_to_use": "Single-file text edit on existing /s/ path.", "when_to_use": "Upload static files to a hosting bucket (HTML, assets, text batches — not ZIP archives). ZIP / Vite dist: hosting.site.import_archive or hosting.site.upload_grant. Before large publish: permissions.ef", "write_mode": null}, {"action": "hosting.bucket.files.list", "aliases": ["hosting.bucket.file.list", "hosting.bucket.list", "hosting.bucket.list_files", "hosting.buckets.list", "hosting.files.list", "hosting.site.list_files"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.files.list", "related_tools": ["hosting.project.status", "hosting.bucket.file.get", "hosting.bucket.file.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket Files List", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List objects in a site bucket (prefix, cursor, optional q path filter ≥2 chars). Prefer prefix=folder/ for junk sweeps — avoids full-bucket scan. Use before bulk_delete or when patch path is unknown."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.files.list", "related_tools": ["hosting.project.status", "hosting.bucket.file.get", "hosting.bucket.file.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket Files List", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List objects in a site bucket (prefix, cursor, optional q path filter ≥2 chars). Prefer prefix=folder/ for junk sweeps — avoids full-bucket scan. Use before bulk_delete or when patch path is unknown."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "List objects in a site bucket (prefix, cursor, optional q path filter ≥2 chars). Prefer prefix=fold…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.status", "hosting.bucket.file.get", "hosting.bucket.file.patch"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_bucket_files_list", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "List files in a hosting bucket (optional prefix, cursor pagination, optional q path substring filter).", "title": "Hosting Bucket Files List", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}}, "when_to_use": "List objects in a site bucket (prefix, cursor, optional q path filter ≥2 chars). Prefer prefix=folder/ for junk sweeps — avoids full-bucket scan. Use before bulk_delete or when patch path is unknown.", "write_mode": null}, {"action": "hosting.sync.plan", "aliases": ["hosting.site.manifest", "hosting.sync.manifest"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Read-only manifest — options.goal is not required.", "anti_patterns": ["Read-only manifest — options.goal is not required.", "Diff locally, upload chunks via hosting.deploy_files + upload_session_id, then hosting.sync.commit.", "Default include_hashes=false — do not sha256-scan large buckets unless diff needs hashes."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.sync.plan", "related_tools": ["hosting.deploy_files", "hosting.sync.commit", "hosting.bucket.files.list", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Sync Plan", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Live-tree manifest (path, bytes, stat_fingerprint). Set include_hashes=true only when you need sha256 (heavy). Diff locally, upload via hosting.deploy_files with upload_session_id, then hosting.sync.c"}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.sync.plan", "related_tools": ["hosting.deploy_files", "hosting.sync.commit", "hosting.bucket.files.list", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Sync Plan", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Live-tree manifest (path, bytes, stat_fingerprint). Set include_hashes=true only when you need sha256 (heavy). Diff locally, upload via hosting.deploy_files with upload_session_id, then hosting.sync.c"}, "do_not_use_when": "Upload without a local tree diff — use hosting.deploy_files directly.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Live-tree manifest (path, bytes, stat_fingerprint). Set include_hashes=true only when you need sha2…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.deploy_files", "hosting.sync.commit", "hosting.bucket.files.list", "hosting.project.status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_sync_plan", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Server manifest (path, sha256, bytes) for client-side hash diff before batched upload.", "title": "Hosting Sync Plan", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}}, "when_not_to_use": "Upload without a local tree diff — use hosting.deploy_files directly.", "when_to_use": "Live-tree manifest (path, bytes, stat_fingerprint). Set include_hashes=true only when you need sha256 (heavy). Diff locally, upload via hosting.deploy_files with upload_session_id, then hosting.sync.c", "write_mode": null}, {"action": "hosting.sync.commit", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Finalizes upload_session staging — set finalize via commit, not a second full zip upload.", "anti_patterns": ["Finalizes upload_session staging — set finalize via commit, not a second full zip upload.", "options.goal is not required for commit when only promoting staged bytes."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"publish": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.sync.commit", "mutates_when": {"publish": true}, "mutation_risk": "low", "related_tools": ["hosting.sync.plan", "hosting.deploy_files", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Sync Commit", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Finalize upload_session after all deploy_files chunks land; publish defaults true. options.goal not required for byte promote."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"publish": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.sync.commit", "mutates_when": {"publish": true}, "mutation_risk": "low", "related_tools": ["hosting.sync.plan", "hosting.deploy_files", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Sync Commit", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Finalize upload_session after all deploy_files chunks land; publish defaults true. options.goal not required for byte promote."}, "do_not_use_when": "Before all deploy_files chunks for upload_session_id are staged.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_param_sensitive": true, "conditional_mutate": "publish defaults true — set publish=false for finalize-only", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "mutates_when": {"publish": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Finalize upload_session after all deploy_files chunks land; publish defaults true. options.goal not…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.sync.plan", "hosting.deploy_files", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_sync_commit", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Finalize upload_session staging and optionally publish (after hosting.deploy_files chunks).", "title": "Hosting Sync Commit", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}, "validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_not_to_use": "Before all deploy_files chunks for upload_session_id are staged.", "when_to_use": "Finalize upload_session after all deploy_files chunks land; publish defaults true. options.goal not required for byte promote.", "write_mode": null}, {"action": "hosting.content.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not use for HTML/CSS/JS — hosting.bucket.file.patch on the served path.", "anti_patterns": ["Do not use for HTML/CSS/JS — hosting.bucket.file.patch on the served path.", "Do not projects.patch_data for site bytes — bucket file patch is the SoT.", "Do not GET+hand-edit YAML when patch_path segments are known."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.content.patch", "mutation_risk": "low", "related_tools": ["hosting.bucket.file.patch", "hosting.bucket.file.get", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Content Patch", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "extension_not_patchable": "Text patch on live allows html, css, js, ts, json, md, txt, svg only — not tsx/jsx/yaml. React/Vite sources: hosting.workspace.file.put or patch_plane=workspace. Missing package.json on live tree means edit workspace/, not served /s/ bytes.", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "revision_conflict": "expected_sha256 mismatch — hosting.bucket.file.get then retry with fresh content_sha256", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Structured YAML leaf writes (default content/site.yaml) without hand-editing HTML. Uses hosting.bucket.file.patch replace under the hood — pair with site.build when enabled."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.content.patch", "mutation_risk": "low", "related_tools": ["hosting.bucket.file.patch", "hosting.bucket.file.get", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Content Patch", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "extension_not_patchable": "Text patch on live allows html, css, js, ts, json, md, txt, svg only — not tsx/jsx/yaml. React/Vite sources: hosting.workspace.file.put or patch_plane=workspace. Missing package.json on live tree means edit workspace/, not served /s/ bytes.", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "revision_conflict": "expected_sha256 mismatch — hosting.bucket.file.get then retry with fresh content_sha256", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Structured YAML leaf writes (default content/site.yaml) without hand-editing HTML. Uses hosting.bucket.file.patch replace under the hood — pair with site.build when enabled."}, "do_not_use_when": "Binary or large HTML bodies — use hosting.bucket.file.patch replace.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Structured YAML leaf writes (default content/site.yaml) without hand-editing HTML. Uses hosting.buc…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.bucket.file.patch", "hosting.bucket.file.get", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_content_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch content/site.yaml (or other YAML path) via structured path/value writes.", "title": "Hosting Content Patch", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "extension_not_patchable": "Text patch on live allows html, css, js, ts, json, md, txt, svg only — not tsx/jsx/yaml. React/Vite sources: hosting.workspace.file.put or patch_plane=workspace. Missing package.json on live tree means edit workspace/, not served /s/ bytes.", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "revision_conflict": "expected_sha256 mismatch — hosting.bucket.file.get then retry with fresh content_sha256", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_blocked_locales": {"extension_not_patchable": {"en-US": "Text patch allows html, css, js, ts, json, md, txt, svg only", "pt-BR": "Patch de texto só para html, css, js, ts, json, md, txt, svg", "ru-RU": "Текстовый patch только для html, css, js, ts, json, md, txt, svg"}, "site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}, "validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_not_to_use": "Binary or large HTML bodies — use hosting.bucket.file.patch replace.", "when_to_use": "Structured YAML leaf writes (default content/site.yaml) without hand-editing HTML. Uses hosting.bucket.file.patch replace under the hood — pair with site.build when enabled.", "write_mode": null}, {"action": "hosting.bucket.grep", "aliases": ["hosting.bucket.search", "hosting.files.grep"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not grep the whole bucket without glob=*.html or prefix=assets/ — default max_files=80 truncates.", "anti_patterns": ["Do not grep the whole bucket without glob=*.html or prefix=assets/ — default max_files=80 truncates.", "Do not use grep instead of hosting.bucket.file.patch when the target string is already known.", "truncated=true — narrow glob/prefix before raising max_files above 80.", "truncated_reason is max_files|max_matches — tighten glob/prefix before raising caps."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.grep", "related_tools": ["hosting.project.status", "hosting.bucket.files.list", "hosting.bucket.file.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket Grep", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosting_grep_truncated": "truncated_reason max_files|max_matches — add glob or prefix, then hosting.bucket.file.patch. Do not raise max_files to 500 on the first retry.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Find substring/regex in live UTF-8 text files before planning many search_replace patches. Always pass glob (e.g. *.css) or prefix. Defaults: max_files=80, max_matches=200; truncated=true means tighte"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.grep", "related_tools": ["hosting.project.status", "hosting.bucket.files.list", "hosting.bucket.file.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket Grep", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosting_grep_truncated": "truncated_reason max_files|max_matches — add glob or prefix, then hosting.bucket.file.patch. Do not raise max_files to 500 on the first retry.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Find substring/regex in live UTF-8 text files before planning many search_replace patches. Always pass glob (e.g. *.css) or prefix. Defaults: max_files=80, max_matches=200; truncated=true means tighte"}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Find substring/regex in live UTF-8 text files before planning many search_replace patches. Always p…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.status", "hosting.bucket.files.list", "hosting.bucket.file.patch"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_bucket_grep", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Search UTF-8 bucket text files for a substring or regex. Optional glob (e.g. *.html) and prefix narrow the scan. Returns truncated=true when max_files or max_matches hit — tighten glob/prefix first.", "title": "Hosting Bucket Grep", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosting_grep_truncated": "truncated_reason max_files|max_matches — add glob or prefix, then hosting.bucket.file.patch. Do not raise max_files to 500 on the first retry.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"hosting_grep_truncated": {"en-US": "truncated_reason max_files|max_matches — tighten glob/prefix, then hosting.bucket.file.patch", "pt-BR": "truncated_reason max_files|max_matches — restrinja glob/prefix, depois hosting.bucket.file.patch", "ru-RU": "truncated_reason max_files|max_matches — сузьте glob/prefix, затем hosting.bucket.file.patch"}}, "when_to_use": "Find substring/regex in live UTF-8 text files before planning many search_replace patches. Always pass glob (e.g. *.css) or prefix. Defaults: max_files=80, max_matches=200; truncated=true means tighte", "write_mode": null}, {"action": "hosting.gc.ix", "annotations": {"destructiveHint": true, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.gc.ix", "mutates_when": {"dry_run": false}, "mutation_risk": "high", "related_tools": ["hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Gc Ix", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem admin required — auth.get_profile for owner role", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem-admin repair of stale hosting_buckets/_ix symlinks after list/patch drift — not for tenant file edits."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.gc.ix", "mutates_when": {"dry_run": false}, "mutation_risk": "high", "related_tools": ["hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Gc Ix", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem admin required — auth.get_profile for owner role", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem-admin repair of stale hosting_buckets/_ix symlinks after list/patch drift — not for tenant file edits."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true lists orphans; default dry_run=false removes symlinks", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Ecosystem-admin repair of stale hosting_buckets/_ix symlinks after list/patch drift — not for tenan…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.status"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_gc_ix", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Prune orphan hosting_buckets/_ix symlinks (admin diagnostics broken_ix).", "title": "Hosting Gc Ix", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem admin required — auth.get_profile for owner role", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Ecosystem-admin repair of stale hosting_buckets/_ix symlinks after list/patch drift — not for tenant file edits.", "write_mode": null}, {"action": "hosting.bucket.file.get", "aliases": ["hosting.site.asset", "hosting.site.asset.get", "hosting.storage.download", "storage.download"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not use storage.upload to read /s/ site files.", "anti_patterns": ["Do not use storage.upload to read /s/ site files.", "search_replace does not need a prior GET. Read the file when you need its bytes."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.file.get", "related_tools": ["hosting.bucket.file.patch", "hosting.project.status", "hosting.bucket.files.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket File Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "not_ready": "Batch write still projecting — poll hosting.bucket.file.get or hosting.bucket.files.list", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read site bytes when the edit is unknown. UTF-8 comes back whole until 64000 characters; pass offset only when truncated is true. A known search_replace skips this GET."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.file.get", "related_tools": ["hosting.bucket.file.patch", "hosting.project.status", "hosting.bucket.files.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket File Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "not_ready": "Batch write still projecting — poll hosting.bucket.file.get or hosting.bucket.files.list", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read site bytes when the edit is unknown. UTF-8 comes back whole until 64000 characters; pass offset only when truncated is true. A known search_replace skips this GET."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Read site bytes when the edit is unknown. UTF-8 comes back whole until 64000 characters; pass offse…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.bucket.file.patch", "hosting.project.status", "hosting.bucket.files.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_bucket_file_get", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Read a bucket file. UTF-8 text is a window only past 64000 characters (offset). Base64 is the file read, max 2MB.", "title": "Hosting Bucket File Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "not_ready": "Batch write still projecting — poll hosting.bucket.file.get or hosting.bucket.files.list", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}}, "when_to_use": "Read site bytes when the edit is unknown. UTF-8 comes back whole until 64000 characters; pass offset only when truncated is true. A known search_replace skips this GET.", "workflow_ladder": ["hosting.project.status — if primary_public_url is set, edit that bucket", "hosting.bucket.file.patch search_replace — replacements [{\"find\":\"...\",\"replace\":\"...\"}]. Pass expected_sha256 when you have it. Identical bytes skip the write", "agent_completion.done — gzip and cache_bust already ran. Skip edge_health unless the public URL 404s"], "write_mode": null}, {"action": "hosting.bucket.file.patch", "ai_tips": "One UTF-8 text edit. patch_plane=live (default) patches served /s/ and refreshes .gz. patch_plane=workspace edits sources beside releases — pair with hosting.site.build. Default write_mode=search_replace + replacements; use replace for full-file body.", "aliases": ["hosting.bucket.file.content_patch", "hosting.file.patch", "hosting.files.patch", "hosting.workspace.file.patch"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not use storage.upload for in-place site edits.", "anti_patterns": ["Do not use storage.upload for in-place site edits.", "When workspace/ has site.build.yaml, edit sources with patch_plane=workspace or hosting.workspace.file.put — not live assets.", "Do not search_replace assets/index-*.js. That file is build output. Edit src, then build and publish.", "Do not call generation.fork for a single CSS/HTML line change.", "Do not bulk_delete the .gz sibling. gzip_sibling on the result means it was refreshed.", "Do not hand-edit the script query. cache_bust index.html means the src was updated."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1", "core.hosting.mcp_file_edit.gen1"], "id": "hosting.bucket.file.patch", "mutates_when": {"dry_run": false}, "mutation_risk": "low", "related_tools": ["hosting.bucket.file.get", "hosting.project.status", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket File Patch", "when_blocked": {"ambiguous_anchor": "Multiple find matches — use a longer unique find or set count on the replacement pair", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "content_shrink_blocked": "allow_shrink=true when intentional, else search_replace for a partial edit", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "extension_not_patchable": "Text patch on live allows html, css, js, ts, json, md, txt, svg only — not tsx/jsx/yaml. React/Vite sources: hosting.workspace.file.put or patch_plane=workspace. Missing package.json on live tree means edit workspace/, not served /s/ bytes.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_path": "hosting.bucket.files.list — confirm path exists and suffix is patchable", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "patch_apply_failed": "hosting.bucket.file.get, then search_replace or strict_diff=true", "preview_too_large": "Output >2MB — search_replace a section or hosting.deploy_files for large assets", "replacement_not_found": "search_replace needs find and replace — hosting.bucket.file.get and confirm the substring", "revision_conflict": "expected_sha256 mismatch — hosting.bucket.file.get then retry with fresh content_sha256", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "secret_pattern_blocked": "Remove API keys / bearer literals from site bytes — use hosted session cookie flow", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "One UTF-8 text edit. patch_plane=live (default) patches served /s/ and refreshes .gz. patch_plane=workspace edits sources beside releases — pair with hosting.site.build. Default write_mode=search_repl"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1", "core.hosting.mcp_file_edit.gen1"], "id": "hosting.bucket.file.patch", "mutates_when": {"dry_run": false}, "mutation_risk": "low", "related_tools": ["hosting.bucket.file.get", "hosting.project.status", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket File Patch", "when_blocked": {"ambiguous_anchor": "Multiple find matches — use a longer unique find or set count on the replacement pair", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "content_shrink_blocked": "allow_shrink=true when intentional, else search_replace for a partial edit", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "extension_not_patchable": "Text patch on live allows html, css, js, ts, json, md, txt, svg only — not tsx/jsx/yaml. React/Vite sources: hosting.workspace.file.put or patch_plane=workspace. Missing package.json on live tree means edit workspace/, not served /s/ bytes.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_path": "hosting.bucket.files.list — confirm path exists and suffix is patchable", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "patch_apply_failed": "hosting.bucket.file.get, then search_replace or strict_diff=true", "preview_too_large": "Output >2MB — search_replace a section or hosting.deploy_files for large assets", "replacement_not_found": "search_replace needs find and replace — hosting.bucket.file.get and confirm the substring", "revision_conflict": "expected_sha256 mismatch — hosting.bucket.file.get then retry with fresh content_sha256", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "secret_pattern_blocked": "Remove API keys / bearer literals from site bytes — use hosted session cookie flow", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "One UTF-8 text edit. patch_plane=live (default) patches served /s/ and refreshes .gz. patch_plane=workspace edits sources beside releases — pair with hosting.site.build. Default write_mode=search_repl"}, "do_not_use_when": "Do not patch assets/index-*.js. App Studio source uses ai_builder.source.patch.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true returns diff only (no bucket write); default applies UTF-8 patch (mutate)", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_GENERATION_ENV_OMIT": "Omit generation_env_uuid on hosting.* byte writes — site edits do not fork. A stale uuid in batch context fails auto-fork; let the server keep the sandbox head. generation_fork_required on hosting.deploy_files is a status-projection defect: another generation.fork does not repair the bytes.", "HOSTING_STRICT_DIFF_HTML": ".html/.htm unified_diff is strict (no fuzzy) by default — use search_replace for small edits or strict_diff=false only when hunks are exact.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"apply_method": {"description": "string", "type": "string"}, "content_sha256": {"description": "string", "type": "string"}, "dry_run": {"description": "boolean", "type": "boolean"}, "path": {"description": "string", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_file_edit", "agentstack_write_modes"], "related_tools": ["hosting.bucket.file.get", "hosting.project.status", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["hosting.release.promote"], "safe_action": "hosting_bucket_file_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Edit one UTF-8 file. Pass bucket_id (project 1 has many sites; omit only for the primary). write_mode=search_replace + replacements [{find, replace}] for a small edit. write_mode=replace (alias conten", "title": "Patch Hosted File", "verification": ["hosting.bucket.file.get"], "verify": [{"action": "hosting.bucket.file.get", "predicate": "named resource is visible"}], "when_blocked": {"ambiguous_anchor": "Multiple find matches — use a longer unique find or set count on the replacement pair", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "content_shrink_blocked": "allow_shrink=true when intentional, else search_replace for a partial edit", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "extension_not_patchable": "Text patch on live allows html, css, js, ts, json, md, txt, svg only — not tsx/jsx/yaml. React/Vite sources: hosting.workspace.file.put or patch_plane=workspace. Missing package.json on live tree means edit workspace/, not served /s/ bytes.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_path": "hosting.bucket.files.list — confirm path exists and suffix is patchable", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "patch_apply_failed": "hosting.bucket.file.get, then search_replace or strict_diff=true", "preview_too_large": "Output >2MB — search_replace a section or hosting.deploy_files for large assets", "replacement_not_found": "search_replace needs find and replace — hosting.bucket.file.get and confirm the substring", "revision_conflict": "expected_sha256 mismatch — hosting.bucket.file.get then retry with fresh content_sha256", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "secret_pattern_blocked": "Remove API keys / bearer literals from site bytes — use hosted session cookie flow", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_blocked_locales": {"content_shrink_blocked": {"en-US": "allow_shrink=true when intentional, else search_replace for a partial edit", "pt-BR": "allow_shrink=true se a redução for intencional, senão search_replace para edição parcial", "ru-RU": "allow_shrink=true если сжатие намеренное, иначе search_replace для частичной правки"}, "extension_not_patchable": {"en-US": "Text patch allows html, css, js, ts, json, md, txt, svg only", "pt-BR": "Patch de texto só para html, css, js, ts, json, md, txt, svg", "ru-RU": "Текстовый patch только для html, css, js, ts, json, md, txt, svg"}, "invalid_path": {"en-US": "Confirm path via hosting.bucket.files.list and patchable suffix", "pt-BR": "Confirme o path via hosting.bucket.files.list e sufixo patchável", "ru-RU": "Проверьте path через hosting.bucket.files.list и допустимый суффикс"}, "patch_apply_failed": {"en-US": "hosting.bucket.file.get, then search_replace or strict_diff=true", "pt-BR": "hosting.bucket.file.get, depois search_replace ou strict_diff=true", "ru-RU": "hosting.bucket.file.get, затем search_replace или strict_diff=true"}, "preview_too_large": {"en-US": "Patch output >2MB — search_replace a section or hosting.deploy_files", "pt-BR": "Saída do patch >2MB — search_replace em trecho ou hosting.deploy_files", "ru-RU": "Результат patch >2MB — search_replace по фрагменту или hosting.deploy_files"}, "replacement_not_found": {"en-US": "search_replace needs find and replace — hosting.bucket.file.get and confirm the substring", "pt-BR": "search_replace exige find e replace — hosting.bucket.file.get e confirme a substring", "ru-RU": "search_replace ждёт find и replace — hosting.bucket.file.get и проверьте подстроку"}, "secret_pattern_blocked": {"en-US": "Remove API keys or bearer literals from site bytes before patch", "pt-BR": "Remova API keys ou bearer dos bytes do site antes do patch", "ru-RU": "Уберите API keys / bearer из байтов сайта перед patch"}, "site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}, "validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_not_to_use": "Binary files, >2MB bodies, or files outside TEXT_PATCH suffix allowlist.", "when_to_use": "One UTF-8 text edit. patch_plane=live (default) patches served /s/ and refreshes .gz. patch_plane=workspace edits sources beside releases — pair with hosting.site.build. Default write_mode=search_repl", "workflow_ladder": ["hosting.project.status — if primary_public_url is set, edit that bucket", "hosting.bucket.file.patch search_replace — replacements [{\"find\":\"...\",\"replace\":\"...\"}]. Pass expected_sha256 when you have it. Identical bytes skip the write", "agent_completion.done — gzip and cache_bust already ran. Skip edge_health unless the public URL 404s"], "write_mode": null}, {"action": "hosting.site.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.delete", "mutation_risk": "low", "related_tools": ["hosting.release.snapshot", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove one hosted /s/ bucket. Read hosting.project.status first and delete only the duplicate slug, not the primary site."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.delete", "mutation_risk": "low", "related_tools": ["hosting.release.snapshot", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove one hosted /s/ bucket. Read hosting.project.status first and delete only the duplicate slug, not the primary site."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Remove one hosted /s/ bucket. Read hosting.project.status first and delete only the duplicate slug,…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.release.snapshot", "hosting.project.status"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_site_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Remove a hosted site bucket (same as REST DELETE /api/hosting/buckets/{bucket_id}).", "title": "Hosting Site Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}}, "when_to_use": "Remove one hosted /s/ bucket. Read hosting.project.status first and delete only the duplicate slug, not the primary site.", "write_mode": null}, {"action": "hosting.bucket.file.rename", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.file.rename", "mutation_risk": "low", "related_tools": ["hosting.bucket.file.get", "hosting.bucket.files.list", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket File Rename", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move or rename one object inside the site bucket. hosting.bucket.file.get to confirm source path before rename."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.file.rename", "mutation_risk": "low", "related_tools": ["hosting.bucket.file.get", "hosting.bucket.files.list", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket File Rename", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move or rename one object inside the site bucket. hosting.bucket.file.get to confirm source path before rename."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Move or rename one object inside the site bucket. hosting.bucket.file.get to confirm source path be…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.bucket.file.get", "hosting.bucket.files.list", "hosting.project.status"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_bucket_file_rename", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Rename or move a file within a bucket.", "title": "Hosting Bucket File Rename", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}}, "when_to_use": "Move or rename one object inside the site bucket. hosting.bucket.file.get to confirm source path before rename.", "write_mode": null}, {"action": "hosting.bucket.files.bulk_delete", "aliases": ["hosting.bucket.bulk_delete", "hosting.bucket.files.delete", "hosting.files.bulk_delete"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.files.bulk_delete", "mutation_risk": "low", "related_tools": ["hosting.bucket.files.list", "hosting.release.snapshot", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket Files Bulk Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "paths_or_prefix_required": "Pass paths[] or prefix — hosting.bucket.files.list to build the path set first", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete many paths or everything under a prefix — irreversible. hosting.release.snapshot then hosting.bucket.files.list."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.files.bulk_delete", "mutation_risk": "low", "related_tools": ["hosting.bucket.files.list", "hosting.release.snapshot", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket Files Bulk Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "paths_or_prefix_required": "Pass paths[] or prefix — hosting.bucket.files.list to build the path set first", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete many paths or everything under a prefix — irreversible. hosting.release.snapshot then hosting.bucket.files.list."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"conditional_mutate": "Destructive — execute batches need options.execution_intent=direct or workflow anchor (options.goal / focus_node_id). discovery.describe effect.audit_batch_allowed.", "execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Delete many paths or everything under a prefix — irreversible. hosting.release.snapshot then hostin…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.bucket.files.list", "hosting.release.snapshot", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_bucket_files_bulk_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete multiple files by path list or prefix.", "title": "Hosting Bucket Files Bulk Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "paths_or_prefix_required": "Pass paths[] or prefix — hosting.bucket.files.list to build the path set first", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}}, "when_to_use": "Delete many paths or everything under a prefix — irreversible. hosting.release.snapshot then hosting.bucket.files.list.", "write_mode": null}, {"action": "hosting.visual.inspect", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.hosting.gen1"], "id": "hosting.visual.inspect", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Visual Inspect", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Post-publish layout smoke (overflow/CTA/viewports) — not a substitute for hosting.site.edge_health."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.hosting.gen1"], "id": "hosting.visual.inspect", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Visual Inspect", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Post-publish layout smoke (overflow/CTA/viewports) — not a substitute for hosting.site.edge_health."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Post-publish layout smoke (overflow/CTA/viewports) — not a substitute for hosting.site.edge_health.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_visual_inspect", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Capture viewport screenshots for visual QA (375 and 1440). Requires preview_url.", "title": "Hosting Visual Inspect", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Post-publish layout smoke (overflow/CTA/viewports) — not a substitute for hosting.site.edge_health.", "write_mode": null}, {"action": "hosting.workspace.import_tree", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Import seeds workspace sources — follow with hosting.site.build, not deploy_files to live.", "anti_patterns": ["Import seeds workspace sources — follow with hosting.site.build, not deploy_files to live."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.import_tree", "mutation_risk": "low", "related_tools": ["hosting.workspace.files.list", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace Import Tree", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Copy an allowlisted directory into workspace sources. hosting.deploy_files is the live hotfix path, not the source tree."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.import_tree", "mutation_risk": "low", "related_tools": ["hosting.workspace.files.list", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace Import Tree", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Copy an allowlisted directory into workspace sources. hosting.deploy_files is the live hotfix path, not the source tree."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Platform shell manifest import", "request": {"params": {"bucket_name": "frontend", "paths": ["agentstack-frontend", "agentstack-unified-sdk", "shared-ui", "scripts/docker"], "project_id": 1, "source_root": "/opt/agentstack"}, "tool": "hosting.workspace.import_tree"}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_COPYTREE_ANTIPATTERN": "Do not hosting.deploy_files an entire compiled SPA into preview/dev. Use hosting.site.build target=dev, hosting.workspace.import_tree, or ops seed_dev_preview_minimal — never bulk-copy live current/ as deploy_files. Symlink fallback on disk copies public live root only (not releases/).", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Copy an allowlisted directory into workspace sources. hosting.deploy_files is the live hotfix path,…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.workspace.files.list", "hosting.site.build"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_workspace_import_tree", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Copy an allowlisted source directory into the bucket workspace. Does not publish. hosting.deploy_files writes live bytes, not this tree.", "title": "Hosting Workspace Import Tree", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_blocked_locales": {"validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_to_use": "Copy an allowlisted directory into workspace sources. hosting.deploy_files is the live hotfix path, not the source tree.", "write_mode": null}, {"action": "hosting.site.settings.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.settings.patch", "mutation_risk": "low", "related_tools": ["hosting.project.set_primary_site", "hosting.site.build", "hosting.release.snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Settings Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Set mount_apex_hosts, csp_profile, or git upstream on one site. Same-edge host pointer. DNS and certificates stay a separate backlog."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.settings.patch", "mutation_risk": "low", "related_tools": ["hosting.project.set_primary_site", "hosting.site.build", "hosting.release.snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Settings Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Set mount_apex_hosts, csp_profile, or git upstream on one site. Same-edge host pointer. DNS and certificates stay a separate backlog."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Set mount_apex_hosts, csp_profile, or git upstream on one site. Same-edge host pointer. DNS and cer…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.set_primary_site", "hosting.site.build", "hosting.release.snapshot"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_site_settings_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch mount_apex_hosts, csp_profile, and git upstream on one site. This is the same-edge domain connection (hosting.domain.connect).", "title": "Hosting Site Settings Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}, "validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_to_use": "Set mount_apex_hosts, csp_profile, or git upstream on one site. Same-edge host pointer. DNS and certificates stay a separate backlog.", "write_mode": null}, {"action": "hosting.domain.connect", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.domain.connect", "mutation_risk": "low", "related_tools": ["hosting.site.settings.patch", "hosting.site.edge_health", "hosting.release.snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Domain Connect", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Point an already-served hostname at this site's current build. Same leaf as hosting.site.settings.patch mount_apex_hosts. DNS and certificates stay backlog."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.domain.connect", "mutation_risk": "low", "related_tools": ["hosting.site.settings.patch", "hosting.site.edge_health", "hosting.release.snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Domain Connect", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Point an already-served hostname at this site's current build. Same leaf as hosting.site.settings.patch mount_apex_hosts. DNS and certificates stay backlog."}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Point an already-served hostname at this site's current build. Same leaf as hosting.site.settings.p…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.site.settings.patch", "hosting.site.edge_health", "hosting.release.snapshot"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_domain_connect", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Alias of hosting.site.settings.patch for mount_apex_hosts on an already-served host.", "title": "Hosting Domain Connect", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_blocked_locales": {"site_not_found": {"en-US": "Site missing — hosting.project.status before file get/patch", "pt-BR": "Site ausente — hosting.project.status antes de file get/patch", "ru-RU": "Сайт не найден — hosting.project.status перед file get/patch"}, "validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_to_use": "Point an already-served hostname at this site's current build. Same leaf as hosting.site.settings.patch mount_apex_hosts. DNS and certificates stay backlog.", "write_mode": null}, {"action": "hosting.git.init", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.init", "mutation_risk": "low", "related_tools": ["hosting.git.status", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Init", "when_blocked": {"batch_semantic_anchor_required": "Default async=true still needs a batch anchor: options.execution_intent=direct, options.goal, or preflight.check. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor.", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "git_binary_missing": "Rebuild backend image (apt git); optional GIT_BINARY env", "git_failed:checkout": "Could not checkout dev or main — hosting.git.init refreshes the journal hooks", "git_failed:init": "hosting.git.init failed — check API image has git; then platform_shell_seed", "git_push_body_too_large": "Push pack exceeded API body cap or nginx limit — never commit node_modules/dist; sources only; VPS runs site.build.yaml npm ci + vite", "git_symlink_failed": "Smart HTTP git requires Linux VPS _sources symlink layout", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen the key with apikeys.create preset user_full, or Device Code --scope-preset=full. Same denial on hosting.git.init, hosting.workspace.init, and hosting.site.build.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create platform git (branches dev and main) on the protected source tree. Push to remote branch dev (not master) for preview build — post-receive enqueues hosting.site.build. Poll hosting.site.build_s"}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.init", "mutation_risk": "low", "related_tools": ["hosting.git.status", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Init", "when_blocked": {"batch_semantic_anchor_required": "Default async=true still needs a batch anchor: options.execution_intent=direct, options.goal, or preflight.check. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor.", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "git_binary_missing": "Rebuild backend image (apt git); optional GIT_BINARY env", "git_failed:checkout": "Could not checkout dev or main — hosting.git.init refreshes the journal hooks", "git_failed:init": "hosting.git.init failed — check API image has git; then platform_shell_seed", "git_push_body_too_large": "Push pack exceeded API body cap or nginx limit — never commit node_modules/dist; sources only; VPS runs site.build.yaml npm ci + vite", "git_symlink_failed": "Smart HTTP git requires Linux VPS _sources symlink layout", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen the key with apikeys.create preset user_full, or Device Code --scope-preset=full. Same denial on hosting.git.init, hosting.workspace.init, and hosting.site.build.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create platform git (branches dev and main) on the protected source tree. Push to remote branch dev (not master) for preview build — post-receive enqueues hosting.site.build. Poll hosting.site.build_s"}, "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Init frontend journal", "request": {"params": {"bucket_name": "frontend", "project_id": 1}, "tool": "hosting.git.init"}}, {"name": "Second bucket (messenger)", "request": {"params": {"bucket_name": "messenger", "project_id": 1}, "tool": "hosting.git.init"}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_BATCH_SEMANTIC_ANCHOR": "Sync hosting mutations need a batch anchor: options.execution_intent=direct, options.goal, or preflight.check in the same execute. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor. Poll hosting.site.build_status in a separate execute — one job_id per poll loop; honor poll_backoff_ms; stop when status is completed|failed|cancelled or on job_not_found (re-list via hosting.project.status then hosting.site.build).", "HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_GIT_PLANE_CHOOSER": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branches dev or main. (2) generation.promote moves 8DNA only (config, fleet, knowledge) — not site bytes. Pass env_uuid on the write params. Skip a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. (3) Platform checkouts agentstack-core and shared often have no git remote — they ship by VPS deploy. Empty origin means do not git push origin. agentstack-frontend tracks agentstack/dev. 'push to dev' is plane 1, not generation.promote and not target=prod.", "HOSTING_MCP_AUTH_FOR_MUTATIONS": "hosting.* writes need session_ready + can_execute_mutation + service caps (user_full / Connect OAuth). service_cap_denied on hosting.workspace.init: widen API key (apikeys.create preset user_full) or Device Code --scope-preset=full — same recovery as other MCP mutations. VPS SSH scripts are ops fallback only; agents should use MCP with context.project_id on every execute. CLI bridge: node provided_plugins/cursor-plugin/scripts/mcp-execute.mjs --project-id <pid> --execution-intent direct <action> --params '{...}' (avoids batch_semantic_anchor_required).", "HOSTING_SUBMODULE_LINK_MISSING": "App .gitmodules URL https://agentstack.tech/api/git/1/sdk.git (or shared-ui) must resolve to projects/1/_sources/{bucket} on the worker. One-time: hosting.git.init project_id=1 bucket_name=sdk and shared-ui (or ops setup_platform_git_library.py). The build symlinks vendor/ — no import_tree or git submodule update on the worker. Fix .gitmodules paths, push HEAD:dev, poll build_status.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": [{"action": "hosting.git.status", "params": {"bucket_name": "<from init>", "project_id": "<context.project_id>"}, "why": "Confirm journal is clean. Next is a local `git push agentstack HEAD:dev` — init does not push."}, {"action": "hosting.site.build_status", "params": {"job_id": "<from post-receive after push>"}, "why": "Poll until completed; preview URL /s/{project_id}/{bucket_name}--dev/"}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_git_journal", "agentstack_hosting_workspace_build"], "related_tools": ["hosting.git.status", "hosting.site.build"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_git_init", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Init platform git on the protected source folder. Branches dev and main. Post-receive enqueues preview on push to dev and production on push to main — poll hosting.site.build_status; do not assume URL", "title": "Hosting Git Init", "when_blocked": {"batch_semantic_anchor_required": "Default async=true still needs a batch anchor: options.execution_intent=direct, options.goal, or preflight.check. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor.", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "git_binary_missing": "Rebuild backend image (apt git); optional GIT_BINARY env", "git_failed:checkout": "Could not checkout dev or main — hosting.git.init refreshes the journal hooks", "git_failed:init": "hosting.git.init failed — check API image has git; then platform_shell_seed", "git_push_body_too_large": "Push pack exceeded API body cap or nginx limit — never commit node_modules/dist; sources only; VPS runs site.build.yaml npm ci + vite", "git_symlink_failed": "Smart HTTP git requires Linux VPS _sources symlink layout", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen the key with apikeys.create preset user_full, or Device Code --scope-preset=full. Same denial on hosting.git.init, hosting.workspace.init, and hosting.site.build.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_to_use": "Create platform git (branches dev and main) on the protected source tree. Push to remote branch dev (not master) for preview build — post-receive enqueues hosting.site.build. Poll hosting.site.build_s", "write_mode": null}, {"action": "hosting.git.status", "aliases": ["git.list_repos", "git.status"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.status", "related_tools": ["hosting.git.pull_upstream", "hosting.git.init", "hosting.git.log", "hosting.site.quick_start", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Status", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "git_failed:status": "Journal git broken — hosting.git.init or platform_shell_seed then re-init", "git_push_body_too_large": "Push pack exceeded API body cap or nginx limit — never commit node_modules/dist; sources only; VPS runs site.build.yaml npm ci + vite", "git_repo_missing": "Existing bucket: hosting.git.init with bucket_name or bucket_id. hosting.site.quick_start only when hosting.project.status shows no site.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Porcelain of the protected journal. Dirty tracked files block promote. Untracked docs are ignored. Next: hosting.git.log or push HEAD:dev / HEAD:main."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.status", "related_tools": ["hosting.git.pull_upstream", "hosting.git.init", "hosting.git.log", "hosting.site.quick_start", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Status", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "git_failed:status": "Journal git broken — hosting.git.init or platform_shell_seed then re-init", "git_push_body_too_large": "Push pack exceeded API body cap or nginx limit — never commit node_modules/dist; sources only; VPS runs site.build.yaml npm ci + vite", "git_repo_missing": "Existing bucket: hosting.git.init with bucket_name or bucket_id. hosting.site.quick_start only when hosting.project.status shows no site.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Porcelain of the protected journal. Dirty tracked files block promote. Untracked docs are ignored. Next: hosting.git.log or push HEAD:dev / HEAD:main."}, "do_not_use_when": "Before hosting.git.init on the bucket — status requires a journal repo.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Status by bucket name", "request": {"params": {"bucket_name": "studio", "project_id": 1600}, "tool": "hosting.git.status"}}], "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_GIT_PLANE_CHOOSER": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branches dev or main. (2) generation.promote moves 8DNA only (config, fleet, knowledge) — not site bytes. Pass env_uuid on the write params. Skip a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. (3) Platform checkouts agentstack-core and shared often have no git remote — they ship by VPS deploy. Empty origin means do not git push origin. agentstack-frontend tracks agentstack/dev. 'push to dev' is plane 1, not generation.promote and not target=prod.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.git.pull_upstream", "hosting.git.init", "hosting.git.log", "hosting.site.quick_start", "hosting.site.build"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_git_status", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Git status of the protected source tree.", "title": "Hosting Git Status", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "git_failed:status": "Journal git broken — hosting.git.init or platform_shell_seed then re-init", "git_push_body_too_large": "Push pack exceeded API body cap or nginx limit — never commit node_modules/dist; sources only; VPS runs site.build.yaml npm ci + vite", "git_repo_missing": "Existing bucket: hosting.git.init with bucket_name or bucket_id. hosting.site.quick_start only when hosting.project.status shows no site.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_not_to_use": "Before hosting.git.init on the bucket — status requires a journal repo.", "when_to_use": "Porcelain of the protected journal. Dirty tracked files block promote. Untracked docs are ignored. Next: hosting.git.log or push HEAD:dev / HEAD:main.", "write_mode": null}, {"action": "hosting.git.log", "aliases": ["git.log"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.log", "related_tools": ["hosting.git.status", "hosting.git.promote_branch", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Log", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "git_cursor_invalid": "cursor must be a hex commit SHA from prior next_cursor", "git_failed:log": "Could not read journal log — hosting.git.status then hosting.git.init", "git_ref_not_allowed": "Use ref main or dev only — public changelog uses the same refs", "git_repo_missing": "Journal not initialized: hosting.git.log returns ok:true with entries:[] (not a hard error). Run hosting.git.init before expecting history.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Paginated journal history. Each entry includes task_ids parsed from AgentStack-Task / Task-Id / Work-Graph trailers (Work Graph node ids). Players read /s/{pid}/{bucket}/changelog.json after hosting.s"}, "capability_descriptor_slim": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.log", "related_tools": ["hosting.git.status", "hosting.git.promote_branch", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Log", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "git_cursor_invalid": "cursor must be a hex commit SHA from prior next_cursor", "git_failed:log": "Could not read journal log — hosting.git.status then hosting.git.init", "git_ref_not_allowed": "Use ref main or dev only — public changelog uses the same refs", "git_repo_missing": "Journal not initialized: hosting.git.log returns ok:true with entries:[] (not a hard error). Run hosting.git.init before expecting history.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Paginated journal history. Each entry includes task_ids parsed from AgentStack-Task / Task-Id / Work-Graph trailers (Work Graph node ids). Players read /s/{pid}/{bucket}/changelog.json after hosting.s"}, "do_not_use_when": "Player-facing patch notes after build — fetch /s/{pid}/{bucket}/changelog.json (preview: {bucket}--dev). Use hosting.git.log only for operator pagination and task_ids.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_GIT_PLANE_CHOOSER": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branches dev or main. (2) generation.promote moves 8DNA only (config, fleet, knowledge) — not site bytes. Pass env_uuid on the write params. Skip a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. (3) Platform checkouts agentstack-core and shared often have no git remote — they ship by VPS deploy. Empty origin means do not git push origin. agentstack-frontend tracks agentstack/dev. 'push to dev' is plane 1, not generation.promote and not target=prod.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Paginated journal history. Each entry includes task_ids parsed from AgentStack-Task / Task-Id / Wor…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": [{"action": "hosting.git.log", "params": {"bucket_name": "<from prior result>", "limit": 20, "project_id": "<context.project_id>", "ref": "dev"}, "why": "First page of journal; pass cursor=next_cursor from the result for older commits."}, {"action": "hosting.site.build", "params": {"bucket_name": "<from prior result>", "project_id": "<context.project_id>", "publish": true, "target": "dev"}, "why": "Regenerate public changelog.json/html after new commits land on dev or main."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.git.status", "hosting.git.promote_branch", "hosting.site.build"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_git_log", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Paginated git log (main|dev). Returns task_ids from AgentStack-Task trailers (Work Graph node id). Public changelog.json is the player feed.", "title": "Hosting Git Log", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "git_cursor_invalid": "cursor must be a hex commit SHA from prior next_cursor", "git_failed:log": "Could not read journal log — hosting.git.status then hosting.git.init", "git_ref_not_allowed": "Use ref main or dev only — public changelog uses the same refs", "git_repo_missing": "Journal not initialized: hosting.git.log returns ok:true with entries:[] (not a hard error). Run hosting.git.init before expecting history.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {}, "when_not_to_use": "Player-facing patch notes after build — fetch /s/{pid}/{bucket}/changelog.json (preview: {bucket}--dev). Use hosting.git.log only for operator pagination and task_ids.", "when_to_use": "Paginated journal history. Each entry includes task_ids parsed from AgentStack-Task / Task-Id / Work-Graph trailers (Work Graph node ids). Players read /s/{pid}/{bucket}/changelog.json after hosting.s", "write_mode": null}, {"action": "hosting.git.pull_upstream", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.pull_upstream", "mutation_risk": "low", "related_tools": ["hosting.git.status", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Pull Upstream", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "git_binary_missing": "Rebuild backend image (apt git); optional GIT_BINARY env", "git_dirty": "Commit or reset the journal before pull_upstream or git_commit on a dirty tree", "git_failed:fetch": "Upstream fetch failed — hosting.git.status; fix remote URL or credentials", "git_failed:merge": "Merge onto dev failed — hosting.git.status. Dirty tree is git_dirty. hosting.git.promote_branch retries ff then a merge commit; pull_upstream stays ff-only.", "git_repo_missing": "Existing bucket: hosting.git.init with bucket_name or bucket_id. hosting.site.quick_start only when hosting.project.status shows no site.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Fast-forward an optional GitHub or GitLab upstream into platform git. Refuses a dirty tree. Does not promote production. The token is not stored in git config. Param branch defaults to dev and does no"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.pull_upstream", "mutation_risk": "low", "related_tools": ["hosting.git.status", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Pull Upstream", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "git_binary_missing": "Rebuild backend image (apt git); optional GIT_BINARY env", "git_dirty": "Commit or reset the journal before pull_upstream or git_commit on a dirty tree", "git_failed:fetch": "Upstream fetch failed — hosting.git.status; fix remote URL or credentials", "git_failed:merge": "Merge onto dev failed — hosting.git.status. Dirty tree is git_dirty. hosting.git.promote_branch retries ff then a merge commit; pull_upstream stays ff-only.", "git_repo_missing": "Existing bucket: hosting.git.init with bucket_name or bucket_id. hosting.site.quick_start only when hosting.project.status shows no site.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Fast-forward an optional GitHub or GitLab upstream into platform git. Refuses a dirty tree. Does not promote production. The token is not stored in git config. Param branch defaults to dev and does no"}, "do_not_use_when": "Before hosting.git.init or when porcelain is dirty.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_GIT_PLANE_CHOOSER": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branches dev or main. (2) generation.promote moves 8DNA only (config, fleet, knowledge) — not site bytes. Pass env_uuid on the write params. Skip a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. (3) Platform checkouts agentstack-core and shared often have no git remote — they ship by VPS deploy. Empty origin means do not git push origin. agentstack-frontend tracks agentstack/dev. 'push to dev' is plane 1, not generation.promote and not target=prod.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Fast-forward an optional GitHub or GitLab upstream into platform git. Refuses a dirty tree. Does no…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": [{"action": "hosting.site.build", "params": {"bucket_name": "<from prior result>", "project_id": "<context.project_id>", "publish": true, "target": "dev"}, "why": "Rebuild preview after ff-only pull. Pass the same project_id and bucket_name."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.git.status", "hosting.site.build"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_git_pull_upstream", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Fast-forward optional upstream into platform git. Refuses a dirty tree. Token is not stored in the site leaf. Then build target=dev yourself.", "title": "Hosting Git Pull Upstream", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "git_binary_missing": "Rebuild backend image (apt git); optional GIT_BINARY env", "git_dirty": "Commit or reset the journal before pull_upstream or git_commit on a dirty tree", "git_failed:fetch": "Upstream fetch failed — hosting.git.status; fix remote URL or credentials", "git_failed:merge": "Merge onto dev failed — hosting.git.status. Dirty tree is git_dirty. hosting.git.promote_branch retries ff then a merge commit; pull_upstream stays ff-only.", "git_repo_missing": "Existing bucket: hosting.git.init with bucket_name or bucket_id. hosting.site.quick_start only when hosting.project.status shows no site.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_blocked_locales": {"validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_not_to_use": "Before hosting.git.init or when porcelain is dirty.", "when_to_use": "Fast-forward an optional GitHub or GitLab upstream into platform git. Refuses a dirty tree. Does not promote production. The token is not stored in git config. Param branch defaults to dev and does no", "write_mode": null}, {"action": "hosting.git.promote_branch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.promote_branch", "mutation_risk": "low", "related_tools": ["hosting.git.status", "hosting.site.build_status", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Promote Branch", "when_blocked": {"batch_semantic_anchor_required": "Default async=true still needs a batch anchor: options.execution_intent=direct, options.goal, or preflight.check. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor.", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "first_prod": "When refs/heads/main is still the lone init commit, use hosting.git.promote_branch ref=dev target=prod — not git push dev:main (unrelated histories).", "git_argv_rejected": "Server git allowlist blocked a prod worktree step (often reset --hard HEAD after ensure_prod_worktree). Check system.version build_id/git_sha — stale image if fix missing. Until RebuildBackend ships hosting_git_sync reset allowlist: (1) hosting.site.build target=dev publish=true async=true, poll build_status; (2) hosting.release.list; (3) hosting.release.promote with release_uuid only (omit bucket_id on nano site ids); (4) hosting.site.edge_health. Do not loop promote_branch target=prod on the same error.", "git_binary_missing": "Rebuild backend image (apt git); optional GIT_BINARY env", "git_dirty": "Commit or reset the journal before pull_upstream or git_commit on a dirty tree", "git_failed:checkout": "Could not checkout dev or main — hosting.git.init refreshes the journal hooks", "git_failed:merge": "Merge onto dev failed — hosting.git.status. Dirty tree is git_dirty. hosting.git.promote_branch retries ff then a merge commit; pull_upstream stays ff-only.", "git_not_ff": "main is not a fast-forward of this ref. Push the prod commit onto main, or merge main into dev first. promote_branch does not rewind main.", "git_push_body_too_large": "Push pack exceeded API body cap or nginx limit — never commit node_modules/dist; sources only; VPS runs site.build.yaml npm ci + vite", "git_ref_missing": "Ref is not on this journal — git push the branch first, then hosting.git.promote_branch", "git_ref_not_on_dev": "target=prod requires the ref already on dev. hosting.git.promote_branch target=dev first, open /s/{project_id}/{bucket}--dev/, then target=prod ref=dev. That fast-forwards main. A direct git push to main also builds production.", "git_repo_missing": "Existing bucket: hosting.git.init with bucket_name or bucket_id. hosting.site.quick_start only when hosting.project.status shows no site.", "git_worktree_update_failed": "quick_start left untracked index.html — hosting.git.init scrubs stubs and sets receive.denyCurrentBranch=ignore; push dev again", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen the key with apikeys.create preset user_full, or Device Code --scope-preset=full. Same denial on hosting.git.init, hosting.workspace.init, and hosting.site.build.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unrelated_main_init": "Git client rejected dev:main — server main placeholder is not an ancestor of dev. Use hosting.git.promote_branch ref=dev target=prod, then poll hosting.site.build_status.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Hosting git only — not generation.promote (8DNA) and not a local origin push. Param is bucket_id, not bucket. Land any journal ref on dev, or fast-forward main for production. target=dev (default) mer"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.promote_branch", "mutation_risk": "low", "related_tools": ["hosting.git.status", "hosting.site.build_status", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Promote Branch", "when_blocked": {"batch_semantic_anchor_required": "Default async=true still needs a batch anchor: options.execution_intent=direct, options.goal, or preflight.check. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor.", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "first_prod": "When refs/heads/main is still the lone init commit, use hosting.git.promote_branch ref=dev target=prod — not git push dev:main (unrelated histories).", "git_argv_rejected": "Server git allowlist blocked a prod worktree step (often reset --hard HEAD after ensure_prod_worktree). Check system.version build_id/git_sha — stale image if fix missing. Until RebuildBackend ships hosting_git_sync reset allowlist: (1) hosting.site.build target=dev publish=true async=true, poll build_status; (2) hosting.release.list; (3) hosting.release.promote with release_uuid only (omit bucket_id on nano site ids); (4) hosting.site.edge_health. Do not loop promote_branch target=prod on the same error.", "git_binary_missing": "Rebuild backend image (apt git); optional GIT_BINARY env", "git_dirty": "Commit or reset the journal before pull_upstream or git_commit on a dirty tree", "git_failed:checkout": "Could not checkout dev or main — hosting.git.init refreshes the journal hooks", "git_failed:merge": "Merge onto dev failed — hosting.git.status. Dirty tree is git_dirty. hosting.git.promote_branch retries ff then a merge commit; pull_upstream stays ff-only.", "git_not_ff": "main is not a fast-forward of this ref. Push the prod commit onto main, or merge main into dev first. promote_branch does not rewind main.", "git_push_body_too_large": "Push pack exceeded API body cap or nginx limit — never commit node_modules/dist; sources only; VPS runs site.build.yaml npm ci + vite", "git_ref_missing": "Ref is not on this journal — git push the branch first, then hosting.git.promote_branch", "git_ref_not_on_dev": "target=prod requires the ref already on dev. hosting.git.promote_branch target=dev first, open /s/{project_id}/{bucket}--dev/, then target=prod ref=dev. That fast-forwards main. A direct git push to main also builds production.", "git_repo_missing": "Existing bucket: hosting.git.init with bucket_name or bucket_id. hosting.site.quick_start only when hosting.project.status shows no site.", "git_worktree_update_failed": "quick_start left untracked index.html — hosting.git.init scrubs stubs and sets receive.denyCurrentBranch=ignore; push dev again", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen the key with apikeys.create preset user_full, or Device Code --scope-preset=full. Same denial on hosting.git.init, hosting.workspace.init, and hosting.site.build.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unrelated_main_init": "Git client rejected dev:main — server main placeholder is not an ancestor of dev. Use hosting.git.promote_branch ref=dev target=prod, then poll hosting.site.build_status.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Hosting git only — not generation.promote (8DNA) and not a local origin push. Param is bucket_id, not bucket. Land any journal ref on dev, or fast-forward main for production. target=dev (default) mer"}, "do_not_use_when": "8DNA config/fleet/knowledge — generation.promote. hosting.release.promote — snapshot rollback, not journal ship. Platform agentstack-core or shared with an empty origin — VPS deploy, not this action. Default preview is git push agentstack HEAD:dev; target=prod is the live site.", "domain": "hosting", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Publish tested dev to prod", "request": {"params": {"bucket_name": "frontend", "project_id": 1, "ref": "dev", "target": "prod"}, "tool": "hosting.git.promote_branch"}}, {"name": "Feature branch onto dev preview", "request": {"params": {"bucket_name": "frontend", "project_id": 1, "ref": "feature/my-branch", "target": "dev"}, "tool": "hosting.git.promote_branch"}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_BATCH_SEMANTIC_ANCHOR": "Sync hosting mutations need a batch anchor: options.execution_intent=direct, options.goal, or preflight.check in the same execute. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor. Poll hosting.site.build_status in a separate execute — one job_id per poll loop; honor poll_backoff_ms; stop when status is completed|failed|cancelled or on job_not_found (re-list via hosting.project.status then hosting.site.build).", "HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_GIT_PLANE_CHOOSER": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branches dev or main. (2) generation.promote moves 8DNA only (config, fleet, knowledge) — not site bytes. Pass env_uuid on the write params. Skip a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. (3) Platform checkouts agentstack-core and shared often have no git remote — they ship by VPS deploy. Empty origin means do not git push origin. agentstack-frontend tracks agentstack/dev. 'push to dev' is plane 1, not generation.promote and not target=prod.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.git.status", "hosting.site.build_status", "hosting.site.build"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_git_promote_branch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Land any journal branch on dev (preview) or fast-forward main for production. target=dev merges ref onto refs/heads/dev and enqueues the preview build. target=prod requires the ref already on dev, fas", "title": "Hosting Git Promote Branch", "when_blocked": {"batch_semantic_anchor_required": "Default async=true still needs a batch anchor: options.execution_intent=direct, options.goal, or preflight.check. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor.", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "first_prod": "When refs/heads/main is still the lone init commit, use hosting.git.promote_branch ref=dev target=prod — not git push dev:main (unrelated histories).", "git_argv_rejected": "Server git allowlist blocked a prod worktree step (often reset --hard HEAD after ensure_prod_worktree). Check system.version build_id/git_sha — stale image if fix missing. Until RebuildBackend ships hosting_git_sync reset allowlist: (1) hosting.site.build target=dev publish=true async=true, poll build_status; (2) hosting.release.list; (3) hosting.release.promote with release_uuid only (omit bucket_id on nano site ids); (4) hosting.site.edge_health. Do not loop promote_branch target=prod on the same error.", "git_binary_missing": "Rebuild backend image (apt git); optional GIT_BINARY env", "git_dirty": "Commit or reset the journal before pull_upstream or git_commit on a dirty tree", "git_failed:checkout": "Could not checkout dev or main — hosting.git.init refreshes the journal hooks", "git_failed:merge": "Merge onto dev failed — hosting.git.status. Dirty tree is git_dirty. hosting.git.promote_branch retries ff then a merge commit; pull_upstream stays ff-only.", "git_not_ff": "main is not a fast-forward of this ref. Push the prod commit onto main, or merge main into dev first. promote_branch does not rewind main.", "git_push_body_too_large": "Push pack exceeded API body cap or nginx limit — never commit node_modules/dist; sources only; VPS runs site.build.yaml npm ci + vite", "git_ref_missing": "Ref is not on this journal — git push the branch first, then hosting.git.promote_branch", "git_ref_not_on_dev": "target=prod requires the ref already on dev. hosting.git.promote_branch target=dev first, open /s/{project_id}/{bucket}--dev/, then target=prod ref=dev. That fast-forwards main. A direct git push to main also builds production.", "git_repo_missing": "Existing bucket: hosting.git.init with bucket_name or bucket_id. hosting.site.quick_start only when hosting.project.status shows no site.", "git_worktree_update_failed": "quick_start left untracked index.html — hosting.git.init scrubs stubs and sets receive.denyCurrentBranch=ignore; push dev again", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen the key with apikeys.create preset user_full, or Device Code --scope-preset=full. Same denial on hosting.git.init, hosting.workspace.init, and hosting.site.build.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unrelated_main_init": "Git client rejected dev:main — server main placeholder is not an ancestor of dev. Use hosting.git.promote_branch ref=dev target=prod, then poll hosting.site.build_status.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_blocked_locales": {"validation_error": {"en-US": "Base64 invalid — pad length % 4 or use UTF-8 / hosting.bucket.file.patch", "pt-BR": "Base64 inválido — pad length % 4 ou use UTF-8 / hosting.bucket.file.patch", "ru-RU": "Base64 невалиден — pad до length % 4 или UTF-8 / hosting.bucket.file.patch"}}, "when_not_to_use": "8DNA config/fleet/knowledge — generation.promote. hosting.release.promote — snapshot rollback, not journal ship. Platform agentstack-core or shared with an empty origin — VPS deploy, not this action. Default preview is git push agentstack HEAD:dev; target=prod is the live site.", "when_to_use": "Hosting git only — not generation.promote (8DNA) and not a local origin push. Param is bucket_id, not bucket. Land any journal ref on dev, or fast-forward main for production. target=dev (default) mer", "write_mode": null}, {"action": "dna.lineage.get_ancestors", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "dna", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.dna.lineage.gen1"], "id": "dna.lineage.get_ancestors", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Dna Lineage Get Ancestors", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "8DNA ancestor chain for sandbox/prod lineage triage."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "dna", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.dna.lineage.gen1"], "id": "dna.lineage.get_ancestors", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Dna Lineage Get Ancestors", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "8DNA ancestor chain for sandbox/prod lineage triage."}, "domain": "dna", "domain_title": "Dna Lineage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["shared.dna.lineage.gen1"], "instruction_hint": "8DNA ancestor chain for sandbox/prod lineage triage.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.dna_lineage", "owner_gene": "shared.dna.lineage.gen1", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "required_cap": "8dna.read", "requires_preflight": false, "risk_class": "read", "safe_action": "dna_lineage_get_ancestors", "semantic_input_mode": "inherit_workflow", "summary": "Walk ancestor chain for an 8DNA row (materialized path or scoped CTE fallback).", "title": "Dna Lineage Get Ancestors", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "8DNA ancestor chain for sandbox/prod lineage triage.", "write_mode": null}, {"action": "dna.lineage.get_descendants", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "dna", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.dna.lineage.gen1"], "id": "dna.lineage.get_descendants", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Dna Lineage Get Descendants", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List child generations under parent UUID."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "dna", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.dna.lineage.gen1"], "id": "dna.lineage.get_descendants", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Dna Lineage Get Descendants", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List child generations under parent UUID."}, "domain": "dna", "domain_title": "Dna Lineage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["shared.dna.lineage.gen1"], "instruction_hint": "List child generations under parent UUID.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.dna_lineage", "owner_gene": "shared.dna.lineage.gen1", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "required_cap": "8dna.read", "requires_preflight": false, "risk_class": "read", "safe_action": "dna_lineage_get_descendants", "semantic_input_mode": "inherit_workflow", "summary": "List descendant rows under a parent UUID within project scope.", "title": "Dna Lineage Get Descendants", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List child generations under parent UUID.", "write_mode": null}, {"action": "docs_nav.resolve", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.engineering.ai_navigation.gen1"], "id": "docs_nav.resolve", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Docs Nav Resolve", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Resolve genetic tag to AI_INDEX path — not MCP tool routing."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.engineering.ai_navigation.gen1"], "id": "docs_nav.resolve", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Docs Nav Resolve", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Resolve genetic tag to AI_INDEX path — not MCP tool routing."}, "domain": "docs_nav", "domain_title": "Docs Nav MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["repo.engineering.ai_navigation.gen1"], "instruction_hint": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.docs_nav", "owner_gene": "repo.engineering.ai_navigation.gen1", "plane": "Gene map only: docs_nav.search query=. Runtime tools: discovery.search.", "plane_chooser": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools.", "platform_atoms": {"BATCH_DEPENDS_ON_DEFAULTS": "agentstack.execute steps: omit dependsOn for independent lanes; set dependsOn to prior step ids for DAG order. continueOnError defaults false — failed step skips dependents (plain reads may continue per mixed-batch policy). See agentstack-work-graph skill.", "DEPLOY_SUBSTRATE_SKEW": "After VPS ship, MCP batches may return preflight_batch_internal_error when hot-sync manifest omits import mates (e.g. shared/mcp/session_readiness.py). Recovery: npm run audit:deploy-hot-sync-manifests, mcp.prod_matrix_hot_sync, or -RebuildBackend (default DeployComponent=backend). Not OAuth Connect until auth.get_profile fails.", "DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools.", "PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "requires_preflight": false, "risk_class": "read", "safe_action": "docs_nav_resolve", "semantic_input_mode": "inherit_workflow", "summary": "Resolve a genetic navigation tag to AI_INDEX path(s) from TAG_CATALOG. For code/docs navigation only — for runtime MCP tools use discover/by_intent.", "title": "Docs Nav Resolve", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Docs-navigation surface only — not agentstack.execute routing. Use discovery.search for runnable MCP actions.", "when_to_use": "Resolve genetic tag to AI_INDEX path — not MCP tool routing.", "write_mode": null}, {"action": "docs_nav.search", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.engineering.ai_navigation.gen1"], "id": "docs_nav.search", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Docs Nav Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Docs-nav BM25 only — runtime tools: discover/by_intent or /mcp/actions."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.engineering.ai_navigation.gen1"], "id": "docs_nav.search", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Docs Nav Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Docs-nav BM25 only — runtime tools: discover/by_intent or /mcp/actions."}, "domain": "docs_nav", "domain_title": "Docs Nav MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["repo.engineering.ai_navigation.gen1"], "instruction_hint": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.docs_nav", "owner_gene": "repo.engineering.ai_navigation.gen1", "plane": "Gene map only: docs_nav.search query=. Runtime tools: discovery.search.", "plane_chooser": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools.", "platform_atoms": {"BATCH_DEPENDS_ON_DEFAULTS": "agentstack.execute steps: omit dependsOn for independent lanes; set dependsOn to prior step ids for DAG order. continueOnError defaults false — failed step skips dependents (plain reads may continue per mixed-batch policy). See agentstack-work-graph skill.", "DEPLOY_SUBSTRATE_SKEW": "After VPS ship, MCP batches may return preflight_batch_internal_error when hot-sync manifest omits import mates (e.g. shared/mcp/session_readiness.py). Recovery: npm run audit:deploy-hot-sync-manifests, mcp.prod_matrix_hot_sync, or -RebuildBackend (default DeployComponent=backend). Not OAuth Connect until auth.get_profile fails.", "DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools.", "PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "requires_preflight": false, "risk_class": "read", "safe_action": "docs_nav_search", "semantic_input_mode": "inherit_workflow", "summary": "BM25-lite search over AI navigation catalog (map/index triggers). Returns genetic tags + AI_INDEX paths. Not for selecting runtime MCP tools.", "title": "Docs Nav Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Docs-navigation surface only — not agentstack.execute routing. Use discovery.search for runnable MCP actions.", "when_to_use": "Docs-nav BM25 only — runtime tools: discover/by_intent or /mcp/actions.", "write_mode": null}, {"action": "docs.schema.define", "ai_tips": "Before docs.analyze — store product_photo.v1 or custom extract schemas per project", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Unconditional DNA write to ecosystem.docs.schemas (not param-gated)", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.vision.domain.gen1"], "id": "docs.schema.define", "mutation_risk": "low", "read_paths": ["ecosystem.docs.schemas"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Docs Schema Define", "when_to_use": "Before docs.analyze — store product_photo.v1 or custom extract schemas per project", "write_paths": ["ecosystem.docs.schemas"]}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Unconditional DNA write to ecosystem.docs.schemas (not param-gated)", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.vision.domain.gen1"], "id": "docs.schema.define", "mutation_risk": "low", "read_paths": ["ecosystem.docs.schemas"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Docs Schema Define", "when_to_use": "Before docs.analyze — store product_photo.v1 or custom extract schemas per project", "write_paths": ["ecosystem.docs.schemas"]}, "domain": "docs", "domain_title": "Docs Schema MCP domain", "effect": {"conditional_mutate": "Unconditional DNA write to ecosystem.docs.schemas (not param-gated)", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Unconditional DNA write to ecosystem.docs.schemas (not param-gated)", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.docs_schema.gen1"], "instruction_hint": "Before docs.analyze — store product_photo.v1 or custom extract schemas per project", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.docs_schema", "owner_gene": "core.mcp.docs_schema.gen1", "read_paths": ["ecosystem.docs.schemas"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "docs_schema_define", "semantic_input_mode": "inherit_workflow", "summary": "Register or update a versioned JSON schema document in project DNA.", "title": "Docs Schema Define", "when_to_use": "Before docs.analyze — store product_photo.v1 or custom extract schemas per project", "write_mode": null, "write_paths": ["ecosystem.docs.schemas"]}, {"action": "docs.schema.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.docs.gen1"], "id": "docs.schema.list", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Docs Schema List", "when_to_use": "Discover schema_id before docs.analyze or vision.extract"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.docs.gen1"], "id": "docs.schema.list", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Docs Schema List", "when_to_use": "Discover schema_id before docs.analyze or vision.extract"}, "domain": "docs", "domain_title": "Docs Schema MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.docs_schema.gen1"], "instruction_hint": "Discover schema_id before docs.analyze or vision.extract", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.docs_schema", "owner_gene": "core.mcp.docs_schema.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "docs_schema_list", "semantic_input_mode": "inherit_workflow", "summary": "List schema ids registered under ecosystem.docs.schemas.", "title": "Docs Schema List", "when_to_use": "Discover schema_id before docs.analyze or vision.extract", "write_mode": null}, {"action": "docs.analyze", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.docs.gen1"], "id": "docs.analyze", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Docs Analyze", "when_to_use": "Pre-flight structured docs before vision.extract or commerce asset metadata"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.docs.gen1"], "id": "docs.analyze", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Docs Analyze", "when_to_use": "Pre-flight structured docs before vision.extract or commerce asset metadata"}, "domain": "docs", "domain_title": "Docs Schema MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.docs_schema.gen1"], "instruction_hint": "Pre-flight structured docs before vision.extract or commerce asset metadata", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.docs_schema", "owner_gene": "core.mcp.docs_schema.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "docs_analyze", "semantic_input_mode": "inherit_workflow", "summary": "Validate a JSON payload against a registered docs.schema (structural check).", "title": "Docs Analyze", "when_to_use": "Pre-flight structured docs before vision.extract or commerce asset metadata", "write_mode": null}, {"action": "docs.schema.delete", "ai_tips": "Drop obsolete schema_id (e.g. probe leaves) before re-defining docs.schema.", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.docs.gen1"], "id": "docs.schema.delete", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Docs Schema Delete", "when_to_use": "Drop obsolete schema_id (e.g. probe leaves) before re-defining docs.schema."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.docs.gen1"], "id": "docs.schema.delete", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Docs Schema Delete", "when_to_use": "Drop obsolete schema_id (e.g. probe leaves) before re-defining docs.schema."}, "domain": "docs", "domain_title": "Docs Schema MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.docs_schema.gen1"], "instruction_hint": "Drop obsolete schema_id (e.g. probe leaves) before re-defining docs.schema.", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.docs_schema", "owner_gene": "core.mcp.docs_schema.gen1", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "required_cap": "mcp_write", "requires_preflight": true, "risk_class": "destructive", "safe_action": "docs_schema_delete", "semantic_input_mode": "inherit_workflow", "summary": "Remove a registered docs schema leaf from project DNA.", "title": "Docs Schema Delete", "when_blocked": {"preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps)."}, "when_to_use": "Drop obsolete schema_id (e.g. probe leaves) before re-defining docs.schema.", "write_mode": null}, {"action": "energy.get_balance", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not treat balance check as a billed LLM completion.", "anti_patterns": ["Do not treat balance check as a billed LLM completion.", "Balance does not decrease until an LLM call completes — multi-step agents.run debits per call."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.energy.gen1"], "id": "energy.get_balance", "related_tools": ["energy.list_packs", "ai.providers.list", "energy.purchase"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Energy Get Balance", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "LLM prepaid energy before heavy knowledge/agents runs."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.energy.gen1"], "id": "energy.get_balance", "related_tools": ["energy.list_packs", "ai.providers.list", "energy.purchase"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Energy Get Balance", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "LLM prepaid energy before heavy knowledge/agents runs."}, "domain": "energy", "domain_title": "Energy MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile."}, "examples": [{"project_id": 1444, "refresh": false}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.energy.gen1", "core.economy.llm_energy.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "LLM prepaid energy before heavy knowledge/agents runs.", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["energy.list_packs", "agents.run", "ai.providers.list"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.energy", "owner_gene": "core.mcp.energy.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "related_tools": ["energy.list_packs", "ai.providers.list", "energy.purchase"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "energy_get_balance", "semantic_input_mode": "inherit_workflow", "summary": "LLM prepaid energy balance for user or project pool.", "title": "Energy Get Balance", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "LLM prepaid energy before heavy knowledge/agents runs.", "write_mode": null}, {"action": "energy.list_packs", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not call list_packs on every agents.run — reuse get_balance tiers.", "anti_patterns": ["Do not call list_packs on every agents.run — reuse get_balance tiers."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.energy.gen1"], "id": "energy.list_packs", "related_tools": ["energy.get_balance", "energy.purchase"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Energy List Packs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List purchasable energy packs and USD prices."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.energy.gen1"], "id": "energy.list_packs", "related_tools": ["energy.get_balance", "energy.purchase"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Energy List Packs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List purchasable energy packs and USD prices."}, "domain": "energy", "domain_title": "Energy MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.energy.gen1", "core.economy.llm_energy.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "List purchasable energy packs and USD prices.", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["energy.purchase", "energy.get_balance", "payments.create"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.energy", "owner_gene": "core.mcp.energy.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "related_tools": ["energy.get_balance", "energy.purchase"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "energy_list_packs", "semantic_input_mode": "inherit_workflow", "summary": "Available LLM energy pack tiers (small/medium/large) and USD prices.", "title": "Energy List Packs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List purchasable energy packs and USD prices.", "write_mode": null}, {"action": "energy.purchase", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not use energy.purchase for card checkout — use payments.create intent=energy_pack.", "anti_patterns": ["Do not use energy.purchase for card checkout — use payments.create intent=energy_pack."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.energy.gen1"], "id": "energy.purchase", "related_tools": ["finance.pay.quote", "finance.pay.execute", "energy.list_packs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Energy Purchase", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "use_payments_create": "Card checkout: payments.create intent=energy_pack, poll payments.get — not energy.purchase external_card. Next: payments.list_methods."}, "when_to_use": "Buy an LLM energy pack from a wallet with finance.pay. Card is payments.create intent=energy_pack, then poll payments.get until wallet_credit=ok."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.energy.gen1"], "id": "energy.purchase", "related_tools": ["finance.pay.quote", "finance.pay.execute", "energy.list_packs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Energy Purchase", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "use_payments_create": "Card checkout: payments.create intent=energy_pack, poll payments.get — not energy.purchase external_card. Next: payments.list_methods."}, "when_to_use": "Buy an LLM energy pack from a wallet with finance.pay. Card is payments.create intent=energy_pack, then poll payments.get until wallet_credit=ok."}, "domain": "energy", "domain_title": "Energy MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "use_payments_create": "Card checkout: payments.create intent=energy_pack, poll payments.get — not energy.purchase external_card. Next: payments.list_methods."}, "examples": [{"amount": 4.99, "idempotency_key": "energy-pack-…", "pack_tier": "small", "source": {"kind": "personal_wallet", "wallet_id": "…"}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.energy.gen1", "core.economy.llm_energy.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Buy an LLM energy pack from a wallet with finance.pay. Card is payments.create intent=energy_pack, …", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["energy.list_packs", "finance.pay.quote", "energy.get_balance"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.energy", "owner_gene": "core.mcp.energy.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "related_tools": ["finance.pay.quote", "finance.pay.execute", "energy.list_packs"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "energy_purchase", "semantic_input_mode": "inherit_workflow", "summary": "Buy an LLM energy pack from a wallet with finance.pay. Card is payments.create intent=energy_pack, then poll payments.get until wallet_credit=ok.", "title": "Energy Purchase", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "use_payments_create": "Card checkout: payments.create intent=energy_pack, poll payments.get — not energy.purchase external_card. Next: payments.list_methods."}, "when_to_use": "Buy an LLM energy pack from a wallet with finance.pay. Card is payments.create intent=energy_pack, then poll payments.get until wallet_credit=ok.", "write_mode": null}, {"action": "finance.portfolio", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.portfolio", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Portfolio", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "User finance hub aggregate (personal rails)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.portfolio", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Portfolio", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "User finance hub aggregate (personal rails)."}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "User finance hub aggregate (personal rails).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Open a wallet, then deposit in the next recipe with the copied wallet_id. This is the business status read. Do not call thirty raw payment tools. For shop order_id status use shop.orders.get — not this atom.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_portfolio", "semantic_input_mode": "inherit_workflow", "summary": "User finance portfolio aggregate (three rails + JSON wallets).", "title": "Finance Portfolio", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "User finance hub aggregate (personal rails).", "write_mode": null}, {"action": "finance.activity", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.activity", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Activity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Unified wallet activity feed for user."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.activity", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Activity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Unified wallet activity feed for user."}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Unified wallet activity feed for user.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Open a wallet, then deposit in the next recipe with the copied wallet_id. This is the business status read. Do not call thirty raw payment tools. For shop order_id status use shop.orders.get — not this atom.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_activity", "semantic_input_mode": "inherit_workflow", "summary": "Unified wallet activity feed.", "title": "Finance Activity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Unified wallet activity feed for user.", "write_mode": null}, {"action": "finance.project.portfolio", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.finance.user_read_model.gen1"], "id": "finance.project.portfolio", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Finance Project Portfolio", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Project treasury + operating balances."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.finance.user_read_model.gen1"], "id": "finance.project.portfolio", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Finance Project Portfolio", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Project treasury + operating balances."}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Project treasury + operating balances.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"compute_budget": {"additionalProperties": true, "description": "object or null", "type": "object"}, "contributions_summary": {"additionalProperties": true, "description": "object — omitted when the contribution read fails", "type": "object"}, "custom_wallets": {"description": "array", "items": {"type": "string"}, "type": "array"}, "display_name": {"description": "string", "type": "string"}, "head_project_id": {"description": "int — when the project is a business child", "type": "integer"}, "my_contribution_usd_minor": {"description": "int — omitted when the contribution read fails", "type": "integer"}, "operating_wallets": {"description": "array", "items": {"type": "string"}, "type": "array"}, "organ": {"description": "string — when the project is a business organ", "type": "string"}, "organ_context": {"description": "string", "type": "string"}, "pending_invoices_count": {"description": "int", "type": "integer"}, "pending_withdrawals_count": {"description": "int", "type": "integer"}, "project_id": {"description": "int", "type": "integer"}, "treasury_agnt_atomic": {"description": "int or null", "type": "integer"}, "treasury_fiat_slices": {"description": "array", "items": {"type": "string"}, "type": "array"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "AgentNet proofs stay on agentnet.*.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "payments|agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_project_portfolio", "semantic_input_mode": "inherit_workflow", "summary": "Project business portfolio (operating + treasury + AGNT).", "title": "Finance Project Portfolio", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Project treasury + operating balances.", "write_mode": null}, {"action": "finance.dashboard_bundle", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not substitute dashboard_bundle for Profile subscription UI — shape differs.", "anti_patterns": ["Do not substitute dashboard_bundle for Profile subscription UI — shape differs.", "Do not use for checkout; use payments.*."], "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.dashboard_bundle", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Dashboard Bundle", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator/agent finance hub snapshot (KPI bundle). For merged tier limits after buffs use buffs.get_effective_limits. For full user billing overview (projects_summary, meters) use REST /api/billing/ove"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.dashboard_bundle", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Dashboard Bundle", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator/agent finance hub snapshot (KPI bundle). For merged tier limits after buffs use buffs.get_effective_limits. For full user billing overview (projects_summary, meters) use REST /api/billing/ove"}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Operator/agent finance hub snapshot (KPI bundle). For merged tier limits after buffs use buffs.get_…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Open a wallet, then deposit in the next recipe with the copied wallet_id. This is the business status read. Do not call thirty raw payment tools. For shop order_id status use shop.orders.get — not this atom.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_dashboard_bundle", "semantic_input_mode": "inherit_workflow", "summary": "Finance hub landing aggregate (portfolio + billing_status + activity preview). MCP read model for /user|/dev finance routes — not field-for-field with REST GET /api/billing/overview (SPA subscription ", "title": "Finance Dashboard Bundle", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator/agent finance hub snapshot (KPI bundle). For merged tier limits after buffs use buffs.get_effective_limits. For full user billing overview (projects_summary, meters) use REST /api/billing/ove", "write_mode": null}, {"action": "finance.project.analytics", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.project.analytics", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Project Analytics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Finance dashboard KPIs and charts for workspace tenants."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.project.analytics", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Project Analytics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Finance dashboard KPIs and charts for workspace tenants."}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Finance dashboard KPIs and charts for workspace tenants.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "AgentNet proofs stay on agentnet.*.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_project_analytics", "semantic_input_mode": "inherit_workflow", "summary": "Project finance analytics (revenue/expense trends) for hosted vertical widgets.", "title": "Finance Project Analytics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Finance dashboard KPIs and charts for workspace tenants.", "write_mode": null}, {"action": "finance.project.fund", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.finance.user_read_model.gen1"], "id": "finance.project.fund", "related_tools": ["finance.project.portfolio", "payments.get_balance", "wallets.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Project Fund", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move USD from the personal wallet on project 1 into that project's treasury wallet (data.ecosystem.money). Does not credit tenant data.money."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.finance.user_read_model.gen1"], "id": "finance.project.fund", "related_tools": ["finance.project.portfolio", "payments.get_balance", "wallets.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Project Fund", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move USD from the personal wallet on project 1 into that project's treasury wallet (data.ecosystem.money). Does not credit tenant data.money."}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Move USD from the personal wallet on project 1 into that project's treasury wallet (data.ecosystem.…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"idempotency_key": {"description": "string", "type": "string"}, "result": {"additionalProperties": true, "description": "object", "type": "object"}, "success": {"description": "bool", "type": "boolean"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "AgentNet proofs stay on agentnet.*.", "related_prompts": ["agentstack_project_treasury"], "related_tools": ["finance.project.portfolio", "payments.get_balance", "wallets.list"], "required_cap": "payments|project_admin", "requires_preflight": false, "risk_class": "read", "rollback": [], "safe_action": "finance_project_fund", "semantic_input_mode": "inherit_workflow", "summary": "Fund a project via ecosystem USD transfer.", "title": "Finance Project Fund", "verification": ["finance.project.portfolio", "payments.get_balance"], "verify": [{"action": "finance.project.portfolio", "predicate": "named resource is visible"}, {"action": "payments.get_balance", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move USD from the personal wallet on project 1 into that project's treasury wallet (data.ecosystem.money). Does not credit tenant data.money.", "write_mode": null}, {"action": "finance.project.contribute", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.finance.user_read_model.gen1"], "id": "finance.project.contribute", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Project Contribute", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Member sends USD from their personal wallet on project 1 into that project's treasury (data.ecosystem.money). Does not credit tenant data.money."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.finance.user_read_model.gen1"], "id": "finance.project.contribute", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Project Contribute", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Member sends USD from their personal wallet on project 1 into that project's treasury (data.ecosystem.money). Does not credit tenant data.money."}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Member sends USD from their personal wallet on project 1 into that project's treasury (data.ecosyst…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"contribution": {"additionalProperties": true, "description": "object", "type": "object"}, "deduped": {"description": "bool — true only when this idempotency key already had a record", "type": "boolean"}, "idempotency_key": {"description": "string", "type": "string"}, "result": {"additionalProperties": true, "description": "object — the transfer, absent when deduped", "type": "object"}, "success": {"description": "bool", "type": "boolean"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "AgentNet proofs stay on agentnet.*.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "payments|project_admin", "requires_preflight": false, "risk_class": "read", "rollback": [], "safe_action": "finance_project_contribute", "semantic_input_mode": "inherit_workflow", "summary": "Member contribution: USD only from personal ecosystem wallet (project_id=1) to project treasury. Not for custom/game currencies.", "title": "Finance Project Contribute", "verification": ["finance.project.portfolio", "finance.project.contributions.list"], "verify": [{"action": "finance.project.portfolio", "predicate": "named resource is visible"}, {"action": "finance.project.contributions.list", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Member sends USD from their personal wallet on project 1 into that project's treasury (data.ecosystem.money). Does not credit tenant data.money.", "write_mode": null}, {"action": "finance.project.contributions.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.project.contributions.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Project Contributions List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit member contributions (FAP-masked)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.project.contributions.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Project Contributions List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit member contributions (FAP-masked)."}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Audit member contributions (FAP-masked).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "AgentNet proofs stay on agentnet.*.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_project_contributions_list", "semantic_input_mode": "inherit_workflow", "summary": "List member contributions for a project (FAP-masked).", "title": "Finance Project Contributions List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit member contributions (FAP-masked).", "write_mode": null}, {"action": "finance.pay.quote", "ai_tips": "Get pay quote before wallet debit or AGNT purchase.", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.pay.quote", "related_tools": ["finance.pay.execute", "wallets.list", "energy.list_packs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Pay Quote", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id + amount/currency from finance.portfolio or payments.get_balance", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "quote_limit_exceeded": "Tier limits — buffs.get_effective_limits before another quote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_required": "Operator OAuth — auth.get_profile then re-quote", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get pay quote before wallet debit or AGNT purchase."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.pay.quote", "related_tools": ["finance.pay.execute", "wallets.list", "energy.list_packs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Pay Quote", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id + amount/currency from finance.portfolio or payments.get_balance", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "quote_limit_exceeded": "Tier limits — buffs.get_effective_limits before another quote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_required": "Operator OAuth — auth.get_profile then re-quote", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get pay quote before wallet debit or AGNT purchase."}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Get pay quote before wallet debit or AGNT purchase.", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_project_treasury"], "related_tools": ["finance.pay.execute", "wallets.list", "energy.list_packs"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_pay_quote", "semantic_input_mode": "inherit_workflow", "summary": "Quote a unified pay intent (energy_pack, subscription, compute_credits, stackscript_fuel_pack, fund, contribute).", "title": "Finance Pay Quote", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id + amount/currency from finance.portfolio or payments.get_balance", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "quote_limit_exceeded": "Tier limits — buffs.get_effective_limits before another quote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_required": "Operator OAuth — auth.get_profile then re-quote", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get pay quote before wallet debit or AGNT purchase.", "write_mode": null}, {"action": "finance.pay.execute", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.pay.execute", "related_tools": ["finance.pay.quote", "payments.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Pay Execute", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "idempotency_mismatch": "Same idempotency_key with a different quote_id or quote_hash — mint a new key", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "quote_expired": "finance.pay.quote again — the quote window closed", "quote_hash_mismatch": "quote_hash does not match the stored quote body — re-quote", "quote_not_found": "finance.pay.quote first — quote_id expired or unknown", "quote_user_mismatch": "auth.get_profile — quote belongs to another user", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Debit a quoted wallet for energy, subscription, checkout, fund, or contribution. Card is payments.create, then poll payments.get. USD and USDT land on project 1 or treasury, never tenant data.money."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.pay.execute", "related_tools": ["finance.pay.quote", "payments.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Pay Execute", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "idempotency_mismatch": "Same idempotency_key with a different quote_id or quote_hash — mint a new key", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "quote_expired": "finance.pay.quote again — the quote window closed", "quote_hash_mismatch": "quote_hash does not match the stored quote body — re-quote", "quote_not_found": "finance.pay.quote first — quote_id expired or unknown", "quote_user_mismatch": "auth.get_profile — quote belongs to another user", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Debit a quoted wallet for energy, subscription, checkout, fund, or contribution. Card is payments.create, then poll payments.get. USD and USDT land on project 1 or treasury, never tenant data.money."}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Debit a quoted wallet for energy, subscription, checkout, fund, or contribution. Card is payments.c…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_project_treasury"], "related_tools": ["finance.pay.quote", "payments.get_balance"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "finance_pay_execute", "semantic_input_mode": "inherit_workflow", "summary": "Execute a quoted pay intent with idempotency key. Caller must own the quote.", "title": "Finance Pay Execute", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "idempotency_mismatch": "Same idempotency_key with a different quote_id or quote_hash — mint a new key", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "quote_expired": "finance.pay.quote again — the quote window closed", "quote_hash_mismatch": "quote_hash does not match the stored quote body — re-quote", "quote_not_found": "finance.pay.quote first — quote_id expired or unknown", "quote_user_mismatch": "auth.get_profile — quote belongs to another user", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Debit a quoted wallet for energy, subscription, checkout, fund, or contribution. Card is payments.create, then poll payments.get. USD and USDT land on project 1 or treasury, never tenant data.money.", "write_mode": null}, {"action": "finance.expense.create", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.expense.create", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Expense Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Record a project expense before finance.expense.list review."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.expense.create", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Expense Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Record a project expense before finance.expense.list review."}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Record a project expense before finance.expense.list review.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "finance_expense_create", "semantic_input_mode": "inherit_workflow", "summary": "Create an expense row on data.money.expenses[].", "title": "Finance Expense Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Record a project expense before finance.expense.list review.", "write_mode": null}, {"action": "finance.expense.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.expense.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Expense List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Canonical money.expenses, not a sandbox leaf. Read coverage.stored_cap (512), coverage.truncated, and category_coerced."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.expense.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Expense List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Canonical money.expenses, not a sandbox leaf. Read coverage.stored_cap (512), coverage.truncated, and category_coerced."}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Canonical money.expenses, not a sandbox leaf. Read coverage.stored_cap (512), coverage.truncated, a…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_expense_list", "semantic_input_mode": "inherit_workflow", "summary": "List project expenses on the canonical money.expenses leaf. Not inside a generation sandbox. Filter by date_from/date_to then limit.", "title": "Finance Expense List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Canonical money.expenses, not a sandbox leaf. Read coverage.stored_cap (512), coverage.truncated, and category_coerced.", "write_mode": null}, {"action": "finance.expense.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.expense.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Expense Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove a mistaken expense by id from finance.expense.list."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.expense.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Expense Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove a mistaken expense by id from finance.expense.list."}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Remove a mistaken expense by id from finance.expense.list.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_treasury"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "finance_expense_delete", "semantic_input_mode": "inherit_workflow", "summary": "Delete expense by id.", "title": "Finance Expense Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove a mistaken expense by id from finance.expense.list.", "write_mode": null}, {"action": "finance.revenue.record", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.revenue.record", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Revenue Record", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After delivering a project or manual revenue adjustment."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.revenue.record", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Revenue Record", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After delivering a project or manual revenue adjustment."}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "After delivering a project or manual revenue adjustment.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_revenue_record", "semantic_input_mode": "inherit_workflow", "summary": "Record paid freelancer revenue on data.money.invoices[] (EDITFLOW deal close).", "title": "Finance Revenue Record", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After delivering a project or manual revenue adjustment.", "write_mode": null}, {"action": "finance.revenue.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.revenue.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Revenue List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Finance page revenue list after finance.revenue.record."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.revenue.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Revenue List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Finance page revenue list after finance.revenue.record."}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Finance page revenue list after finance.revenue.record.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_revenue_list", "semantic_input_mode": "inherit_workflow", "summary": "List paid freelancer revenue rows on data.money.invoices[] (actor-scoped).", "title": "Finance Revenue List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Finance page revenue list after finance.revenue.record.", "write_mode": null}, {"action": "finance.revenue.update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.revenue.update", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Revenue Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Correct a mistaken revenue entry from finance.revenue.list."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.revenue.update", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Revenue Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Correct a mistaken revenue entry from finance.revenue.list."}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Correct a mistaken revenue entry from finance.revenue.list.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "finance_revenue_update", "semantic_input_mode": "inherit_workflow", "summary": "Update paid freelancer revenue amount or description (actor-owned).", "title": "Finance Revenue Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Correct a mistaken revenue entry from finance.revenue.list.", "write_mode": null}, {"action": "finance.revenue.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.revenue.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Revenue Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove duplicate or mistaken revenue from finance.revenue.list."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.revenue.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Revenue Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove duplicate or mistaken revenue from finance.revenue.list."}, "domain": "finance", "domain_title": "Finance Expense MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Remove duplicate or mistaken revenue from finance.revenue.list.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_treasury"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "finance_revenue_delete", "semantic_input_mode": "inherit_workflow", "summary": "Delete a paid freelancer revenue row by id (actor-owned).", "title": "Finance Revenue Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove duplicate or mistaken revenue from finance.revenue.list.", "write_mode": null}, {"action": "fundraising.narrative.lint", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["docs.grants.portfolio.gen1"], "id": "fundraising.narrative.lint", "related_tools": ["fundraising.packet.compose"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Fundraising Narrative Lint", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before pasting grant copy or publishing a deck snippet."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["docs.grants.portfolio.gen1"], "id": "fundraising.narrative.lint", "related_tools": ["fundraising.packet.compose"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Fundraising Narrative Lint", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before pasting grant copy or publishing a deck snippet."}, "domain": "fundraising", "domain_title": "Fundraising MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["docs.grants.portfolio.gen1"], "instruction_hint": "Before pasting grant copy or publishing a deck snippet.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.fundraising", "owner_gene": "docs.grants.portfolio.gen1", "plane": "Grant packet: fundraising.packet.compose.", "plane_chooser": "Grant packet: fundraising.packet.compose.", "related_tools": ["fundraising.packet.compose"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "fundraising_narrative_lint", "semantic_input_mode": "inherit_workflow", "summary": "Scan text for forbidden fundraising phrases from NARRATIVE_REGISTRY.yaml.", "title": "Fundraising Narrative Lint", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before pasting grant copy or publishing a deck snippet.", "write_mode": null}, {"action": "fundraising.packet.compose", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["docs.grants.portfolio.gen1"], "id": "fundraising.packet.compose", "related_tools": ["grants.compose.checklist"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Fundraising Packet Compose", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Grant submit prep — attachment checklist for a program."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["docs.grants.portfolio.gen1"], "id": "fundraising.packet.compose", "related_tools": ["grants.compose.checklist"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Fundraising Packet Compose", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Grant submit prep — attachment checklist for a program."}, "domain": "fundraising", "domain_title": "Fundraising MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["docs.grants.portfolio.gen1"], "instruction_hint": "Grant submit prep — attachment checklist for a program.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.fundraising", "owner_gene": "docs.grants.portfolio.gen1", "plane": "Grant packet: fundraising.packet.compose.", "plane_chooser": "Grant packet: fundraising.packet.compose.", "related_tools": ["grants.compose.checklist"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "fundraising_packet_compose", "semantic_input_mode": "inherit_workflow", "summary": "List attachment paths for a grant program packet (registry + evidence). Ecosystem owner only — prefer grants.compose.checklist for Grant OS CRM.", "title": "Fundraising Packet Compose", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Grant submit prep — attachment checklist for a program.", "write_mode": null}, {"action": "games.leaderboards.submit", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "games", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.games.gen1"], "id": "games.leaderboards.submit", "related_tools": ["games.leaderboards.top", "projects.patch_data"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Games Leaderboards Submit", "when_to_use": "Hosted or logic-driven games need a ranked board without a separate DB"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "games", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.games.gen1"], "id": "games.leaderboards.submit", "related_tools": ["games.leaderboards.top", "projects.patch_data"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Games Leaderboards Submit", "when_to_use": "Hosted or logic-driven games need a ranked board without a separate DB"}, "domain": "games", "domain_title": "Games MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.games.gen1"], "instruction_hint": "Hosted or logic-driven games need a ranked board without a separate DB", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.games", "owner_gene": "core.mcp.games.gen1", "related_tools": ["games.leaderboards.top", "projects.patch_data"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "games_leaderboards_submit", "semantic_input_mode": "inherit_workflow", "summary": "Submit a score to an ecosystem.games.leaderboards board (server-side 8DNA leaf).", "title": "Games Leaderboards Submit", "when_to_use": "Hosted or logic-driven games need a ranked board without a separate DB", "write_mode": null}, {"action": "games.leaderboards.top", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.games.gen1"], "id": "games.leaderboards.top", "related_tools": ["games.leaderboards.submit", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Games Leaderboards Top", "when_to_use": "Poll leaderboard standings from agents or hosted clients"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.games.gen1"], "id": "games.leaderboards.top", "related_tools": ["games.leaderboards.submit", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Games Leaderboards Top", "when_to_use": "Poll leaderboard standings from agents or hosted clients"}, "domain": "games", "domain_title": "Games MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.games.gen1"], "instruction_hint": "Poll leaderboard standings from agents or hosted clients", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.games", "owner_gene": "core.mcp.games.gen1", "related_tools": ["games.leaderboards.submit", "discovery.describe"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "games_leaderboards_top", "semantic_input_mode": "inherit_workflow", "summary": "Read top scores for a leaderboard board (plain read).", "title": "Games Leaderboards Top", "when_to_use": "Poll leaderboard standings from agents or hosted clients", "write_mode": null}, {"action": "generation.list", "aliases": ["generation.environments", "generation.list_environments", "generation.list_envs"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not treat list_unavailable as an empty project.", "anti_patterns": ["Do not treat list_unavailable as an empty project.", "Do not pass stale generation_env_uuid — omit it and let the server keep the head."], "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.list", "related_tools": ["generation.env_snapshot", "generation.diff_vs_prod", "generation.supply_status"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Generation operator or project membership required — auth.get_profile", "invalid_parameters": "project_id required — bind context.project_id before generation.list", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — not zero anchors. Retry generation.env_snapshot once, else generation.list once; fix project_id/session; do not fork to repair.", "sandbox_not_available": "Free/starter sandbox off — generation.supply_status; upgrade before auto_generation_mode or fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Historical anchors (list_contract=historical_all) for this project — not traffic head only. Gate A: prefer generation.env_snapshot or supply_status supply_scope=gate — not generation.list as the defau"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.list", "related_tools": ["generation.env_snapshot", "generation.diff_vs_prod", "generation.supply_status"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Generation operator or project membership required — auth.get_profile", "invalid_parameters": "project_id required — bind context.project_id before generation.list", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — not zero anchors. Retry generation.env_snapshot once, else generation.list once; fix project_id/session; do not fork to repair.", "sandbox_not_available": "Free/starter sandbox off — generation.supply_status; upgrade before auto_generation_mode or fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Historical anchors (list_contract=historical_all) for this project — not traffic head only. Gate A: prefer generation.env_snapshot or supply_status supply_scope=gate — not generation.list as the defau"}, "do_not_use_when": "Not buyer checkout or script.run — sandbox catalog only. Empty list ≠ no forks; use env_snapshot on list_unavailable.", "domain": "generation", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Historical list + Gate A (include_supply false)", "request": {"params": {"include_supply": false, "project_id": 1}, "tool": "generation.list"}, "response": {"data": {"include_supply": false, "sandbox_gate": {"apply_ready": false}}, "success": true}}, {"name": "Full supply snapshot on list", "request": {"params": {"include_supply": true, "project_id": 1}, "tool": "generation.list"}, "response": {"data": {"include_supply": true}, "success": true}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_ANCHOR_MISSING": "generation.list anchor_missing_from_list is stale: use generation.diff_vs_prod by UUID, not a new fork.", "GENERATION_LIST_STALE": "generation.list list_stale: retry projection.verification_action once (prefer generation.env_snapshot), then generation.diff_vs_prod. Do not fork to repair projection lag.", "GENERATION_LIST_UNAVAILABLE": "list_unavailable means catalog read failed, not an empty project — retry generation.env_snapshot once (env_uuid from fork if known), else generation.list once, then diagnose; do not fork to fill the list.", "GENERATION_SANDBOX_QUOTA_ZERO": "Sandbox unavailable or quota zero — do not invent env_uuid; check generation.supply_status (supply_scope=gate) or generation.env_snapshot, then fork only when quota allows.", "GENERATION_STALE_ENV_UUID": "Stale generation_env_uuid (not found / not open): one generation.env_snapshot with env_uuid from the last fork receipt — omit stale uuid from context. bots.order_manager_bootstrap apply (dry_run=false) does not auto-fork; needs apply_ready."}, "instruction_hint": "Historical anchors (list_contract=historical_all) for this project — not traffic head only. Gate A:…", "mutation_kind": "none", "next_actions": ["generation.diff_vs_prod"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"canonical_revision": {"description": "Anchor generation counter for poll/stale detection", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "environments": {"description": "Sandbox environment anchors", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "gates_attach_coherence": {"description": "When include_gates: capped/max_envs/operator_message honesty (default max 8 run_gates — use generation.gates per env_uuid)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "include_gates": {"description": "Echo when request used include_gates=true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "include_status": {"description": "Filter applied: all | open | comma-separated statuses", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "list_contract": {"description": "historical_all — full anchor history (ADR GENERATION_LIST_CONTRACT)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Logical project id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "projection": {"description": "Read-model lag envelope (stale, filtered, verification_action)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "projection.filtered": {"description": "True when include_status narrowed the SQL list", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "projection_revision": {"description": "Hydrated list size signal (distinct from canonical_revision)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "readiness": {"description": "Catalog projection lag: ready|pending — not sandbox apply_ready", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "sandbox_gate": {"description": "Gate A: apply_ready, reason, recovery_hint (TG1611 / order_manager bootstrap)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune"], "related_tools": ["generation.env_snapshot", "generation.diff_vs_prod", "generation.supply_status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_list", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "List sandbox environment anchors for a project (names, status, CalVer, auto_created flags). error_code list_unavailable means the read failed.", "title": "Generation List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Generation operator or project membership required — auth.get_profile", "invalid_parameters": "project_id required — bind context.project_id before generation.list", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — not zero anchors. Retry generation.env_snapshot once, else generation.list once; fix project_id/session; do not fork to repair.", "sandbox_not_available": "Free/starter sandbox off — generation.supply_status; upgrade before auto_generation_mode or fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Not buyer checkout or script.run — sandbox catalog only. Empty list ≠ no forks; use env_snapshot on list_unavailable.", "when_to_use": "Historical anchors (list_contract=historical_all) for this project — not traffic head only. Gate A: prefer generation.env_snapshot or supply_status supply_scope=gate — not generation.list as the defau", "write_mode": null}, {"action": "generation.status", "aliases": ["generation.get_status"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.status", "related_tools": ["generation.env_snapshot", "generation.diff_vs_prod", "generation.gates", "generation.supply_status"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id required — bind operator session before generation.status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Retry generation.env_snapshot once, else generation.list — catalog read failed", "sandbox_not_available": "Free/starter sandbox off — generation.supply_status; upgrade before auto_generation_mode or fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Gate A = sandbox_gate.apply_ready; readiness is projection-only. Default include_projection=false — light gate probe (no catalog hydrate). include_projection=true runs build_generation_list_projection"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.status", "related_tools": ["generation.env_snapshot", "generation.diff_vs_prod", "generation.gates", "generation.supply_status"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id required — bind operator session before generation.status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Retry generation.env_snapshot once, else generation.list — catalog read failed", "sandbox_not_available": "Free/starter sandbox off — generation.supply_status; upgrade before auto_generation_mode or fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Gate A = sandbox_gate.apply_ready; readiness is projection-only. Default include_projection=false — light gate probe (no catalog hydrate). include_projection=true runs build_generation_list_projection"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "TG1611 Gate A default (no catalog hydrate)", "request": {"params": {"project_id": 1}, "tool": "generation.status"}, "response": {"data": {"include_projection": false, "sandbox_gate": {"apply_ready": false, "reason": "no_open_anchor"}}, "success": true}}, {"name": "Full projection (opt-in)", "request": {"params": {"include_projection": true, "project_id": 1}, "tool": "generation.status"}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_APPROVAL_MODES": "auto_generation_approval_mode: off | at_least_one | min_count | min_percent | manual_only. manual_only blocks auto-promote. generation.approve records one approver; promote waits until quorum. Legacy require_approval true means at_least_one.", "GENERATION_DIRECT_PROD": "direct_prod_roles (default owner) write production and skip auto-fork. Everyone else accumulates on their own open sandbox branch. Pass env_uuid or X-AgentStack-Env only to stay in a chosen sandbox.", "GENERATION_GATE_AFTER_FORK": "After generation.fork, reuse data.env_uuid for mutations and Gate A probes — generation.env_snapshot (lightest) then bootstrap dry_run=true; generation.supply_status only when tier/quota needed. Batch context honors params.env_uuid when list lags (hydrate + memo bust).", "GENERATION_LIST_STALE": "generation.list list_stale: retry projection.verification_action once (prefer generation.env_snapshot), then generation.diff_vs_prod. Do not fork to repair projection lag.", "GENERATION_LIST_UNAVAILABLE": "list_unavailable means catalog read failed, not an empty project — retry generation.env_snapshot once (env_uuid from fork if known), else generation.list once, then diagnose; do not fork to fill the list."}, "instruction_hint": "Gate A = sandbox_gate.apply_ready; readiness is projection-only. Default include_projection=false —…", "mutation_kind": "none", "next_actions": ["generation.env_snapshot", "generation.diff_vs_prod", "generation.gates"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"active_env_uuid": {"description": "Production traffic anchor UUID", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "auto_generation_mode": {"description": "Whether tracked mutations auto-fork sandbox", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "auto_generation_require_approval": {"description": "Manual approval gate before promote", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "auto_promote_strategy": {"description": "immediate | canary | blue_green", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "canary_auto_route": {"description": "Auto-advance canary when healthy", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "canonical_revision": {"description": "Anchor generation counter", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "failed_reason": {"description": "Canary abort reason when present", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "features": {"description": "Tier feature flags", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "include_projection": {"description": "False when catalog hydrate skipped (banner + gate only)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "limits": {"description": "Sandbox quota limits object", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "open_environment_count": {"description": "Quota-counted open forks", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "owner_tier": {"description": "Subscription tier of project owner", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "pending_count": {"description": "Environments awaiting promotion", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Logical project id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "projection": {"description": "List projection envelope for poll UX", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "projection_revision": {"description": "Hydrated projection revision", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "readiness": {"description": "Projection lag when hydrated — not sandbox_gate.apply_ready", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "rolling_out": {"description": "Rolling canary env row or null", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "rollout_mode": {"description": "standard | test when canary active", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "sandbox_gate": {"description": "Gate A object: apply_ready, reason, recovery_hint, optional next_actions", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "segment_id": {"description": "Audience segment for canary routing", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "settings": {"description": "Full auto_generation config dict", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "supply_scope": {"description": "Echo gate when request used supply_scope=gate (skips quota SQL)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "traffic_weight": {"description": "Canary traffic percent when rolling_out", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "usage": {"description": "Sandbox quota usage object", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.env_snapshot", "generation.diff_vs_prod", "generation.gates", "generation.supply_status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_status", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Lightweight generation + canary status for UI banners and agents.", "title": "Generation Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id required — bind operator session before generation.status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Retry generation.env_snapshot once, else generation.list — catalog read failed", "sandbox_not_available": "Free/starter sandbox off — generation.supply_status; upgrade before auto_generation_mode or fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Gate A = sandbox_gate.apply_ready; readiness is projection-only. Default include_projection=false — light gate probe (no catalog hydrate). include_projection=true runs build_generation_list_projection", "write_mode": null}, {"action": "generation.supply_status", "aliases": ["generation.current", "generation.current_env"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.supply_status", "related_tools": ["generation.env_snapshot", "bots.order_manager_bootstrap"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Supply Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "generation operator or project membership required", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — retry generation.env_snapshot with fork env_uuid; generation.supply_status is not empty supply", "sandbox_not_available": "Free/starter sandbox off — generation.supply_status; upgrade before auto_generation_mode or fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Gate A + optional quota. TG1611: prefer generation.env_snapshot; supply_scope=gate skips quota SQL. active_env_uuid is traffic pointer only. Business head project_id after create_composite."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.supply_status", "related_tools": ["generation.env_snapshot", "bots.order_manager_bootstrap"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Supply Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "generation operator or project membership required", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — retry generation.env_snapshot with fork env_uuid; generation.supply_status is not empty supply", "sandbox_not_available": "Free/starter sandbox off — generation.supply_status; upgrade before auto_generation_mode or fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Gate A + optional quota. TG1611: prefer generation.env_snapshot; supply_scope=gate skips quota SQL. active_env_uuid is traffic pointer only. Business head project_id after create_composite."}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Lightest apply gate probe", "request": {"params": {"project_id": 1, "supply_scope": "gate"}, "tool": "generation.supply_status"}, "response": {"data": {"sandbox_gate": {"apply_ready": false, "reason": "no_open_anchor"}, "supply_scope": "gate"}, "success": true}}, {"name": "Pre-fork quota room check", "request": {"params": {"project_id": 1, "supply_scope": "full"}, "tool": "generation.supply_status"}, "response": {"data": {"limits": {"open_environments": {}}, "supply_scope": "full"}, "success": true}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_GATE_AFTER_FORK": "After generation.fork, reuse data.env_uuid for mutations and Gate A probes — generation.env_snapshot (lightest) then bootstrap dry_run=true; generation.supply_status only when tier/quota needed. Batch context honors params.env_uuid when list lags (hydrate + memo bust).", "GENERATION_LIST_UNAVAILABLE": "list_unavailable means catalog read failed, not an empty project — retry generation.env_snapshot once (env_uuid from fork if known), else generation.list once, then diagnose; do not fork to fill the list.", "GENERATION_NEXT_ACTIONS_HINTS_ONLY": "next_actions and recovery_hint on gate reads are navigation hints, not operator consent to mutate prod. When sandbox_gate.apply_ready=false, STOP — do not auto-run generation.fork or dry_run=false bootstrap from agent loops. Exception: bots.order_manager_bootstrap dry_run=true is planning only — it does not require apply_ready; pass env_uuid from generation.fork before dry_run=false apply (Gate B).", "GENERATION_SANDBOX_QUOTA_ZERO": "Sandbox unavailable or quota zero — do not invent env_uuid; check generation.supply_status (supply_scope=gate) or generation.env_snapshot, then fork only when quota allows."}, "instruction_hint": "Gate A + optional quota. TG1611: prefer generation.env_snapshot; supply_scope=gate skips quota SQL.…", "mutation_kind": "none", "next_actions": ["generation.env_snapshot", "bots.order_manager_bootstrap"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"active_env_uuid": {"description": "Production traffic anchor UUID", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "auto_generation_mode": {"description": "Whether tracked mutations auto-fork sandbox", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "auto_generation_require_approval": {"description": "Manual approval gate before promote", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "auto_promote_strategy": {"description": "immediate | canary | blue_green", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "canary_auto_route": {"description": "Auto-advance canary when healthy", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "features": {"description": "Tier feature flags", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "limits": {"description": "Sandbox quota limits object", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "open_environment_count": {"description": "Quota-counted open forks", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "owner_tier": {"description": "Subscription tier of project owner", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "pending_count": {"description": "Environments awaiting promotion", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Logical project id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "rolling_out": {"description": "Rolling canary env row or null", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "sandbox_gate": {"description": "Gate A object: apply_ready, reason, recovery_hint, optional next_actions", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "settings": {"description": "Full auto_generation config dict", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "supply_scope": {"description": "Echo gate when request used supply_scope=gate (skips quota SQL)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "traffic_weight": {"description": "Canary traffic percent when rolling_out", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "usage": {"description": "Sandbox quota usage object", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.env_snapshot", "bots.order_manager_bootstrap"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_supply_status", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Tenant generation supply snapshot: owner tier, open-env quota usage, auto_generation settings, pending/canary state. Alias for agents (same SoT as GET /api/sandbox/limits + generation.status).", "title": "Generation Supply Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "generation operator or project membership required", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — retry generation.env_snapshot with fork env_uuid; generation.supply_status is not empty supply", "sandbox_not_available": "Free/starter sandbox off — generation.supply_status; upgrade before auto_generation_mode or fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Gate A + optional quota. TG1611: prefer generation.env_snapshot; supply_scope=gate skips quota SQL. active_env_uuid is traffic pointer only. Business head project_id after create_composite.", "write_mode": null}, {"action": "generation.env_snapshot", "aliases": ["generation.get"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1", "core.mcp.self_description.gen1"], "id": "generation.env_snapshot", "related_tools": ["generation.fork", "generation.supply_status", "bots.order_manager_bootstrap"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Env Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "generation operator or project membership required", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — retry once; pass env_uuid from fork", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Lightest Gate A + hydrated env rows — one catalog read, no limits/usage SQL. Pass env_uuid from generation.fork. Prefer over generation.list for TG1611 / AgentStackSharp."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1", "core.mcp.self_description.gen1"], "id": "generation.env_snapshot", "related_tools": ["generation.fork", "generation.supply_status", "bots.order_manager_bootstrap"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Env Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "generation operator or project membership required", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — retry once; pass env_uuid from fork", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Lightest Gate A + hydrated env rows — one catalog read, no limits/usage SQL. Pass env_uuid from generation.fork. Prefer over generation.list for TG1611 / AgentStackSharp."}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Gate A after fork", "request": {"params": {"env_uuid": "example-env-uuid", "project_id": 1}, "tool": "generation.env_snapshot"}, "response": {"data": {"sandbox_gate": {"apply_ready": true, "reason": "open_anchors"}, "snapshot_scope": "gate"}, "success": true}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_GATE_AFTER_FORK": "After generation.fork, reuse data.env_uuid for mutations and Gate A probes — generation.env_snapshot (lightest) then bootstrap dry_run=true; generation.supply_status only when tier/quota needed. Batch context honors params.env_uuid when list lags (hydrate + memo bust).", "GENERATION_LIST_UNAVAILABLE": "list_unavailable means catalog read failed, not an empty project — retry generation.env_snapshot once (env_uuid from fork if known), else generation.list once, then diagnose; do not fork to fill the list.", "GENERATION_NEXT_ACTIONS_HINTS_ONLY": "next_actions and recovery_hint on gate reads are navigation hints, not operator consent to mutate prod. When sandbox_gate.apply_ready=false, STOP — do not auto-run generation.fork or dry_run=false bootstrap from agent loops. Exception: bots.order_manager_bootstrap dry_run=true is planning only — it does not require apply_ready; pass env_uuid from generation.fork before dry_run=false apply (Gate B)."}, "instruction_hint": "Lightest Gate A + hydrated env rows — one catalog read, no limits/usage SQL. Pass env_uuid from gen…", "mutation_kind": "none", "next_actions": ["bots.order_manager_bootstrap", "generation.fork"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"active_env_uuid": {"description": "Production traffic anchor UUID", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "auto_generation_mode": {"description": "Whether tracked mutations auto-fork sandbox", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "environments": {"description": "Gate-hydrated anchor rows (required env_uuid merged)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "list_contract": {"description": "historical_all", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "open_environment_count": {"description": "Quota-counted open forks (hydrated catalog)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Logical project id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "sandbox_gate": {"description": "Gate A: apply_ready, reason, recovery_hint, next_actions", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "snapshot_scope": {"description": "gate — no limits/usage SQL", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.fork", "generation.supply_status", "bots.order_manager_bootstrap"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_env_snapshot", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Lightest Gate A organ: one catalog read + hydrated anchors + sandbox_gate. No tier limits/usage SQL — prefer over generation.list for AgentStackSharp TG1611.", "title": "Generation Env Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "generation operator or project membership required", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — retry once; pass env_uuid from fork", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Lightest Gate A + hydrated env rows — one catalog read, no limits/usage SQL. Pass env_uuid from generation.fork. Prefer over generation.list for TG1611 / AgentStackSharp.", "write_mode": null}, {"action": "generation.settings.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.settings.get", "related_tools": ["generation.settings.patch", "generation.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Settings Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin or generation operator for settings read", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read auto_generation_mode, approval mode, and promote strategy before changing generation.settings.patch or running generation.promote."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.settings.get", "related_tools": ["generation.settings.patch", "generation.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Settings Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin or generation operator for settings read", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read auto_generation_mode, approval mode, and promote strategy before changing generation.settings.patch or running generation.promote."}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Read auto_generation_mode", "request": {"params": {"project_id": 1}, "tool": "generation.settings.get"}, "response": {"data": {"project_id": 1, "settings": {"auto_generation_mode": true}}, "success": true}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_APPROVAL_MODES": "auto_generation_approval_mode: off | at_least_one | min_count | min_percent | manual_only. manual_only blocks auto-promote. generation.approve records one approver; promote waits until quorum. Legacy require_approval true means at_least_one.", "GENERATION_DIRECT_PROD": "direct_prod_roles (default owner) write production and skip auto-fork. Everyone else accumulates on their own open sandbox branch. Pass env_uuid or X-AgentStack-Env only to stay in a chosen sandbox."}, "instruction_hint": "Read auto_generation_mode, approval mode, and promote strategy before changing generation.settings.…", "mutation_kind": "none", "next_actions": ["generation.settings.patch", "generation.status"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.settings.patch", "generation.status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_settings_get", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Read per-project auto_generation settings (REST parity: GET /api/generations/{id}/settings).", "title": "Generation Settings Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin or generation operator for settings read", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Read auto_generation_mode, approval mode, and promote strategy before changing generation.settings.patch or running generation.promote.", "write_mode": null}, {"action": "generation.settings.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.settings.patch", "mutation_risk": "low", "related_tools": ["generation.status", "generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Settings Patch", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin / generation operator required — not a sandbox head issue", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "sandbox_not_available": "auto_generation supply needs a paid tier — read generation.env_snapshot (gate) or generation.supply_status before patch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Set direct_prod_roles and auto_generation_approval_mode. Owners write prod; other roles stay on one personal sandbox branch. manual_only requires a human approve then promote."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.settings.patch", "mutation_risk": "low", "related_tools": ["generation.status", "generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Settings Patch", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin / generation operator required — not a sandbox head issue", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "sandbox_not_available": "auto_generation supply needs a paid tier — read generation.env_snapshot (gate) or generation.supply_status before patch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Set direct_prod_roles and auto_generation_approval_mode. Owners write prod; other roles stay on one personal sandbox branch. manual_only requires a human approve then promote."}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Enable sandbox auto-fork", "request": {"params": {"auto_generation_mode": true, "project_id": 1}, "tool": "generation.settings.patch"}, "response": {"data": {"project_id": 1, "settings": {"auto_generation_mode": true}}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_APPROVAL_MODES": "auto_generation_approval_mode: off | at_least_one | min_count | min_percent | manual_only. manual_only blocks auto-promote. generation.approve records one approver; promote waits until quorum. Legacy require_approval true means at_least_one.", "GENERATION_DIRECT_PROD": "direct_prod_roles (default owner) write production and skip auto-fork. Everyone else accumulates on their own open sandbox branch. Pass env_uuid or X-AgentStack-Env only to stay in a chosen sandbox."}, "instruction_hint": "Set direct_prod_roles and auto_generation_approval_mode. Owners write prod; other roles stay on one…", "mutation_kind": "entity", "next_actions": ["generation.status", "generation.diff_vs_prod"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.status", "generation.diff_vs_prod"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "generation_settings_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "PATCH auto_generation settings on the production project slice. Enable auto_generation_mode so tracked MCP mutations auto-fork to sandbox. REST parity: PATCH /api/generations/{id}/settings.", "title": "Generation Settings Patch", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin / generation operator required — not a sandbox head issue", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "sandbox_not_available": "auto_generation supply needs a paid tier — read generation.env_snapshot (gate) or generation.supply_status before patch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Set direct_prod_roles and auto_generation_approval_mode. Owners write prod; other roles stay on one personal sandbox branch. manual_only requires a human approve then promote.", "write_mode": null}, {"action": "generation.queue", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.queue", "related_tools": ["generation.gates", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Queue", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Promotion queue read failed — retry generation.env_snapshot once, else generation.list; do not fork to repair.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pending sandboxes with gate summary — then generation.gates and generation.promote."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.queue", "related_tools": ["generation.gates", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Queue", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Promotion queue read failed — retry generation.env_snapshot once, else generation.list; do not fork to repair.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pending sandboxes with gate summary — then generation.gates and generation.promote."}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Pending sandboxes before promote", "request": {"params": {"project_id": 1}, "tool": "generation.queue"}, "response": {"data": {"pending": [{"gates": [], "uuid": "<anchor>"}], "project_id": 1}, "success": true}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_APPROVAL_MODES": "auto_generation_approval_mode: off | at_least_one | min_count | min_percent | manual_only. manual_only blocks auto-promote. generation.approve records one approver; promote waits until quorum. Legacy require_approval true means at_least_one.", "GENERATION_LIST_UNAVAILABLE": "list_unavailable means catalog read failed, not an empty project — retry generation.env_snapshot once (env_uuid from fork if known), else generation.list once, then diagnose; do not fork to fill the list."}, "instruction_hint": "Pending sandboxes with gate summary — then generation.gates and generation.promote.", "mutation_kind": "none", "next_actions": ["generation.gates", "generation.promote"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.gates", "generation.promote"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_queue", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Promotion queue: pending sandbox generations with gate evaluation (REST parity).", "title": "Generation Queue", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Promotion queue read failed — retry generation.env_snapshot once, else generation.list; do not fork to repair.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Pending sandboxes with gate summary — then generation.gates and generation.promote.", "write_mode": null}, {"action": "generation.fork", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not fork for site byte edits — hosting.bucket.file.patch does not move 8DNA.", "anti_patterns": ["Do not fork for site byte edits — hosting.bucket.file.patch does not move 8DNA.", "Do not fork to repair list_unavailable or anchor_missing_from_list — diagnose first."], "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.fork", "mutation_risk": "low", "related_tools": ["generation.env_snapshot", "generation.supply_status", "generation.diff_vs_prod", "generation.gates", "generation.promote", "bots.order_manager_bootstrap", "knowledge.config.patch", "knowledge.config.get"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Fork", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "committed": "Settled sync fork: committed=true with state=ready — transport success=true even when older clients misread pending. committed=false or preview_only is not this contract; read MUTATION_RECEIPT_CONTRACT.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Sync fork failed or substrate receipt mismatch — read env_uuid from fork payload, then generation.env_snapshot once; if still lagging, generation.list with include_status=all; do not re-fork without idempotency policy.", "forked_count": "Count of entity rows inserted in the fork transaction (slices/manifest), not the number of committed environments or open anchors.", "generation_env_mismatch": "auto_generation_mode is off — call generation.fork or omit env_uuid on reads", "generation_fork_slice_collision": "Reuse fork env_uuid from receipt; generation.env_snapshot then diff — do not fork again to repair catalog lag", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — retry generation.env_snapshot once with fork env_uuid; do not fork to fill the list", "preflight_blocked": "Pair fork with knowledge.project_secrets.apply in one anchored batch when healing fleet after secrets — then diff_vs_prod, gates, promote as separate sync executes (GENERATION_SYNC_BATCH_BUDGET).", "projection_pending": "Catalog lag when committed=true and visibility.in_list is false — generation.env_snapshot once with fork env_uuid; then generation.diff_vs_prod if needed. Do not re-fork.", "sandbox_landing": "After successful fork: write_target=sandbox, on_production=false, ready_to_test=true, landing.committed=true — then generation.diff_vs_prod → generation.gates → generation.promote per auto_promote_strategy.", "sandbox_limit_exceeded": "Open-env quota full — promote, realign, or discard; do not spam fork", "sandbox_not_available": "Sandbox not on this tier — generation.supply_status; upgrade before manual fork. App Studio Vite source (ai_builder.source.*) writes prod disk directly — not fixed by generation.fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fork: committed=true, state=ready. Gate A=sandbox_gate.apply_ready (readiness≠apply). idempotent_replay=reuse. Next generation.env_snapshot with same env_uuid; supply_scope=gate if visibility.in_list "}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.fork", "mutation_risk": "low", "related_tools": ["generation.env_snapshot", "generation.supply_status", "generation.diff_vs_prod", "generation.gates", "generation.promote", "bots.order_manager_bootstrap", "knowledge.config.patch", "knowledge.config.get"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Fork", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "committed": "Settled sync fork: committed=true with state=ready — transport success=true even when older clients misread pending. committed=false or preview_only is not this contract; read MUTATION_RECEIPT_CONTRACT.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Sync fork failed or substrate receipt mismatch — read env_uuid from fork payload, then generation.env_snapshot once; if still lagging, generation.list with include_status=all; do not re-fork without idempotency policy.", "forked_count": "Count of entity rows inserted in the fork transaction (slices/manifest), not the number of committed environments or open anchors.", "generation_env_mismatch": "auto_generation_mode is off — call generation.fork or omit env_uuid on reads", "generation_fork_slice_collision": "Reuse fork env_uuid from receipt; generation.env_snapshot then diff — do not fork again to repair catalog lag", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — retry generation.env_snapshot once with fork env_uuid; do not fork to fill the list", "preflight_blocked": "Pair fork with knowledge.project_secrets.apply in one anchored batch when healing fleet after secrets — then diff_vs_prod, gates, promote as separate sync executes (GENERATION_SYNC_BATCH_BUDGET).", "projection_pending": "Catalog lag when committed=true and visibility.in_list is false — generation.env_snapshot once with fork env_uuid; then generation.diff_vs_prod if needed. Do not re-fork.", "sandbox_landing": "After successful fork: write_target=sandbox, on_production=false, ready_to_test=true, landing.committed=true — then generation.diff_vs_prod → generation.gates → generation.promote per auto_promote_strategy.", "sandbox_limit_exceeded": "Open-env quota full — promote, realign, or discard; do not spam fork", "sandbox_not_available": "Sandbox not on this tier — generation.supply_status; upgrade before manual fork. App Studio Vite source (ai_builder.source.*) writes prod disk directly — not fixed by generation.fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fork: committed=true, state=ready. Gate A=sandbox_gate.apply_ready (readiness≠apply). idempotent_replay=reuse. Next generation.env_snapshot with same env_uuid; supply_scope=gate if visibility.in_list "}, "do_not_use_when": "Not to fix empty generation.list — env_snapshot + diff_vs_prod first. Not for hosted site git or script.put — separate planes.", "domain": "generation", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Open sandbox before tenant leaf writes", "request": {"params": {"project_id": 1444}, "tool": "generation.fork"}, "response": {"data": {"anchor_uuid": "example-env-uuid", "committed": true, "env_uuid": "example-env-uuid", "generation": 3, "sandbox_landing": {"on_production": false, "ready_to_test": true, "write_target": "sandbox"}, "state": "ready"}, "success": true}}, {"name": "Idempotent slice collision reuse", "response": {"data": {"committed": true, "env_uuid": "example-env-uuid", "idempotent_replay": true, "state": "ready", "visibility": {"in_list": true}}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_GATE_AFTER_FORK": "After generation.fork, reuse data.env_uuid for mutations and Gate A probes — generation.env_snapshot (lightest) then bootstrap dry_run=true; generation.supply_status only when tier/quota needed. Batch context honors params.env_uuid when list lags (hydrate + memo bust).", "GENERATION_NEXT_ACTIONS_HINTS_ONLY": "next_actions and recovery_hint on gate reads are navigation hints, not operator consent to mutate prod. When sandbox_gate.apply_ready=false, STOP — do not auto-run generation.fork or dry_run=false bootstrap from agent loops. Exception: bots.order_manager_bootstrap dry_run=true is planning only — it does not require apply_ready; pass env_uuid from generation.fork before dry_run=false apply (Gate B).", "GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts.", "GENERATION_SANDBOX_QUOTA_ZERO": "Sandbox unavailable or quota zero — do not invent env_uuid; check generation.supply_status (supply_scope=gate) or generation.env_snapshot, then fork only when quota allows.", "GENERATION_STALE_ENV_UUID": "Stale generation_env_uuid (not found / not open): one generation.env_snapshot with env_uuid from the last fork receipt — omit stale uuid from context. bots.order_manager_bootstrap apply (dry_run=false) does not auto-fork; needs apply_ready."}, "instruction_hint": "Fork: committed=true, state=ready. Gate A=sandbox_gate.apply_ready (readiness≠apply). idempotent_re…", "mutation_kind": "entity", "next_actions": ["generation.env_snapshot", "generation.diff_vs_prod", "generation.gates"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"anchor_uuid": {"description": "string", "type": "string"}, "catalog_coherence": {"additionalProperties": true, "description": "object — committed_without_list_hit honesty (GAP-A)", "type": "object"}, "committed": {"description": "bool — true when the anchor insert finished", "type": "boolean"}, "env_uuid": {"description": "string — same as anchor_uuid", "type": "string"}, "forked_count": {"description": "int — entity rows inserted in fork transaction (slices); not committed env count", "type": "integer"}, "generation": {"description": "int", "type": "integer"}, "idempotent_replay": {"description": "bool — true when an open anchor was reused", "type": "boolean"}, "list_probe": {"additionalProperties": true, "description": "object — generation.env_snapshot when visibility.in_list=false", "type": "object"}, "next_actions": {"description": "array — runtime ladder from instruction_atoms", "items": {"type": "string"}, "type": "array"}, "sandbox_landing": {"additionalProperties": true, "description": "object", "type": "object"}, "state": {"description": "string — ready on success", "type": "string"}, "status": {"description": "string — anchor lifecycle (draft until a later mutation)", "type": "string"}, "visibility": {"additionalProperties": true, "description": "object — env_uuid, in_list, list_contract", "type": "object"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.env_snapshot", "generation.supply_status", "generation.diff_vs_prod", "generation.gates", "generation.promote", "bots.order_manager_bootstrap", "knowledge.config.patch", "knowledge.config.get"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "rollback": ["generation.realign_to_prod"], "safe_action": "generation_fork", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Fork production project into a new sandbox environment generation.", "title": "Generation Fork", "verification": ["generation.diff_vs_prod", "generation.gates"], "verify": [{"action": "generation.diff_vs_prod", "predicate": "named resource is visible"}, {"action": "generation.gates", "predicate": "named resource is visible"}], "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "committed": "Settled sync fork: committed=true with state=ready — transport success=true even when older clients misread pending. committed=false or preview_only is not this contract; read MUTATION_RECEIPT_CONTRACT.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Sync fork failed or substrate receipt mismatch — read env_uuid from fork payload, then generation.env_snapshot once; if still lagging, generation.list with include_status=all; do not re-fork without idempotency policy.", "forked_count": "Count of entity rows inserted in the fork transaction (slices/manifest), not the number of committed environments or open anchors.", "generation_env_mismatch": "auto_generation_mode is off — call generation.fork or omit env_uuid on reads", "generation_fork_slice_collision": "Reuse fork env_uuid from receipt; generation.env_snapshot then diff — do not fork again to repair catalog lag", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — retry generation.env_snapshot once with fork env_uuid; do not fork to fill the list", "preflight_blocked": "Pair fork with knowledge.project_secrets.apply in one anchored batch when healing fleet after secrets — then diff_vs_prod, gates, promote as separate sync executes (GENERATION_SYNC_BATCH_BUDGET).", "projection_pending": "Catalog lag when committed=true and visibility.in_list is false — generation.env_snapshot once with fork env_uuid; then generation.diff_vs_prod if needed. Do not re-fork.", "sandbox_landing": "After successful fork: write_target=sandbox, on_production=false, ready_to_test=true, landing.committed=true — then generation.diff_vs_prod → generation.gates → generation.promote per auto_promote_strategy.", "sandbox_limit_exceeded": "Open-env quota full — promote, realign, or discard; do not spam fork", "sandbox_not_available": "Sandbox not on this tier — generation.supply_status; upgrade before manual fork. App Studio Vite source (ai_builder.source.*) writes prod disk directly — not fixed by generation.fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Not to fix empty generation.list — env_snapshot + diff_vs_prod first. Not for hosted site git or script.put — separate planes.", "when_to_use": "Fork: committed=true, state=ready. Gate A=sandbox_gate.apply_ready (readiness≠apply). idempotent_replay=reuse. Next generation.env_snapshot with same env_uuid; supply_scope=gate if visibility.in_list", "write_mode": null}, {"action": "generation.canary.advance", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.canary.advance", "mutation_risk": "low", "related_tools": ["generation.status", "generation.canary.abort"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Canary Advance", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "invalid_state": "Anchor must be rolling_out — generation.status first", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Step canary traffic on a rolling_out anchor. Read generation.status first."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.canary.advance", "mutation_risk": "low", "related_tools": ["generation.status", "generation.canary.abort"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Canary Advance", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "invalid_state": "Anchor must be rolling_out — generation.status first", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Step canary traffic on a rolling_out anchor. Read generation.status first."}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "UF_F1 advance canary step after promote", "request": {"params": {"env_uuid": "<rolling-anchor>", "project_id": 1}, "tool": "generation.canary.advance"}, "response": {"data": {"status": "rolling_out", "step": 1, "traffic_weight": 25}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_CANARY_LADDER": "Canary traffic is generation.canary.advance / generation.canary.abort on a rolling_out anchor. Strategy comes from auto_promote_strategy — do not invent weights.", "GENERATION_ENV_OMIT": "Omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork."}, "instruction_hint": "Step canary traffic on a rolling_out anchor. Read generation.status first.", "mutation_kind": "none", "next_actions": ["generation.status"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"status": {"description": "string", "type": "string"}, "step": {"description": "int", "type": "integer"}, "traffic_weight": {"description": "int", "type": "integer"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.status", "generation.canary.abort"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "generation_canary_advance", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Advance canary rollout to the next traffic weight step.", "title": "Generation Canary Advance", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "invalid_state": "Anchor must be rolling_out — generation.status first", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Step canary traffic on a rolling_out anchor. Read generation.status first.", "write_mode": null}, {"action": "generation.canary.abort", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.canary.abort", "mutation_risk": "high", "related_tools": ["generation.status", "generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Canary Abort", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "invalid_state": "Nothing to abort unless status is rolling_out", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Stop a rolling canary and keep production on the previous head."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.canary.abort", "mutation_risk": "high", "related_tools": ["generation.status", "generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Canary Abort", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "invalid_state": "Nothing to abort unless status is rolling_out", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Stop a rolling canary and keep production on the previous head."}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Abort canary and restore prod pointer", "request": {"params": {"env_uuid": "<rolling-anchor>", "project_id": 1}, "tool": "generation.canary.abort"}, "response": {"data": {"restored_to": "<prod-anchor>", "status": "aborted", "traffic_weight": 0}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_CANARY_LADDER": "Canary traffic is generation.canary.advance / generation.canary.abort on a rolling_out anchor. Strategy comes from auto_promote_strategy — do not invent weights."}, "instruction_hint": "Stop a rolling canary and keep production on the previous head.", "mutation_kind": "none", "next_actions": ["generation.status"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"restored_to": {"description": "string", "type": "string"}, "status": {"description": "string", "type": "string"}, "traffic_weight": {"description": "int", "type": "integer"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.status", "generation.diff_vs_prod"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "generation_canary_abort", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Abort canary rollout and restore previous production pointer.", "title": "Generation Canary Abort", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "invalid_state": "Nothing to abort unless status is rolling_out", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Stop a rolling canary and keep production on the previous head.", "write_mode": null}, {"action": "generation.hosting.release", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.hosting.release", "mutation_risk": "low", "related_tools": ["hosting.release.promote", "generation.diff_vs_prod", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Hosting Release", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head; pin Gate A with generation.env_snapshot once (env_uuid from fork receipt if known).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "Confirm site_id from hosting.project.status — does not fork 8DNA", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Label an immutable hosting.release row with the open sandbox generation after bytes are on hosting.bucket (hosting.publish / hosting.deploy_files). Does not upload site files or fork 8DNA — follow wit"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.hosting.release", "mutation_risk": "low", "related_tools": ["hosting.release.promote", "generation.diff_vs_prod", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Hosting Release", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head; pin Gate A with generation.env_snapshot once (env_uuid from fork receipt if known).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "Confirm site_id from hosting.project.status — does not fork 8DNA", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Label an immutable hosting.release row with the open sandbox generation after bytes are on hosting.bucket (hosting.publish / hosting.deploy_files). Does not upload site files or fork 8DNA — follow wit"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "UF_F1 snapshot hosting release from sandbox", "request": {"params": {"env_uuid": "<sandbox-anchor>", "project_id": 1, "site_id": "demo-store"}, "tool": "generation.hosting.release"}, "response": {"data": {"preview_url": "https://example/s/1/demo-store-preview", "release_uuid": "<release-uuid>", "sandbox_generation": 12}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_HOSTING_RELEASE": "generation.hosting.release moves a site release pointer on DNA only. Live HTML/assets ship via hosting.publish (hosting.deploy_files), not this tool. Does not fork 8DNA or replace generation.promote."}, "instruction_hint": "Label an immutable hosting.release row with the open sandbox generation after bytes are on hosting.…", "mutation_kind": "none", "next_actions": ["generation.fork", "generation.hosting.release", "hosting.release.promote", "generation.status"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"preview_url": {"description": "string", "type": "string"}, "release_uuid": {"description": "string", "type": "string"}, "sandbox_generation": {"description": "int", "type": "integer"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["hosting.release.promote", "generation.diff_vs_prod", "generation.promote"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "generation_hosting_release", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Snapshot live hosting workspace into an immutable release labeled with sandbox generation. Does not swap canonical /s/ URL — follow with hosting.release.promote.", "title": "Generation Hosting Release", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head; pin Gate A with generation.env_snapshot once (env_uuid from fork receipt if known).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "Confirm site_id from hosting.project.status — does not fork 8DNA", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Label an immutable hosting.release row with the open sandbox generation after bytes are on hosting.bucket (hosting.publish / hosting.deploy_files). Does not upload site files or fork 8DNA — follow wit", "write_mode": null}, {"action": "generation.diff", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.diff", "related_tools": ["generation.diff_vs_prod", "generation.list", "generation.gates"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Diff", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_not_found": "Pass anchor UUIDs from fork receipt or generation.env_snapshot; else generation.list once — head slices are canonicalized server-side.", "insufficient_permissions": "DNA read denied — confirm project membership before compare", "invalid_parameters": "env_uuid_a and env_uuid_b required — use anchors from fork receipt or generation.env_snapshot; generation.list only for historical_all catalog.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compare two DNA entity UUIDs (anchors preferred). Head slices are canonicalized server-side."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.diff", "related_tools": ["generation.diff_vs_prod", "generation.list", "generation.gates"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Diff", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_not_found": "Pass anchor UUIDs from fork receipt or generation.env_snapshot; else generation.list once — head slices are canonicalized server-side.", "insufficient_permissions": "DNA read denied — confirm project membership before compare", "invalid_parameters": "env_uuid_a and env_uuid_b required — use anchors from fork receipt or generation.env_snapshot; generation.list only for historical_all catalog.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compare two DNA entity UUIDs (anchors preferred). Head slices are canonicalized server-side."}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Compare two sandbox anchors", "request": {"params": {"env_uuid_a": "<prod-head>", "env_uuid_b": "<sandbox-head>", "project_id": 1}, "tool": "generation.diff"}, "response": {"data": {"diff": {"deletes": [], "sets": []}, "env_uuid_a": "<prod-head>", "env_uuid_b": "<sandbox-head>"}, "success": true}}], "execution_class": "heavy", "generation_atoms": {"GENERATION_ENV_OMIT": "Omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork.", "GENERATION_STALE_ENV_UUID": "Stale generation_env_uuid (not found / not open): one generation.env_snapshot with env_uuid from the last fork receipt — omit stale uuid from context. bots.order_manager_bootstrap apply (dry_run=false) does not auto-fork; needs apply_ready.", "GENERATION_SYNC_BATCH_BUDGET": "generation.diff_vs_prod, generation.gates, and generation.diff are sync CPU-heavy — at most one per agentstack.execute (60s mcp_batch). Split UF_DIAGNOSE / mcp_generation_diff across separate executes; reuse fork env_uuid / generation.env_snapshot in the same batch via spine memo. UF_F1: diff_vs_prod stashes generation_promote_heads on _batch_preflight_spine; gates and promote peek it (one resolve+diff per batch context)."}, "instruction_hint": "Compare two DNA entity UUIDs (anchors preferred). Head slices are canonicalized server-side.", "mutation_kind": "none", "next_actions": ["generation.gates", "generation.promote"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"diff": {"description": "Structured diff {added, removed, modified}. Redacted to the JSON view budget.", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "effective_scope": {"description": "project_id and env UUIDs for this diff", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Logical project id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "shape": {"description": "mode, shipped, paths, hint when the diff is outline or refused", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.diff_vs_prod", "generation.list", "generation.gates"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_diff", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Structured diff between two resolved generation entity states (same table/project).", "title": "Generation Diff", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_not_found": "Pass anchor UUIDs from fork receipt or generation.env_snapshot; else generation.list once — head slices are canonicalized server-side.", "insufficient_permissions": "DNA read denied — confirm project membership before compare", "invalid_parameters": "env_uuid_a and env_uuid_b required — use anchors from fork receipt or generation.env_snapshot; generation.list only for historical_all catalog.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Compare two DNA entity UUIDs (anchors preferred). Head slices are canonicalized server-side.", "write_mode": null}, {"action": "generation.diff_vs_prod", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.diff_vs_prod", "related_tools": ["generation.promote", "generation.realign_to_prod", "generation.gates", "generation.diff", "knowledge.health", "knowledge.config.get", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Diff Vs Prod", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_not_found": "Omit generation_env_uuid — server keeps sandbox head; do not fork to repair list", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Review sandbox vs prod before promote. Omit generation_env_uuid — server uses this user's open fork. Pass env_uuid only to diff another person's fork. Returns source_revision prod_head:sandbox_head fo"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.diff_vs_prod", "related_tools": ["generation.promote", "generation.realign_to_prod", "generation.gates", "generation.diff", "knowledge.health", "knowledge.config.get", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Diff Vs Prod", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_not_found": "Omit generation_env_uuid — server keeps sandbox head; do not fork to repair list", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Review sandbox vs prod before promote. Omit generation_env_uuid — server uses this user's open fork. Pass env_uuid only to diff another person's fork. Returns source_revision prod_head:sandbox_head fo"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"audit_batch_allowed": true, "execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Pre-promote diagnosis (F1)", "request": {"params": {"project_id": 1}, "tool": "generation.diff_vs_prod"}, "response": {"data": {"agent_context": {"summary": "…"}, "content_vs_metadata": {}, "env_uuid": "<kept-anchor>"}, "success": true}}], "execution_class": "heavy", "generation_atoms": {"GENERATION_DIFF_SOURCE_REVISION": "CAS source_revision is prod_head_uuid:sandbox_head_uuid from the last generation.diff_vs_prod (also top-level source_revision). Use with generation.realign_to_prod / generation.discard before dry_run=false.", "GENERATION_ENV_OMIT": "Omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork.", "GENERATION_PROMOTE_HEADS_SPINE": "UF_F1: generation.diff_vs_prod resolves prod/sandbox heads once and stashes generation_promote_heads on _batch_preflight_spine. generation.gates and generation.promote peek that bundle in the same MCP batch context.", "GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts.", "GENERATION_STALE_ENV_UUID": "Stale generation_env_uuid (not found / not open): one generation.env_snapshot with env_uuid from the last fork receipt — omit stale uuid from context. bots.order_manager_bootstrap apply (dry_run=false) does not auto-fork; needs apply_ready.", "GENERATION_SYNC_BATCH_BUDGET": "generation.diff_vs_prod, generation.gates, and generation.diff are sync CPU-heavy — at most one per agentstack.execute (60s mcp_batch). Split UF_DIAGNOSE / mcp_generation_diff across separate executes; reuse fork env_uuid / generation.env_snapshot in the same batch via spine memo. UF_F1: diff_vs_prod stashes generation_promote_heads on _batch_preflight_spine; gates and promote peek it (one resolve+diff per batch context)."}, "instruction_hint": "Review sandbox vs prod before promote. Omit generation_env_uuid — server uses this user's open fork…", "mutation_kind": "none", "next_actions": ["generation.gates", "generation.realign_to_prod"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent_context": {"description": "Diagnosis summary: counts, domains, sample paths", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "diff": {"description": "Structured diff {added, removed, modified}. Redacted to the JSON view budget.", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "effective_scope": {"description": "project_id and env UUIDs for this diff", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "prod_head_uuid": {"description": "Stable production anchor UUID", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Logical project id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "sandbox_head_uuid": {"description": "Sandbox anchor UUID under diff", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "shape": {"description": "mode, shipped, paths, hint when the diff is outline or refused", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "source_revision": {"description": "CAS token prod_head_uuid:sandbox_head_uuid for realign/discard", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.promote", "generation.realign_to_prod", "generation.gates", "generation.diff", "knowledge.health", "knowledge.config.get", "preflight.check"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_diff_vs_prod", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Diff stable production head vs pending sandbox head. Includes agent_context summary for diagnosis (counts, domains, sample paths). instruction_slice and recovery_hint use context.locale / instruction_", "title": "Generation Diff Vs Prod", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_not_found": "Omit generation_env_uuid — server keeps sandbox head; do not fork to repair list", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Review sandbox vs prod before promote. Omit generation_env_uuid — server uses this user's open fork. Pass env_uuid only to diff another person's fork. Returns source_revision prod_head:sandbox_head fo", "write_mode": null}, {"action": "generation.realign_to_prod", "aliases": ["generation.discard"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.realign_to_prod", "mutation_risk": "high", "related_tools": ["generation.diff_vs_prod", "generation.promote", "generation.discard"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Realign To Prod", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_not_found": "omit generation_env_uuid — server keeps sandbox head", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "mutation_applied_partial": "generation.diff_vs_prod — partial realign; retry or widen path_prefixes", "parallel_canonical_drift": "realign is the recovery path — dry_run first", "realign_source_revision_conflict": "Re-read generation.diff_vs_prod and pass source_revision", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discard sandbox edits — dry_run first. Not a substitute for promote."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.realign_to_prod", "mutation_risk": "high", "related_tools": ["generation.diff_vs_prod", "generation.promote", "generation.discard"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Realign To Prod", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_not_found": "omit generation_env_uuid — server keeps sandbox head", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "mutation_applied_partial": "generation.diff_vs_prod — partial realign; retry or widen path_prefixes", "parallel_canonical_drift": "realign is the recovery path — dry_run first", "realign_source_revision_conflict": "Re-read generation.diff_vs_prod and pass source_revision", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discard sandbox edits — dry_run first. Not a substitute for promote."}, "do_not_use_when": "Not a substitute for promote — discards sandbox only.", "domain": "generation", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Discard sandbox drift (dry_run first)", "request": {"params": {"dry_run": true, "project_id": 1}, "tool": "generation.realign_to_prod"}, "response": {"data": {"applied_deletes": 0, "applied_sets": 0, "source_revision": "prod:sandbox"}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_ENV_OMIT": "Omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork.", "GENERATION_REALIGN_DRY_RUN": "Discard sandbox edits — generation.realign_to_prod dry_run first; path_prefixes for partial revert; not a substitute for promote."}, "instruction_hint": "Discard sandbox edits — dry_run first. Not a substitute for promote.", "mutation_kind": "entity", "next_actions": ["generation.diff_vs_prod", "generation.promote"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent_context": {"additionalProperties": true, "description": "object", "type": "object"}, "applied_deletes": {"description": "int", "type": "integer"}, "applied_sets": {"description": "int", "type": "integer"}, "source_revision": {"description": "string", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.diff_vs_prod", "generation.promote", "generation.discard"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "rollback": [], "safe_action": "generation_realign_to_prod", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Revert pending sandbox DNA toward stable production by applying inverse diff (leaf jsonb_set / path delete on sandbox anchor — no full-blob wipe). Optional path_prefixes for partial revert.", "title": "Generation Realign To Prod", "verification": ["generation.diff_vs_prod", "generation.list"], "verify": [{"action": "generation.diff_vs_prod", "predicate": "named resource is visible"}, {"action": "generation.list", "predicate": "named resource is visible"}], "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_not_found": "omit generation_env_uuid — server keeps sandbox head", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "mutation_applied_partial": "generation.diff_vs_prod — partial realign; retry or widen path_prefixes", "parallel_canonical_drift": "realign is the recovery path — dry_run first", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "realign_source_revision_conflict": "Re-read generation.diff_vs_prod and pass source_revision", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Not a substitute for promote — discards sandbox only.", "when_to_use": "Discard sandbox edits — dry_run first. Not a substitute for promote.", "write_mode": null}, {"action": "generation.discard", "alias_of": "generation.realign_to_prod", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.discard", "mutation_risk": "high", "related_tools": ["generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Discard", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — retry generation.env_snapshot once (env_uuid from fork if known), else generation.list once; do not invent env_uuid; do not fork to fill the list.", "mutation_applied_partial": "generation.diff_vs_prod — partial discard; retry or widen path_prefixes", "realign_source_revision_conflict": "Re-read generation.diff_vs_prod and pass source_revision. dry_run stays true until the token matches.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Safe name for realign. Defaults to dry_run=true even after the alias rewrite."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.discard", "mutation_risk": "high", "related_tools": ["generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Discard", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — retry generation.env_snapshot once (env_uuid from fork if known), else generation.list once; do not invent env_uuid; do not fork to fill the list.", "mutation_applied_partial": "generation.diff_vs_prod — partial discard; retry or widen path_prefixes", "realign_source_revision_conflict": "Re-read generation.diff_vs_prod and pass source_revision. dry_run stays true until the token matches.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Safe name for realign. Defaults to dry_run=true even after the alias rewrite."}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "UF_F1 discard sandbox (dry_run first)", "request": {"params": {"dry_run": true, "project_id": 1}, "tool": "generation.discard"}, "response": {"data": {"applied_deletes": 0, "applied_sets": 0, "source_revision": "prod:sandbox"}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_DISCARD": "generation.discard is generation.realign_to_prod with dry_run default true. Pass source_revision from the last diff. dry_run=false applies the revert.", "GENERATION_REALIGN_DRY_RUN": "Discard sandbox edits — generation.realign_to_prod dry_run first; path_prefixes for partial revert; not a substitute for promote."}, "instruction_hint": "Safe name for realign. Defaults to dry_run=true even after the alias rewrite.", "mutation_kind": "none", "next_actions": ["generation.diff_vs_prod"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.diff_vs_prod"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "generation_discard", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Discard sandbox changes (Postel alias for generation.realign_to_prod). Defaults to dry_run=true — set dry_run=false to apply.", "title": "Generation Discard", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — retry generation.env_snapshot once (env_uuid from fork if known), else generation.list once; do not invent env_uuid; do not fork to fill the list.", "mutation_applied_partial": "generation.diff_vs_prod — partial discard; retry or widen path_prefixes", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "realign_source_revision_conflict": "Re-read generation.diff_vs_prod and pass source_revision. dry_run stays true until the token matches.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Safe name for realign. Defaults to dry_run=true even after the alias rewrite.", "write_mode": null}, {"action": "generation.archive", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not generation.promote an empty draft to leave the pending queue.", "anti_patterns": ["Do not generation.promote an empty draft to leave the pending queue.", "Do not cascade-delete a live or rolling_out anchor."], "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.archive", "mutation_risk": "low", "related_tools": ["generation.diff_vs_prod", "generation.realign_to_prod", "generation.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Archive", "when_blocked": {"archive_refused": "Only draft, validating, and ready can be archived. rolling_out uses generation.canary.abort. Do not promote to clear the queue.", "batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_not_found": "Pass anchor uuid from fork receipt or generation.env_snapshot — do not fork again", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drop an empty or abandoned draft from the pending queue. cascade defaults false. Live and rolling_out use canary abort, not archive."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.archive", "mutation_risk": "low", "related_tools": ["generation.diff_vs_prod", "generation.realign_to_prod", "generation.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Archive", "when_blocked": {"archive_refused": "Only draft, validating, and ready can be archived. rolling_out uses generation.canary.abort. Do not promote to clear the queue.", "batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_not_found": "Pass anchor uuid from fork receipt or generation.env_snapshot — do not fork again", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drop an empty or abandoned draft from the pending queue. cascade defaults false. Live and rolling_out use canary abort, not archive."}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "examples": [{"name": "Archive open sandbox without promote", "request": {"params": {"env_uuid": "<sandbox-anchor>", "project_id": 1}, "tool": "generation.archive"}, "response": {"data": {"deleted": 0, "env_uuid": "<sandbox-anchor>", "status": "archived"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Drop an empty or abandoned draft from the pending queue. cascade defaults false. Live and rolling_o…", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.diff_vs_prod", "generation.realign_to_prod", "generation.list"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "generation_archive", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Archive an open sandbox anchor (draft, validating, or ready). Does not promote. cascade defaults false and only sets status=archived.", "title": "Generation Archive", "when_blocked": {"archive_refused": "Only draft, validating, and ready can be archived. rolling_out uses generation.canary.abort. Do not promote to clear the queue.", "batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_not_found": "Pass anchor uuid from fork receipt or generation.env_snapshot — do not fork again", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Drop an empty or abandoned draft from the pending queue. cascade defaults false. Live and rolling_out use canary abort, not archive.", "write_mode": null}, {"action": "generation.pointer.set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.pointer.set", "related_tools": ["generation.status", "generation.env_snapshot", "generation.realign_to_prod"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Pointer Set", "when_blocked": {"active_env_uuid_required": "Pass anchor uuid from generation.fork — default dry_run=true before apply", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project_admin — auth.get_profile and projects membership", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "active_env_uuid (or env_uuid) required — generation.env_snapshot or fork receipt"}, "when_to_use": "Repair split-brain active_env_uuid without discarding sandbox content. Default dry_run=true; project_admin; call after fork confusion or pointer drift."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.pointer.set", "related_tools": ["generation.status", "generation.env_snapshot", "generation.realign_to_prod"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Pointer Set", "when_blocked": {"active_env_uuid_required": "Pass anchor uuid from generation.fork — default dry_run=true before apply", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project_admin — auth.get_profile and projects membership", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "active_env_uuid (or env_uuid) required — generation.env_snapshot or fork receipt"}, "when_to_use": "Repair split-brain active_env_uuid without discarding sandbox content. Default dry_run=true; project_admin; call after fork confusion or pointer drift."}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Repair split-brain active_env_uuid without discarding sandbox content. Default dry_run=true; projec…", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.status", "generation.env_snapshot", "generation.realign_to_prod"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "generation_pointer_set", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Repair split-brain: set active_env_uuid without discarding sandbox content (TG1692 C09). Default dry_run=true.", "title": "Generation Pointer Set", "when_blocked": {"active_env_uuid_required": "Pass anchor uuid from generation.fork — default dry_run=true before apply", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project_admin — auth.get_profile and projects membership", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "active_env_uuid (or env_uuid) required — generation.env_snapshot or fork receipt"}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Repair split-brain active_env_uuid without discarding sandbox content. Default dry_run=true; project_admin; call after fork confusion or pointer drift.", "write_mode": null}, {"action": "generation.promote", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not promote on parallel_canonical_drift — realign sandbox first.", "anti_patterns": ["Do not promote on parallel_canonical_drift — realign sandbox first.", "Do not promote from diagnosis-only batches (UF_DIAGNOSE)."], "budget_note": "Run only after diff+gates in prior executes — never pair with generation.gates (GENERATION_SYNC_BATCH_BUDGET).", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.promote", "mutation_risk": "high", "related_tools": ["generation.gates", "generation.timeline", "generation.status", "knowledge.project_secrets.apply", "knowledge.config.patch", "knowledge.health", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Promote", "when_blocked": {"accepted_not_committed": "Transport accepted≠settled success — wait for committed=true or use SDK isPromoteSettled(receipt).success; do not treat accepted alone as promote done.", "anchor_missing_from_list": "Pin env_uuid from fork receipt; generation.env_snapshot then generation.diff_vs_prod — do not fork to repair projection lag", "batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "content_merge_noop": "Content merge would apply zero leaves — generation.diff_vs_prod then realign or edit sandbox.", "content_merge_partial": "Promote aborted after partial DNA merge — pointer not advanced; fix delete/set paths.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "diff_unavailable": "Heads differ but diff missing — retry generation.promote in a fresh execute with generation.diff_vs_prod first.", "gates_failed": "Do not promote — read generation.gates output", "gates_not_passed": "Run generation.gates — all rows must be pass or skip", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "manual_approval_required": "Call generation.approve until approval_mode quorum is met — then generation.promote", "metadata_only_blocked": "Diff is environment metadata only — generation.realign_to_prod (dry_run) or add active-content leaves before generation.promote.", "parallel_canonical_drift": "generation.realign_to_prod — do not retry promote", "preflight_blocked": "After knowledge.project_secrets.apply (bots_run): generation.diff_vs_prod → generation.gates → generation.promote — not VPS deploy scripts.", "promote_noop": "No-op promote — verify script.list (no env) and applied_paths. Do not re-promote blindly; use generation.diff_vs_prod.", "promote_split_brain_unmerged": "Pointer pre-aligned but prod head missing scripts — re-promote after fix; confirm content_merge.applied_paths and script.list.", "promotion_checks_failed": "Read promotion checks — fix sandbox before promote", "receipt_not_settled": "Poll / re-read promote receipt until committed=true (or isPromoteSettled). accepted=false on a committed receipt is normal.", "require_gates_passed": "generation.gates must pass — auto_promote_strategy from project settings", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move sandbox anchor to prod after diff + gates. Strategy from auto_promote_strategy; require_gates_passed defaults on when mode on. Peeks generation_promote_heads from diff/gates in the same batch con"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.promote", "mutation_risk": "high", "related_tools": ["generation.gates", "generation.timeline", "generation.status", "knowledge.project_secrets.apply", "knowledge.config.patch", "knowledge.health", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Promote", "when_blocked": {"accepted_not_committed": "Transport accepted≠settled success — wait for committed=true or use SDK isPromoteSettled(receipt).success; do not treat accepted alone as promote done.", "anchor_missing_from_list": "Pin env_uuid from fork receipt; generation.env_snapshot then generation.diff_vs_prod — do not fork to repair projection lag", "batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "content_merge_noop": "Content merge would apply zero leaves — generation.diff_vs_prod then realign or edit sandbox.", "content_merge_partial": "Promote aborted after partial DNA merge — pointer not advanced; fix delete/set paths.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "diff_unavailable": "Heads differ but diff missing — retry generation.promote in a fresh execute with generation.diff_vs_prod first.", "gates_failed": "Do not promote — read generation.gates output", "gates_not_passed": "Run generation.gates — all rows must be pass or skip", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "manual_approval_required": "Call generation.approve until approval_mode quorum is met — then generation.promote", "metadata_only_blocked": "Diff is environment metadata only — generation.realign_to_prod (dry_run) or add active-content leaves before generation.promote.", "parallel_canonical_drift": "generation.realign_to_prod — do not retry promote", "preflight_blocked": "After knowledge.project_secrets.apply (bots_run): generation.diff_vs_prod → generation.gates → generation.promote — not VPS deploy scripts.", "promote_noop": "No-op promote — verify script.list (no env) and applied_paths. Do not re-promote blindly; use generation.diff_vs_prod.", "promote_split_brain_unmerged": "Pointer pre-aligned but prod head missing scripts — re-promote after fix; confirm content_merge.applied_paths and script.list.", "promotion_checks_failed": "Read promotion checks — fix sandbox before promote", "receipt_not_settled": "Poll / re-read promote receipt until committed=true (or isPromoteSettled). accepted=false on a committed receipt is normal.", "require_gates_passed": "generation.gates must pass — auto_promote_strategy from project settings", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move sandbox anchor to prod after diff + gates. Strategy from auto_promote_strategy; require_gates_passed defaults on when mode on. Peeks generation_promote_heads from diff/gates in the same batch con"}, "do_not_use_when": "Not for Nahual script-only coop on prod without gates — diff_vs_prod + gates first. Not hosting git promote (remote agentstack, branch dev).", "domain": "generation", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "UF_F1 promote after gates", "request": {"params": {"env_uuid": "<sandbox-anchor-uuid>", "project_id": 1, "require_gates_passed": true}, "tool": "generation.promote"}, "response": {"data": {"env_uuid": "<sandbox-anchor-uuid>", "status": "completed", "strategy": "immediate"}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_APPROVAL_MODES": "auto_generation_approval_mode: off | at_least_one | min_count | min_percent | manual_only. manual_only blocks auto-promote. generation.approve records one approver; promote waits until quorum. Legacy require_approval true means at_least_one.", "GENERATION_ENV_OMIT": "Omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork.", "GENERATION_NOT_GIT": "generation.promote moves 8DNA (config, fleet, knowledge), not git and not site bytes. Hosting git remote is named agentstack; default push is branch dev (preview). Live site is branch main or hosting.git.promote_branch with bucket_id, ref=dev, target=prod. Pass env_uuid on the write params or the server may bind a different open fork. Do not promote a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. Platform agentstack-core and shared often have no remote — those ship by VPS deploy.", "GENERATION_PARALLEL_DRIFT": "parallel_canonical_drift blocks promote when the sandbox would delete canonical money.expenses — generation.realign_to_prod, do not promote again.", "GENERATION_PROMOTE_HEADS_SPINE": "UF_F1: generation.diff_vs_prod resolves prod/sandbox heads once and stashes generation_promote_heads on _batch_preflight_spine. generation.gates and generation.promote peek that bundle in the same MCP batch context.", "GENERATION_PROMOTE_VERIFY": "AFTER generation.promote: (1) settled success = committed=true or SDK isPromoteSettled(receipt).success — accepted≠settled, (2) prod_head changed OR effect=noop expected, (3) script.list without env shows script_id+code_hash, (4) diff_vs_prod empty for promoted script paths, (5) on failure STOP — no re-promote, no realign_to_prod discard. See docs/operations/MP_PROMOTE_RECEIPT_LITERACY.md.", "GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts.", "GENERATION_SYNC_BATCH_BUDGET": "generation.diff_vs_prod, generation.gates, and generation.diff are sync CPU-heavy — at most one per agentstack.execute (60s mcp_batch). Split UF_DIAGNOSE / mcp_generation_diff across separate executes; reuse fork env_uuid / generation.env_snapshot in the same batch via spine memo. UF_F1: diff_vs_prod stashes generation_promote_heads on _batch_preflight_spine; gates and promote peek it (one resolve+diff per batch context)."}, "instruction_hint": "Move sandbox anchor to prod after diff + gates. Strategy from auto_promote_strategy; require_gates_…", "mutation_kind": "entity", "next_actions": ["generation.env_snapshot", "generation.status", "generation.timeline"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"approval_mode": {"description": "On manual_approval_required error — same as generation.queue", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "approval_quorum": {"description": "On manual_approval_required error", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "approver_count": {"description": "On manual_approval_required error", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "checkpoint_uuid": {"description": "Prod checkpoint before promote when enabled", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "checks": {"description": "{schema_valid, depth_ok, conflict_free, health_ok}", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "committed": {"description": "False for promote_noop / fail-closed receipts", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "content_merge": {"description": "Leaf merge receipt from promote_content_merge", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "effect": {"description": "changed | partial | noop | metadata_only", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "env_uuid": {"description": "Sandbox anchor promoted", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "generation_manual_ok": {"description": "False until quorum met", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "mutation_receipt": {"description": "Post-promote receipt for client poll", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "no_op_reason": {"description": "already_live_head | content_merge_noop when aligned", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "ok": {"description": "TG1692 honest apply — false for noop unless allow_noop", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "poll_hints": {"description": "Suggested poll actions for UI/agents", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "prod_head_after": {"description": "Prod head UUID after promote", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "prod_head_before": {"description": "Prod head UUID before merge", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "prod_head_uuid": {"description": "Canonical prod head after settle", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "projection": {"description": "Read-model lag hints", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "promotion_request_uuid": {"description": "Async promotion job id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "reconciled_pointer_pre_aligned": {"description": "Split-brain pointer pre-aligned repair", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "sandbox_head_uuid": {"description": "Sandbox head used for diff/merge", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "status": {"description": "queued | running | completed | failed", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.gates", "generation.timeline", "generation.status", "knowledge.project_secrets.apply", "knowledge.config.patch", "knowledge.health", "preflight.check"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "rollback": ["generation.rollback", "generation.checkpoint"], "safe_action": "generation_promote", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Promote a sandbox environment to production (runs promotion checks first). instruction_slice and recovery_hint use context.locale / instruction_locale.", "title": "Generation Promote", "verification": ["generation.status", "generation.diff_vs_prod"], "verify": [{"action": "generation.status", "predicate": "named resource is visible"}, {"action": "generation.diff_vs_prod", "predicate": "named resource is visible"}], "when_blocked": {"accepted_not_committed": "Transport accepted≠settled success — wait for committed=true or use SDK isPromoteSettled(receipt).success; do not treat accepted alone as promote done.", "anchor_missing_from_list": "Pin env_uuid from fork receipt; generation.env_snapshot then generation.diff_vs_prod — do not fork to repair projection lag", "batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "content_merge_noop": "Content merge would apply zero leaves — generation.diff_vs_prod then realign or edit sandbox.", "content_merge_partial": "Promote aborted after partial DNA merge — pointer not advanced; fix delete/set paths.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "diff_unavailable": "Heads differ but diff missing — retry generation.promote in a fresh execute with generation.diff_vs_prod first.", "gates_failed": "Do not promote — read generation.gates output", "gates_not_passed": "Run generation.gates — all rows must be pass or skip", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "manual_approval_required": "Call generation.approve until approval_mode quorum is met — then generation.promote", "metadata_only_blocked": "Diff is environment metadata only — generation.realign_to_prod (dry_run) or add active-content leaves before generation.promote.", "parallel_canonical_drift": "generation.realign_to_prod — do not retry promote", "preflight_blocked": "After knowledge.project_secrets.apply (bots_run): generation.diff_vs_prod → generation.gates → generation.promote — not VPS deploy scripts.", "promote_noop": "No-op promote — verify script.list (no env) and applied_paths. Do not re-promote blindly; use generation.diff_vs_prod.", "promote_split_brain_unmerged": "Pointer pre-aligned but prod head missing scripts — re-promote after fix; confirm content_merge.applied_paths and script.list.", "promotion_checks_failed": "Read promotion checks — fix sandbox before promote", "receipt_not_settled": "Poll / re-read promote receipt until committed=true (or isPromoteSettled). accepted=false on a committed receipt is normal.", "require_gates_passed": "generation.gates must pass — auto_promote_strategy from project settings", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Not for Nahual script-only coop on prod without gates — diff_vs_prod + gates first. Not hosting git promote (remote agentstack, branch dev).", "when_to_use": "Move sandbox anchor to prod after diff + gates. Strategy from auto_promote_strategy; require_gates_passed defaults on when mode on. Peeks generation_promote_heads from diff/gates in the same batch con", "write_mode": null}, {"action": "generation.approve", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.approve", "mutation_risk": "low", "related_tools": ["generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Approve", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "manual_approval_required": "Response includes approval_quorum and approver_count — call approve again or wait for another operator, then generation.promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Record one approver on the sandbox anchor. Promote stays blocked until the approval mode quorum is met."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.approve", "mutation_risk": "low", "related_tools": ["generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Approve", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "manual_approval_required": "Response includes approval_quorum and approver_count — call approve again or wait for another operator, then generation.promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Record one approver on the sandbox anchor. Promote stays blocked until the approval mode quorum is met."}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Manual approval before promote", "request": {"params": {"env_uuid": "<sandbox-anchor>", "note": "ops ok", "project_id": 1}, "tool": "generation.approve"}, "response": {"data": {"env_uuid": "<sandbox-anchor>", "gates": [{"name": "manual", "status": "pass"}]}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_APPROVAL_MODES": "auto_generation_approval_mode: off | at_least_one | min_count | min_percent | manual_only. manual_only blocks auto-promote. generation.approve records one approver; promote waits until quorum. Legacy require_approval true means at_least_one."}, "instruction_hint": "Record one approver on the sandbox anchor. Promote stays blocked until the approval mode quorum is …", "mutation_kind": "none", "next_actions": ["generation.promote"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"all_passed": {"description": "True when every gate status is pass", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "approval_mode": {"description": "off | at_least_one | min_count | min_percent | manual_only", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "approval_quorum": {"description": "Approvers required before promote", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "approver_count": {"description": "len(approver_user_ids)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "approver_user_ids": {"description": "User ids recorded on anchor", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "eligible_operators": {"description": "Operators who may approve", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "gates": {"description": "List of {gate_name, status, message, details}", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "generation_manual_ok": {"description": "True when approval quorum is met", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.promote"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "generation_approve", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Mark manual generation approval on anchor and re-run gate evaluation.", "title": "Generation Approve", "verification": ["generation.gates", "generation.status"], "verify": [{"action": "generation.gates", "predicate": "named resource is visible"}, {"action": "generation.status", "predicate": "named resource is visible"}], "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "manual_approval_required": "Response includes approval_quorum and approver_count — call approve again or wait for another operator, then generation.promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Record one approver on the sandbox anchor. Promote stays blocked until the approval mode quorum is met.", "write_mode": null}, {"action": "generation.gates", "aliases": ["generation.run_gates"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.gates", "related_tools": ["generation.promote", "generation.realign_to_prod", "knowledge.health", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Gates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "gates_failed": "Fix failing gates before promote — generation.diff_vs_prod first", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "require_gates_passed": "Run generation.gates with require_gates_passed_on_promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run gates before promote. Omit generation_env_uuid; soak pending may need re-poll. Optional manual_approved=true (REST parity). Does not auto-promote — call generation.promote. Peeks batch promote_hea"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.gates", "related_tools": ["generation.promote", "generation.realign_to_prod", "knowledge.health", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Gates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "gates_failed": "Fix failing gates before promote — generation.diff_vs_prod first", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "require_gates_passed": "Run generation.gates with require_gates_passed_on_promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run gates before promote. Omit generation_env_uuid; soak pending may need re-poll. Optional manual_approved=true (REST parity). Does not auto-promote — call generation.promote. Peeks batch promote_hea"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"execution_class": "heavy", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "examples": [{"name": "UF_F1 gate chain before promote", "request": {"params": {"env_uuid": "<sandbox-anchor>", "project_id": 1}, "tool": "generation.gates"}, "response": {"data": {"env_uuid": "<sandbox-anchor>", "gates": [{"name": "schema", "status": "pass"}]}, "success": true}}], "execution_class": "heavy", "generation_atoms": {"GENERATION_ENV_OMIT": "Omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork.", "GENERATION_GATES_MANUAL_APPROVED": "generation.gates optional manual_approved=true marks the manual approval gate passed (REST POST gates/run parity). Quorum still needs generation.approve when approval_mode requires it.", "GENERATION_PROMOTE_HEADS_SPINE": "UF_F1: generation.diff_vs_prod resolves prod/sandbox heads once and stashes generation_promote_heads on _batch_preflight_spine. generation.gates and generation.promote peek that bundle in the same MCP batch context.", "GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts.", "GENERATION_SYNC_BATCH_BUDGET": "generation.diff_vs_prod, generation.gates, and generation.diff are sync CPU-heavy — at most one per agentstack.execute (60s mcp_batch). Split UF_DIAGNOSE / mcp_generation_diff across separate executes; reuse fork env_uuid / generation.env_snapshot in the same batch via spine memo. UF_F1: diff_vs_prod stashes generation_promote_heads on _batch_preflight_spine; gates and promote peek it (one resolve+diff per batch context)."}, "instruction_hint": "Run gates before promote. Omit generation_env_uuid; soak pending may need re-poll. Optional manual_…", "mutation_kind": "none", "next_actions": ["generation.promote", "generation.realign_to_prod"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"all_passed": {"description": "True when every gate status is pass", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "approval_mode": {"description": "off | at_least_one | min_count | min_percent | manual_only", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "approval_quorum": {"description": "Approvers required before promote", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "approver_count": {"description": "len(approver_user_ids)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "approver_user_ids": {"description": "User ids recorded on anchor", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "eligible_operators": {"description": "Operators who may approve", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "gates": {"description": "List of {gate_name, status, message, details}", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "generation_manual_ok": {"description": "True when approval quorum is met", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.promote", "generation.realign_to_prod", "knowledge.health", "preflight.check"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_gates", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Run generation gate chain for an environment (schema, conflict, health, soak, metrics, optional manual).", "title": "Generation Gates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "gates_failed": "Fix failing gates before promote — generation.diff_vs_prod first", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "require_gates_passed": "Run generation.gates with require_gates_passed_on_promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Run gates before promote. Omit generation_env_uuid; soak pending may need re-poll. Optional manual_approved=true (REST parity). Does not auto-promote — call generation.promote. Peeks batch promote_hea", "write_mode": null}, {"action": "generation.notify", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.notify", "related_tools": ["generation.status", "generation.timeline"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Notify", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "No open fork — omit env_uuid; notify does not promote or change DNA", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Notify operators about a generation anchor (audit/webhook). Does not approve or promote."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.notify", "related_tools": ["generation.status", "generation.timeline"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Notify", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "No open fork — omit env_uuid; notify does not promote or change DNA", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Notify operators about a generation anchor (audit/webhook). Does not approve or promote."}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Manual notify after promote (audit)", "request": {"params": {"env_uuid": "<anchor>", "message": "Promote complete — verify Gate D", "project_id": 1}, "tool": "generation.notify"}, "response": {"data": {"ok": true, "project_id": 1}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_NOTIFY": "generation.notify pings operators about a sandbox anchor. It does not promote, approve, or change DNA."}, "instruction_hint": "Notify operators about a generation anchor (audit/webhook). Does not approve or promote.", "mutation_kind": "none", "next_actions": ["generation.status", "generation.gates"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.status", "generation.timeline"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "generation_notify", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Manual generation notify — webhooks, audit log, optional in-app notification.", "title": "Generation Notify", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "No open fork — omit env_uuid; notify does not promote or change DNA", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Notify operators about a generation anchor (audit/webhook). Does not approve or promote.", "write_mode": null}, {"action": "generation.checkpoint", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.checkpoint", "mutation_risk": "low", "related_tools": ["generation.rollback", "generation.promote", "generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Checkpoint", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Omit env_uuid for merged head or pass open anchor from fork receipt / generation.env_snapshot; generation.list only for queue/historical catalog.", "sandbox_limit_exceeded": "Free a sandbox slot before checkpoint — promote or discard first", "sandbox_not_available": "Free/starter sandbox off — generation.supply_status; upgrade before auto_generation_mode or fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Snapshot merged DNA before a risky promote or bulk edit."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.checkpoint", "mutation_risk": "low", "related_tools": ["generation.rollback", "generation.promote", "generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Checkpoint", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Omit env_uuid for merged head or pass open anchor from fork receipt / generation.env_snapshot; generation.list only for queue/historical catalog.", "sandbox_limit_exceeded": "Free a sandbox slot before checkpoint — promote or discard first", "sandbox_not_available": "Free/starter sandbox off — generation.supply_status; upgrade before auto_generation_mode or fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Snapshot merged DNA before a risky promote or bulk edit."}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "UF_F1 checkpoint before risky bulk edit", "request": {"params": {"label": "pre-bulk", "project_id": 1}, "tool": "generation.checkpoint"}, "response": {"data": {"checkpoint_uuid": "<checkpoint-uuid>", "generation": 12, "label": "pre-bulk"}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_CHECKPOINT_LADDER": "generation.checkpoint snapshots merged DNA. generation.rollback opens that checkpoint as a new draft sandbox. Restore prod only via generation.promote."}, "instruction_hint": "Snapshot merged DNA before a risky promote or bulk edit.", "mutation_kind": "none", "next_actions": ["generation.rollback", "generation.promote"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.rollback", "generation.promote", "generation.diff_vs_prod"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "generation_checkpoint", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Materialise merged production/sandbox DNA into a checkpoint generation (rollback SoT). Use before risky bulk edits; rollback via generation.rollback.", "title": "Generation Checkpoint", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Omit env_uuid for merged head or pass open anchor from fork receipt / generation.env_snapshot; generation.list only for queue/historical catalog.", "sandbox_limit_exceeded": "Free a sandbox slot before checkpoint — promote or discard first", "sandbox_not_available": "Free/starter sandbox off — generation.supply_status; upgrade before auto_generation_mode or fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Snapshot merged DNA before a risky promote or bulk edit.", "write_mode": null}, {"action": "generation.rollback", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.rollback", "mutation_risk": "high", "related_tools": ["generation.checkpoint", "generation.promote", "generation.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Rollback", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "checkpoint_uuid must come from generation.checkpoint", "sandbox_limit_exceeded": "Promote, discard, or realign an open anchor before opening rollback draft", "sandbox_not_available": "generation.env_snapshot supply_scope=gate or generation.supply_status — tier may not allow another sandbox env", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Open a checkpoint as a new draft sandbox. Promote that draft to restore prod."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.rollback", "mutation_risk": "high", "related_tools": ["generation.checkpoint", "generation.promote", "generation.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Rollback", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "checkpoint_uuid must come from generation.checkpoint", "sandbox_limit_exceeded": "Promote, discard, or realign an open anchor before opening rollback draft", "sandbox_not_available": "generation.env_snapshot supply_scope=gate or generation.supply_status — tier may not allow another sandbox env", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Open a checkpoint as a new draft sandbox. Promote that draft to restore prod."}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "UF_F1 open checkpoint for restore promote", "request": {"params": {"checkpoint_uuid": "<checkpoint-uuid>", "project_id": 1}, "tool": "generation.rollback"}, "response": {"data": {"env_uuid": "<rollback-anchor>", "generation": 13, "rollback_uuid": "<rollback-anchor>"}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_CHECKPOINT_LADDER": "generation.checkpoint snapshots merged DNA. generation.rollback opens that checkpoint as a new draft sandbox. Restore prod only via generation.promote.", "GENERATION_ENV_OMIT": "Omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork."}, "instruction_hint": "Open a checkpoint as a new draft sandbox. Promote that draft to restore prod.", "mutation_kind": "none", "next_actions": ["generation.diff_vs_prod", "generation.promote"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"env_name": {"description": "string", "type": "string"}, "generation": {"description": "int", "type": "integer"}, "rollback_uuid": {"description": "string", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.checkpoint", "generation.promote", "generation.list"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "rollback": [], "safe_action": "generation_rollback", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Open a checkpoint as a new sandbox generation (draft). Promote the returned rollback_uuid via generation.promote to restore production DNA.", "title": "Generation Rollback", "verification": ["generation.status", "generation.diff_vs_prod"], "verify": [{"action": "generation.status", "predicate": "named resource is visible"}, {"action": "generation.diff_vs_prod", "predicate": "named resource is visible"}], "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "checkpoint_uuid must come from generation.checkpoint", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "sandbox_limit_exceeded": "Promote, discard, or realign an open anchor before opening rollback draft", "sandbox_not_available": "generation.env_snapshot supply_scope=gate or generation.supply_status — tier may not allow another sandbox env", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Open a checkpoint as a new draft sandbox. Promote that draft to restore prod.", "write_mode": null}, {"action": "generation.timeline", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.timeline", "related_tools": ["generation.status", "generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Timeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Generation operator or project membership required", "invalid_parameters": "project_id required — bind operator session before generation.timeline", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Retry generation.env_snapshot once, else generation.list — timeline read failed", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Promotion history for audits — pair with generation.status when canary is rolling_out."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.timeline", "related_tools": ["generation.status", "generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Timeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Generation operator or project membership required", "invalid_parameters": "project_id required — bind operator session before generation.timeline", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Retry generation.env_snapshot once, else generation.list — timeline read failed", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Promotion history for audits — pair with generation.status when canary is rolling_out."}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "domain": "generation", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Promotion history after UF_F1 cycle", "request": {"params": {"limit": 20, "project_id": 1}, "tool": "generation.timeline"}, "response": {"data": {"items": [], "project_id": 1}, "success": true}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_ENV_OMIT": "Omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork."}, "instruction_hint": "Promotion history for audits — pair with generation.status when canary is rolling_out.", "mutation_kind": "none", "next_actions": ["generation.status", "generation.diff_vs_prod"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"items": {"description": "list", "items": {"type": "object"}, "type": "array"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.status", "generation.diff_vs_prod"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_timeline", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Promotion history for a project: completed, active canary (rolling_out), failed, and aborted requests (newest first). Items include strategy, traffic_weight, calver_label when recorded.", "title": "Generation Timeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Generation operator or project membership required", "invalid_parameters": "project_id required — bind operator session before generation.timeline", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Retry generation.env_snapshot once, else generation.list — timeline read failed", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Promotion history for audits — pair with generation.status when canary is rolling_out.", "write_mode": null}, {"action": "goals.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "goals", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.goals.gen1"], "id": "goals.upsert", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Goals Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Set or update a monthly finance, projects, or hours target."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "goals", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.goals.gen1"], "id": "goals.upsert", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Goals Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Set or update a monthly finance, projects, or hours target."}, "domain": "goals", "domain_title": "Goals MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.goals.gen1"], "instruction_hint": "Set or update a monthly finance, projects, or hours target.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.goals", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"goal": {"additionalProperties": true, "description": "object", "type": "object"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.goals.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["goals.delete"], "safe_action": "goals_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Upsert a monthly goal (finance|projects|hours).", "title": "Goals Upsert", "verification": ["goals.list", "goals.progress"], "verify": [{"action": "goals.list", "predicate": "named resource is visible"}, {"action": "goals.progress", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Set or update a monthly finance, projects, or hours target.", "write_mode": null}, {"action": "goals.progress", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "goals", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.goals.gen1"], "id": "goals.progress", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Goals Progress", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Show goal attainment after goals.upsert or at month close."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "goals", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.goals.gen1"], "id": "goals.progress", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Goals Progress", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Show goal attainment after goals.upsert or at month close."}, "domain": "goals", "domain_title": "Goals MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.goals.gen1"], "instruction_hint": "Show goal attainment after goals.upsert or at month close.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.goals", "owner_gene": "core.mcp.goals.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "goals_progress", "semantic_input_mode": "inherit_workflow", "summary": "Compute goal progress from finance/CRM/time BFFs.", "title": "Goals Progress", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Show goal attainment after goals.upsert or at month close.", "write_mode": null}, {"action": "goals.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "goals", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.goals.gen1"], "id": "goals.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Goals List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enumerate stored goals before upsert or progress checks."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "goals", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.goals.gen1"], "id": "goals.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Goals List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enumerate stored goals before upsert or progress checks."}, "domain": "goals", "domain_title": "Goals MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.goals.gen1"], "instruction_hint": "Enumerate stored goals before upsert or progress checks.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.goals", "owner_gene": "core.mcp.goals.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "goals_list", "semantic_input_mode": "inherit_workflow", "summary": "List goals stored in data.goals[].", "title": "Goals List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enumerate stored goals before upsert or progress checks.", "write_mode": null}, {"action": "goals.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "goals", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.goals.gen1"], "id": "goals.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Goals Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove an obsolete goal by id from goals.list."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "goals", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.goals.gen1"], "id": "goals.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Goals Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove an obsolete goal by id from goals.list."}, "domain": "goals", "domain_title": "Goals MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.goals.gen1"], "instruction_hint": "Remove an obsolete goal by id from goals.list.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.goals", "owner_gene": "core.mcp.goals.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "goals_delete", "semantic_input_mode": "inherit_workflow", "summary": "Delete a goal by id from data.goals[].", "title": "Goals Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove an obsolete goal by id from goals.list.", "write_mode": null}, {"action": "grants.crm.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.list", "related_tools": ["grants.crm.transition", "grants.packet.build", "fundraising.packet.compose"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Prioritize which platform grant/bounty to work next."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.list", "related_tools": ["grants.crm.transition", "grants.packet.build", "fundraising.packet.compose"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Prioritize which platform grant/bounty to work next."}, "domain": "grants", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Prioritize which platform grant/bounty to work next.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.transition", "grants.packet.build", "fundraising.packet.compose"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_crm_list", "semantic_input_mode": "inherit_workflow", "summary": "List AgentStack platform Grant OS pipeline ranked by FitAndWinScorer (cash-first). Ecosystem owner only — not for tenant users.", "title": "Grants Crm List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Prioritize which platform grant/bounty to work next.", "write_mode": null}, {"action": "grants.crm.seed", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.seed", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Seed", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "First-time Grant OS setup or after registry changes."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.seed", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Seed", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "First-time Grant OS setup or after registry changes."}, "domain": "grants", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "First-time Grant OS setup or after registry changes.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_crm_seed", "semantic_input_mode": "inherit_workflow", "summary": "Seed Grant OS CRM rows from PROGRAM_REGISTRY.yaml (ecosystem owner).", "title": "Grants Crm Seed", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "First-time Grant OS setup or after registry changes.", "write_mode": null}, {"action": "grants.crm.transition", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.transition", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Transition", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark submitted / awarded / remediation after portal action."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.transition", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Transition", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark submitted / awarded / remediation after portal action."}, "domain": "grants", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Mark submitted / awarded / remediation after portal action.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_crm_transition", "semantic_input_mode": "inherit_workflow", "summary": "Transition a Grant OS application status (lifecycle FSM). Ecosystem owner.", "title": "Grants Crm Transition", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark submitted / awarded / remediation after portal action.", "write_mode": null}, {"action": "grants.packet.build", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.packet.build", "related_tools": ["fundraising.packet.compose", "grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Packet Build", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before platform grant submit — refresh packet evidence and CRM status."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.packet.build", "related_tools": ["fundraising.packet.compose", "grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Packet Build", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before platform grant submit — refresh packet evidence and CRM status."}, "domain": "grants", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Before platform grant submit — refresh packet evidence and CRM status.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["fundraising.packet.compose", "grants.crm.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_packet_build", "semantic_input_mode": "inherit_workflow", "summary": "Rebuild grant packets and sync CRM blockers from packet.json (ecosystem).", "title": "Grants Packet Build", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before platform grant submit — refresh packet evidence and CRM status.", "write_mode": null}, {"action": "grants.compose.checklist", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.compose.checklist", "related_tools": ["grants.packet.build", "fundraising.packet.compose"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Compose Checklist", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before uploading zip/attachments to a grant portal."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.compose.checklist", "related_tools": ["grants.packet.build", "fundraising.packet.compose"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Compose Checklist", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before uploading zip/attachments to a grant portal."}, "domain": "grants", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Before uploading zip/attachments to a grant portal.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.packet.build", "fundraising.packet.compose"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_compose_checklist", "semantic_input_mode": "inherit_workflow", "summary": "Attachment checklist for a platform grant portal submit.", "title": "Grants Compose Checklist", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before uploading zip/attachments to a grant portal.", "write_mode": null}, {"action": "grants.crm.sync", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.sync", "related_tools": ["grants.packet.build", "grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Sync", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After metrics/packet refresh — derive evidence_pending vs submit_ready."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.sync", "related_tools": ["grants.packet.build", "grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Sync", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After metrics/packet refresh — derive evidence_pending vs submit_ready."}, "domain": "grants", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "After metrics/packet refresh — derive evidence_pending vs submit_ready.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.packet.build", "grants.crm.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_crm_sync", "semantic_input_mode": "inherit_workflow", "summary": "Sync Grant OS CRM statuses from packet.json blockers (GW-CRM-001).", "title": "Grants Crm Sync", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After metrics/packet refresh — derive evidence_pending vs submit_ready.", "write_mode": null}, {"action": "grants.crm.overview", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.overview", "related_tools": ["grants.crm.list", "grants.crm.integrity"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Overview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dashboard snapshot of platform fundraising pipeline."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.overview", "related_tools": ["grants.crm.list", "grants.crm.integrity"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Overview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dashboard snapshot of platform fundraising pipeline."}, "domain": "grants", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Dashboard snapshot of platform fundraising pipeline.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list", "grants.crm.integrity"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_crm_overview", "semantic_input_mode": "inherit_workflow", "summary": "Grant OS CRM overview counts by status (ecosystem owner).", "title": "Grants Crm Overview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dashboard snapshot of platform fundraising pipeline.", "write_mode": null}, {"action": "grants.crm.integrity", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.integrity", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Integrity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before submit — fail if submit_ready has blockers or registry missing."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.integrity", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Integrity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before submit — fail if submit_ready has blockers or registry missing."}, "domain": "grants", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Before submit — fail if submit_ready has blockers or registry missing.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_crm_integrity", "semantic_input_mode": "inherit_workflow", "summary": "Assert Grant OS CRM integrity (GW-CRM-001 + docs mount).", "title": "Grants Crm Integrity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before submit — fail if submit_ready has blockers or registry missing.", "write_mode": null}, {"action": "grants.crm.hub_snapshot", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.hub_snapshot", "related_tools": ["grants.crm.list", "grants.crm.overview", "grants.reminders.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Hub Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Single read for Grant OS DevShell without four separate calls."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.hub_snapshot", "related_tools": ["grants.crm.list", "grants.crm.overview", "grants.reminders.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Hub Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Single read for Grant OS DevShell without four separate calls."}, "domain": "grants", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Single read for Grant OS DevShell without four separate calls.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list", "grants.crm.overview", "grants.reminders.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_crm_hub_snapshot", "semantic_input_mode": "inherit_workflow", "summary": "Grant OS hub snapshot — overview, pipeline, reminders, integrity (ecosystem owner). Mirrors GET /api/admin/grants/hub-snapshot.", "title": "Grants Crm Hub Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Single read for Grant OS DevShell without four separate calls.", "write_mode": null}, {"action": "grants.anchor.nsf_pitch", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.anchor.nsf_pitch", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Anchor Nsf Pitch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Non-crypto non-dilutive path for AgentStack platform — draft NSF pitch."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.anchor.nsf_pitch", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Anchor Nsf Pitch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Non-crypto non-dilutive path for AgentStack platform — draft NSF pitch."}, "domain": "grants", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Non-crypto non-dilutive path for AgentStack platform — draft NSF pitch.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_anchor_nsf_pitch", "semantic_input_mode": "inherit_workflow", "summary": "Render NSF SBIR-style Project Pitch from Grant OS anchor atoms.", "title": "Grants Anchor Nsf Pitch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Non-crypto non-dilutive path for AgentStack platform — draft NSF pitch.", "write_mode": null}, {"action": "grants.anchor.update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.anchor.update", "mutation_risk": "low", "related_tools": ["grants.anchor.nsf_pitch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Anchor Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Save anchor document before NSF pitch export."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.anchor.update", "mutation_risk": "low", "related_tools": ["grants.anchor.nsf_pitch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Anchor Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Save anchor document before NSF pitch export."}, "domain": "grants", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Save anchor document before NSF pitch export.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.anchor.nsf_pitch"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_anchor_update", "semantic_input_mode": "inherit_workflow", "summary": "Update Grant OS NSF anchor atoms (ecosystem owner).", "title": "Grants Anchor Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Save anchor document before NSF pitch export.", "write_mode": null}, {"action": "grants.w0.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.w0.get", "related_tools": ["grants.w0.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants W0 Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Track founder W0 evidence gates."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.w0.get", "related_tools": ["grants.w0.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants W0 Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Track founder W0 evidence gates."}, "domain": "grants", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Track founder W0 evidence gates.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.w0.patch"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_w0_get", "semantic_input_mode": "inherit_workflow", "summary": "Read W0 cash-gates checklist (ecosystem owner).", "title": "Grants W0 Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Track founder W0 evidence gates.", "write_mode": null}, {"action": "grants.w0.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.w0.patch", "mutation_risk": "low", "related_tools": ["grants.w0.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants W0 Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark W0 gate done after portal action."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.w0.patch", "mutation_risk": "low", "related_tools": ["grants.w0.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants W0 Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark W0 gate done after portal action."}, "domain": "grants", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Mark W0 gate done after portal action.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.w0.get"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_w0_patch", "semantic_input_mode": "inherit_workflow", "summary": "Patch W0 checklist item statuses.", "title": "Grants W0 Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark W0 gate done after portal action.", "write_mode": null}, {"action": "grants.reminders.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.reminders.list", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Reminders List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Friday follow-up cadence."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.reminders.list", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Reminders List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Friday follow-up cadence."}, "domain": "grants", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Friday follow-up cadence.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_reminders_list", "semantic_input_mode": "inherit_workflow", "summary": "Relationship follow-up reminders for Grant OS pipeline.", "title": "Grants Reminders List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Friday follow-up cadence.", "write_mode": null}, {"action": "grants.reports.monthly", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.reports.monthly", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Reports Monthly", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "End-of-month grant reporting."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.reports.monthly", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Reports Monthly", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "End-of-month grant reporting."}, "domain": "grants", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "End-of-month grant reporting.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_reports_monthly", "semantic_input_mode": "inherit_workflow", "summary": "Generate monthly post-award markdown/json report.", "title": "Grants Reports Monthly", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "End-of-month grant reporting.", "write_mode": null}, {"action": "grants.applications.detail", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.applications.detail", "related_tools": ["grants.crm.list", "grants.crm.transition"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Applications Detail", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect blockers and earning playbooks for one program."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.applications.detail", "related_tools": ["grants.crm.list", "grants.crm.transition"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Applications Detail", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect blockers and earning playbooks for one program."}, "domain": "grants", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Inspect blockers and earning playbooks for one program.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list", "grants.crm.transition"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_applications_detail", "semantic_input_mode": "inherit_workflow", "summary": "Grant OS application detail with score breakdown.", "title": "Grants Applications Detail", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect blockers and earning playbooks for one program.", "write_mode": null}, {"action": "grants.applications.milestone", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.applications.milestone", "related_tools": ["grants.applications.detail", "grants.crm.transition"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Applications Milestone", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark evidence milestones done before submit_ready transition."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.applications.milestone", "related_tools": ["grants.applications.detail", "grants.crm.transition"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Applications Milestone", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark evidence milestones done before submit_ready transition."}, "domain": "grants", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Mark evidence milestones done before submit_ready transition.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.applications.detail", "grants.crm.transition"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_applications_milestone", "semantic_input_mode": "inherit_workflow", "summary": "Toggle Grant OS application milestone completion (ecosystem owner).", "title": "Grants Applications Milestone", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark evidence milestones done before submit_ready transition.", "write_mode": null}, {"action": "grants.earning.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.earning.list", "related_tools": ["grants.earning.get", "grants.earning.upsert", "grants.applications.detail"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Earning List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Map grant submit to platform revenue levers."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.earning.list", "related_tools": ["grants.earning.get", "grants.earning.upsert", "grants.applications.detail"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Earning List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Map grant submit to platform revenue levers."}, "domain": "grants", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Map grant submit to platform revenue levers.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.earning.get", "grants.earning.upsert", "grants.applications.detail"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_earning_list", "semantic_input_mode": "inherit_workflow", "summary": "List AgentStack ecosystem earning playbooks for grant leverage.", "title": "Grants Earning List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Map grant submit to platform revenue levers.", "write_mode": null}, {"action": "grants.earning.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.earning.get", "related_tools": ["grants.earning.upsert", "grants.earning.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Earning Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read lane before patch."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.earning.get", "related_tools": ["grants.earning.upsert", "grants.earning.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Earning Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read lane before patch."}, "domain": "grants", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read lane before patch.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.earning.upsert", "grants.earning.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_earning_get", "semantic_input_mode": "inherit_workflow", "summary": "Get one earning playbook from EARNING_PLAYBOOKS.yaml.", "title": "Grants Earning Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read lane before patch.", "write_mode": null}, {"action": "grants.earning.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.earning.upsert", "mutation_risk": "low", "related_tools": ["grants.earning.list", "grants.catalog.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Earning Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add or tune AgentStack earning lane linked to grant_synergy program ids."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.earning.upsert", "mutation_risk": "low", "related_tools": ["grants.earning.list", "grants.catalog.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Earning Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add or tune AgentStack earning lane linked to grant_synergy program ids."}, "domain": "grants", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Add or tune AgentStack earning lane linked to grant_synergy program ids.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.earning.list", "grants.catalog.upsert"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_earning_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Merge earning playbook fields into EARNING_PLAYBOOKS.yaml (atomic backup). Agents use this to add/update revenue lanes without editing repo files.", "title": "Grants Earning Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add or tune AgentStack earning lane linked to grant_synergy program ids.", "write_mode": null}, {"action": "grants.earning.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.earning.delete", "mutation_risk": "high", "related_tools": ["grants.earning.list", "grants.earning.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Earning Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Retire a revenue lane (creates .bak backup)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.earning.delete", "mutation_risk": "high", "related_tools": ["grants.earning.list", "grants.earning.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Earning Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Retire a revenue lane (creates .bak backup)."}, "domain": "grants", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Retire a revenue lane (creates .bak backup).", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.earning.list", "grants.earning.upsert"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "grants_earning_delete", "semantic_input_mode": "inherit_workflow", "summary": "Remove an earning playbook row from EARNING_PLAYBOOKS.yaml.", "title": "Grants Earning Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Retire a revenue lane (creates .bak backup).", "write_mode": null}, {"action": "grants.bundle.download", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.bundle.download", "related_tools": ["grants.compose.checklist", "fundraising.packet.compose"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Bundle Download", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One-click bundle when compose checklist has no missing attachments."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.bundle.download", "related_tools": ["grants.compose.checklist", "fundraising.packet.compose"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Bundle Download", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One-click bundle when compose checklist has no missing attachments."}, "domain": "grants", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "One-click bundle when compose checklist has no missing attachments.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.compose.checklist", "fundraising.packet.compose"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_bundle_download", "semantic_input_mode": "inherit_workflow", "summary": "Build submission zip for a program (ecosystem owner). A zip that fits the compact envelope is content_base64. A longer zip omits that field and returns download=POST /api/admin/grants/bundle/{program_", "title": "Grants Bundle Download", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One-click bundle when compose checklist has no missing attachments.", "write_mode": null}, {"action": "grants.catalog.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.catalog.list", "related_tools": ["grants.catalog.get", "grants.opportunity.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Catalog List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover catalog before upsert or CRM seed."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.catalog.list", "related_tools": ["grants.catalog.get", "grants.opportunity.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Catalog List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover catalog before upsert or CRM seed."}, "domain": "grants", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Discover catalog before upsert or CRM seed.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.catalog.get", "grants.opportunity.upsert"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_catalog_list", "semantic_input_mode": "inherit_workflow", "summary": "List grant programs from PROGRAM_REGISTRY.yaml (ecosystem owner).", "title": "Grants Catalog List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover catalog before upsert or CRM seed.", "write_mode": null}, {"action": "grants.catalog.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.catalog.get", "related_tools": ["grants.catalog.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Catalog Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read catalog row before patch."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.catalog.get", "related_tools": ["grants.catalog.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Catalog Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read catalog row before patch."}, "domain": "grants", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read catalog row before patch.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.catalog.upsert"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_catalog_get", "semantic_input_mode": "inherit_workflow", "summary": "Get one program from PROGRAM_REGISTRY.yaml.", "title": "Grants Catalog Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read catalog row before patch.", "write_mode": null}, {"action": "grants.catalog.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.catalog.upsert", "mutation_risk": "low", "related_tools": ["grants.opportunity.upsert", "grants.crm.seed"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Catalog Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add or update a grant program in catalog without hand-editing YAML."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.catalog.upsert", "mutation_risk": "low", "related_tools": ["grants.opportunity.upsert", "grants.crm.seed"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Catalog Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add or update a grant program in catalog without hand-editing YAML."}, "domain": "grants", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Add or update a grant program in catalog without hand-editing YAML.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.opportunity.upsert", "grants.crm.seed"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_catalog_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Merge program fields into PROGRAM_REGISTRY.yaml (atomic backup).", "title": "Grants Catalog Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add or update a grant program in catalog without hand-editing YAML.", "write_mode": null}, {"action": "grants.applications.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.applications.patch", "mutation_risk": "low", "related_tools": ["grants.crm.transition", "grants.applications.detail"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Applications Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update grant row metadata without full transition."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.applications.patch", "mutation_risk": "low", "related_tools": ["grants.crm.transition", "grants.applications.detail"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Applications Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update grant row metadata without full transition."}, "domain": "grants", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Update grant row metadata without full transition.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.transition", "grants.applications.detail"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_applications_patch", "semantic_input_mode": "inherit_workflow", "summary": "Partial CRM application update (title, deadline, apply_url, notes, evidence URLs).", "title": "Grants Applications Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update grant row metadata without full transition.", "write_mode": null}, {"action": "grants.opportunity.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.opportunity.upsert", "mutation_risk": "low", "related_tools": ["grants.catalog.upsert", "grants.crm.sync"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Opportunity Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Agent discovers a new grant — one call to register + CRM."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.opportunity.upsert", "mutation_risk": "low", "related_tools": ["grants.catalog.upsert", "grants.crm.sync"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Opportunity Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Agent discovers a new grant — one call to register + CRM."}, "domain": "grants", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Agent discovers a new grant — one call to register + CRM.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.catalog.upsert", "grants.crm.sync"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_opportunity_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Upsert catalog program + seed CRM row (+ optional packet sync) in one step.", "title": "Grants Opportunity Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Agent discovers a new grant — one call to register + CRM.", "write_mode": null}, {"action": "storage.get_quota", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not use this for /s/ site files — that is hosting.project.status.", "anti_patterns": ["Do not use this for /s/ site files — that is hosting.project.status.", "scope=user is the member row inside the project, not a personal account outside it.", "quota_mode=both enforces the member cap and the project pool; -1 means unlimited."], "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.get_quota", "related_tools": ["storage.get_project_usage_summary", "projects.get_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Get Quota", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project read or owner/admin for scope=project", "insufficient_permissions": "project membership with storage:read cap", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Check quota before storage.upload."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.get_quota", "related_tools": ["storage.get_project_usage_summary", "projects.get_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Get Quota", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project read or owner/admin for scope=project", "insufficient_permissions": "project membership with storage:read cap", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Check quota before storage.upload."}, "do_not_use_when": "Checking hosting archive or snapshot room — use hosting.project.status.", "domain": "storage", "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Check quota before storage.upload.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.get_project_usage_summary", "projects.get_project"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_get_quota", "semantic_input_mode": "inherit_workflow", "summary": "Returns storage quota for the current user or project slice: used/limit bytes, tier_basis (project_owner vs fallback), owner_user_id. Pass project_id or rely on API key / session project. scope=user (", "title": "Storage Get Quota", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project read or owner/admin for scope=project", "insufficient_permissions": "project membership with storage:read cap", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Checking hosting archive or snapshot room — use hosting.project.status.", "when_to_use": "Check quota before storage.upload.", "write_mode": null}, {"action": "storage.get_project_usage_summary", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.get_project_usage_summary", "related_tools": ["storage.get_quota"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Get Project Usage Summary", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project owner or admin for aggregate usage", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dashboards and agents that need project-wide storage consumption."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.get_project_usage_summary", "related_tools": ["storage.get_quota"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Get Project Usage Summary", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project owner or admin for aggregate usage", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dashboards and agents that need project-wide storage consumption."}, "domain": "storage", "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Dashboards and agents that need project-wide storage consumption.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.get_quota"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_get_project_usage_summary", "semantic_input_mode": "inherit_workflow", "summary": "Owner/admin: total permanent/temp bytes across all members and project slice, plus project_pool_limit_bytes from the project billing tier.", "title": "Storage Get Project Usage Summary", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project owner or admin for aggregate usage", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dashboards and agents that need project-wide storage consumption.", "write_mode": null}, {"action": "storage.get_hub_summary", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.get_hub_summary", "related_tools": ["storage.get_project_usage_summary"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Get Hub Summary", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "ecosystem admin for hub rollup", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Storage hub overview dashboards and agents."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.get_hub_summary", "related_tools": ["storage.get_project_usage_summary"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Get Hub Summary", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "ecosystem admin for hub rollup", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Storage hub overview dashboards and agents."}, "domain": "storage", "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Storage hub overview dashboards and agents.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.get_project_usage_summary"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_get_hub_summary", "semantic_input_mode": "inherit_workflow", "summary": "Hub v4 aggregate: permanent/temp totals, hosting bytes, pool cap, sites count.", "title": "Storage Get Hub Summary", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "ecosystem admin for hub rollup", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Storage hub overview dashboards and agents.", "write_mode": null}, {"action": "storage.upload", "aliases": ["storage.put", "storage.put_file", "storage.upload_file", "storage.write"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "This action does not upload bytes. POST /api/storage/upload with the multipart contract.", "anti_patterns": ["This action does not upload bytes. POST /api/storage/upload with the multipart contract.", "Do not put site HTML here. Use hosting.deploy_files or hosting.files.put.", "Check storage.get_quota before a large file."], "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.upload", "related_tools": ["storage.get_quota", "storage.list_files", "storage.delete_file"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Upload", "when_blocked": {"batch_semantic_anchor_required": "Should not fire after plain_read effect — if seen, use options.execution_intent=direct or discovery.describe storage.upload effect.execution_class", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "file_too_large": "reduce size or use hosting.files.put for /s/ site bytes", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "quota_exceeded": "REST 413 — storage.get_quota first; verify file, project_id, scope", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_quota": "storage.get_quota — delete via storage.delete_file or upgrade tier", "upload_failed": "read REST detail (413 vs 400); confirm multipart fields", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before attaching binaries — agents upload via REST, not MCP body."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.upload", "related_tools": ["storage.get_quota", "storage.list_files", "storage.delete_file"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Upload", "when_blocked": {"batch_semantic_anchor_required": "Should not fire after plain_read effect — if seen, use options.execution_intent=direct or discovery.describe storage.upload effect.execution_class", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "file_too_large": "reduce size or use hosting.files.put for /s/ site bytes", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "quota_exceeded": "REST 413 — storage.get_quota first; verify file, project_id, scope", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_quota": "storage.get_quota — delete via storage.delete_file or upgrade tier", "upload_failed": "read REST detail (413 vs 400); confirm multipart fields", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before attaching binaries — agents upload via REST, not MCP body."}, "do_not_use_when": "Editing a file already served from the site bucket on /s/.", "domain": "storage", "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "conditional_mutate": "MCP returns POST /api/storage/upload multipart contract only — no bytes on execute", "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Before attaching binaries — agents upload via REST, not MCP body.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Quota/list/delete via storage.* MCP; bytes via POST /api/storage/upload — never invent an MCP upload body. Full RBAC × storage matrix: deferred fixture.", "related_tools": ["storage.get_quota", "storage.list_files", "storage.delete_file"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_upload", "semantic_input_mode": "inherit_workflow", "summary": "Binary upload uses REST POST /api/storage/upload (multipart/form-data). This MCP action returns the contract + quota gate — call storage.get_quota first.", "title": "Storage Upload", "when_blocked": {"batch_semantic_anchor_required": "Should not fire after plain_read effect — if seen, use options.execution_intent=direct or discovery.describe storage.upload effect.execution_class", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "file_too_large": "reduce size or use hosting.files.put for /s/ site bytes", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "quota_exceeded": "REST 413 — storage.get_quota first; verify file, project_id, scope", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_quota": "storage.get_quota — delete via storage.delete_file or upgrade tier", "upload_failed": "read REST detail (413 vs 400); confirm multipart fields", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Editing a file already served from the site bucket on /s/.", "when_to_use": "Before attaching binaries — agents upload via REST, not MCP body.", "workflow_ladder": ["storage.get_quota project_id + scope=user (or scope=project for the shared row)", "Read quota_mode and project_pool_limit_bytes — both means member cap and project pool", "POST /api/storage/upload multipart: file, folder, project_id, scope", "Bots staff/broadcast/bus outbound: folder bots__outbound → attachments[] on bots.staff_reply, bots.bus.reply, bots.bus.send, or bots.bus.deliver. Do not paste the file body into text", "Agent run input: folder fleet__runs__inbound → attachments[] on agents.run", "Run output artifacts: fleet__runs__outbound or agents.graph_file_put (not MCP upload metadata alone)", "storage.list_files folder=_ to confirm the card id", "After agents.graph_file_put: storage.list_files with folder_key + file_id from storage_roundtrip_hint"], "write_mode": null}, {"action": "storage.list_files", "aliases": ["storage.files.list", "storage.folders.list", "storage.get", "storage.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "folder=_ is the root. Omit folder only when you need every folder.", "anti_patterns": ["folder=_ is the root. Omit folder only when you need every folder.", "Site tree listing is hosting.bucket.files.list, not storage.list_files.", "Graph artifacts: use storage_roundtrip_hint.folder from agents.graph_file_put, not folder=_ alone.", "No storage.preview_text — SPA FileTextPreviewPane reads the public /uploaded_files path; agents read linked graph files via agents.graph_file_get."], "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.list_files", "related_tools": ["storage.get_quota", "storage.delete_file"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage List Files", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project membership with storage:read cap", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List attachments in project storage scope."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.list_files", "related_tools": ["storage.get_quota", "storage.delete_file"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage List Files", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project membership with storage:read cap", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List attachments in project storage scope."}, "do_not_use_when": "Listing pages of a hosted site — use hosting.bucket.files.list.", "domain": "storage", "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "List attachments in project storage scope.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.get_quota", "storage.delete_file"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_list_files", "semantic_input_mode": "inherit_workflow", "summary": "Lists files in an ecosystem storage folder for the current user or project slice. Pass folder key (use '_' for root) or omit to list all folders (heavy). Set include_folders=1 to return folder_index f", "title": "Storage List Files", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project membership with storage:read cap", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Listing pages of a hosted site — use hosting.bucket.files.list.", "when_to_use": "List attachments in project storage scope.", "write_mode": null}, {"action": "storage.delete_file", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Deleting a storage card does not remove a hosted /s/ file.", "anti_patterns": ["Deleting a storage card does not remove a hosted /s/ file."], "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.delete_file", "mutation_risk": "high", "related_tools": ["storage.list_files", "storage.get_quota"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Delete File", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project write or storage:delete cap", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "storage.list_files folder=_ — confirm card id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_quota": "delete does not free project pool until reconcile completes", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove blob — irreversible."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.delete_file", "mutation_risk": "high", "related_tools": ["storage.list_files", "storage.get_quota"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Delete File", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project write or storage:delete cap", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "storage.list_files folder=_ — confirm card id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_quota": "delete does not free project pool until reconcile completes", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove blob — irreversible."}, "domain": "storage", "domain_title": "Storage MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Remove blob — irreversible.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_tools": ["storage.list_files", "storage.get_quota"], "required_cap": "storage.write", "requires_preflight": true, "risk_class": "destructive", "safe_action": "storage_delete_file", "semantic_input_mode": "inherit_workflow", "summary": "Deletes a file from ecosystem storage (JSON registry + blob). Requires write access for user scope; owner/admin for project scope.", "title": "Storage Delete File", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project write or storage:delete cap", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "storage.list_files folder=_ — confirm card id", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_quota": "delete does not free project pool until reconcile completes", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove blob — irreversible.", "write_mode": null}, {"action": "storage.scan", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.scan", "related_tools": ["storage.reconcile", "storage.list_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Scan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project admin or owner for project scope", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_scan_failed": "retry or narrow folder scope", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Diagnose empty storage UI or disk↔DNA drift before reconcile."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.scan", "related_tools": ["storage.reconcile", "storage.list_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Scan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project admin or owner for project scope", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_scan_failed": "retry or narrow folder scope", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Diagnose empty storage UI or disk↔DNA drift before reconcile."}, "domain": "storage", "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Diagnose empty storage UI or disk↔DNA drift before reconcile.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.reconcile", "storage.list_files"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_scan", "semantic_input_mode": "inherit_workflow", "summary": "Project RBAC: compare on-disk files with 8DNA storage registry for the resolved row. scope=user (default) scans caller member row; scope=project scans project slice (user_id=0). Prefer over storage.ad", "title": "Storage Scan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project admin or owner for project scope", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_scan_failed": "retry or narrow folder scope", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Diagnose empty storage UI or disk↔DNA drift before reconcile.", "write_mode": null}, {"action": "storage.reconcile", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.reconcile", "mutates_when": {"dry_run": false}, "related_tools": ["storage.scan"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project admin or owner for project scope", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_reconcile_failed": "check trace_id and storage admin_scan", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After storage.scan shows orphans or ghosts."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.reconcile", "mutates_when": {"dry_run": false}, "related_tools": ["storage.scan"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project admin or owner for project scope", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_reconcile_failed": "check trace_id and storage admin_scan", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After storage.scan shows orphans or ghosts."}, "domain": "storage", "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true evaluates; dry_run=false deletes orphans", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "After storage.scan shows orphans or ghosts.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"actions": {"additionalProperties": true, "description": "object", "type": "object"}, "ok": {"description": "bool", "type": "boolean"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_tools": ["storage.scan"], "required_cap": "storage.read", "requires_preflight": true, "risk_class": "destructive", "rollback": [], "safe_action": "storage_reconcile", "semantic_input_mode": "inherit_workflow", "summary": "Project RBAC: fix disk↔8DNA drift for the resolved row (dry_run default true). scope=user requires write; scope=project requires owner/admin. Prefer over storage.admin_reconcile for tenants.", "title": "Storage Reconcile", "verification": ["storage.scan"], "verify": [{"action": "storage.scan", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project admin or owner for project scope", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_reconcile_failed": "check trace_id and storage admin_scan", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After storage.scan shows orphans or ghosts.", "write_mode": null}, {"action": "storage.admin_scan", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.admin_scan", "related_tools": ["storage.scan", "storage.reconcile", "storage.list_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Admin Scan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_scan_failed": "ops trace — compare on-disk vs 8DNA index", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cross-tenant operator hub only; tenants use storage.scan."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.admin_scan", "related_tools": ["storage.scan", "storage.reconcile", "storage.list_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Admin Scan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_scan_failed": "ops trace — compare on-disk vs 8DNA index", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cross-tenant operator hub only; tenants use storage.scan."}, "domain": "storage", "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Cross-tenant operator hub only; tenants use storage.scan.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.scan", "storage.reconcile", "storage.list_files"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_admin_scan", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem admin (platform hub): compare on-disk files with 8DNA storage registry for (project_id, dna_user_id). Tenants: use storage.scan.", "title": "Storage Admin Scan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_scan_failed": "ops trace — compare on-disk vs 8DNA index", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cross-tenant operator hub only; tenants use storage.scan.", "write_mode": null}, {"action": "storage.admin_reconcile", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.admin_reconcile", "related_tools": ["storage.reconcile", "storage.scan"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Admin Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_reconcile_failed": "dry_run first; see admin_scan", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cross-tenant operator hub only; tenants use storage.reconcile."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.admin_reconcile", "related_tools": ["storage.reconcile", "storage.scan"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Admin Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_reconcile_failed": "dry_run first; see admin_scan", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cross-tenant operator hub only; tenants use storage.reconcile."}, "domain": "storage", "domain_title": "Storage MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Cross-tenant operator hub only; tenants use storage.reconcile.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.reconcile", "storage.scan"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "storage_admin_reconcile", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem admin (platform hub): fix disk↔8DNA drift for any row. Tenants: use storage.reconcile with scope.", "title": "Storage Admin Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_reconcile_failed": "dry_run first; see admin_scan", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cross-tenant operator hub only; tenants use storage.reconcile.", "write_mode": null}, {"action": "storage.admin_list_rows", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.admin_list_rows", "related_tools": ["storage.admin_scan", "storage.list_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Admin List Rows", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pick a storage row before admin scan/reconcile or file ops."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.admin_list_rows", "related_tools": ["storage.admin_scan", "storage.list_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Admin List Rows", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pick a storage row before admin scan/reconcile or file ops."}, "domain": "storage", "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Pick a storage row before admin scan/reconcile or file ops.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.admin_scan", "storage.list_files"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_admin_list_rows", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem admin: list 8DNA rows with data.ecosystem.storage (project_id, dna_user_id, file counts, bytes).", "title": "Storage Admin List Rows", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pick a storage row before admin scan/reconcile or file ops.", "write_mode": null}, {"action": "storage.bind_entity", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.bind_entity", "related_tools": ["agents.graph_file_put", "agents.graph_file_list", "storage.list_files", "storage.list_by_entity"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Bind Entity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "entity_type and entity_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "storage.list_files — confirm file id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Link an uploaded file to a CRM deal, contact, or other entity."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.bind_entity", "related_tools": ["agents.graph_file_put", "agents.graph_file_list", "storage.list_files", "storage.list_by_entity"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Bind Entity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "entity_type and entity_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "storage.list_files — confirm file id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Link an uploaded file to a CRM deal, contact, or other entity."}, "domain": "storage", "domain_title": "Storage MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Link an uploaded file to a CRM deal, contact, or other entity.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["agents.graph_file_put", "agents.graph_file_list", "storage.list_files", "storage.list_by_entity"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "storage_bind_entity", "semantic_input_mode": "inherit_workflow", "summary": "Attach entity_ref to a storage file card.", "title": "Storage Bind Entity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "entity_type and entity_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "storage.list_files — confirm file id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Link an uploaded file to a CRM deal, contact, or other entity.", "write_mode": null}, {"action": "storage.list_by_entity", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.list_by_entity", "related_tools": ["agents.graph_file_list", "agents.graph_file_get", "storage.list_files", "storage.bind_entity"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage List By Entity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "entity_type and entity_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "entity has no bound files", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List attachments for a deal or contact after storage.bind_entity."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.list_by_entity", "related_tools": ["agents.graph_file_list", "agents.graph_file_get", "storage.list_files", "storage.bind_entity"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage List By Entity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "entity_type and entity_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "entity has no bound files", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List attachments for a deal or contact after storage.bind_entity."}, "domain": "storage", "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "List attachments for a deal or contact after storage.bind_entity.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["agents.graph_file_list", "agents.graph_file_get", "storage.list_files", "storage.bind_entity"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_list_by_entity", "semantic_input_mode": "inherit_workflow", "summary": "List files bound to an entity_ref.", "title": "Storage List By Entity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "entity_type and entity_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "entity has no bound files", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List attachments for a deal or contact after storage.bind_entity.", "write_mode": null}, {"action": "storage.import_from_url", "aliases": ["storage.import_url", "storage.upload_from_url"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not use for /s/ HTML assets — use hosting.bucket.file.import_url.", "anti_patterns": ["HTTPS-only; SSRF blocked (no localhost/private IPs). Max 10 MiB.", "Bots attachments: prefer storage.import_from_url or REST upload, then file_id in bots.bus.deliver.", "Hosted /s/ bytes: hosting.bucket.file.import_url — not storage."], "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.import_from_url", "mutation_risk": "low", "related_tools": ["storage.get_quota", "storage.list_files", "hosting.site.import_archive"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Import From Url", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Server-side HTTPS fetch into ecosystem storage (SSRF-safe, project write cap). Site trees and ZIP dist: hosting.site.import_archive or hosting.bucket.file.import_url. Max 10 MiB per call — same order"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.import_from_url", "mutation_risk": "low", "related_tools": ["storage.get_quota", "storage.list_files", "hosting.site.import_archive"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Import From Url", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Server-side HTTPS fetch into ecosystem storage (SSRF-safe, project write cap). Site trees and ZIP dist: hosting.site.import_archive or hosting.bucket.file.import_url. Max 10 MiB per call — same order"}, "domain": "storage", "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Server-side HTTPS fetch into ecosystem storage (SSRF-safe, project write cap). Site trees and ZIP d…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.get_quota", "storage.list_files", "hosting.site.import_archive"], "required_cap": "storage.write", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_import_from_url", "semantic_input_mode": "inherit_workflow", "summary": "Server-side HTTPS fetch into ecosystem storage (SSRF-safe, project write cap). Site trees and ZIP dist: hosting.site.import_archive or hosting.bucket.file.import_url. Max 10 MiB per call — same order ", "title": "Storage Import From Url", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Server-side HTTPS fetch into ecosystem storage (SSRF-safe, project write cap). Site trees and ZIP dist: hosting.site.import_archive or hosting.bucket.file.import_url. Max 10 MiB per call — same order", "write_mode": null}, {"action": "guidance.list_capability_tasks", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.list_capability_tasks", "related_tools": ["discovery.get_platform_surfaces"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance List Capability Tasks", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Discover taskId, domain, and comfortBudget for platform micro-tasks."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.list_capability_tasks", "related_tools": ["discovery.get_platform_surfaces"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance List Capability Tasks", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Discover taskId, domain, and comfortBudget for platform micro-tasks."}, "domain": "guidance", "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Discover taskId, domain, and comfortBudget for platform micro-tasks.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["discovery.get_platform_surfaces"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_list_capability_tasks", "semantic_input_mode": "inherit_workflow", "summary": "List Platform Task Capability (PTC) atoms from shared/fixtures/capability_tasks_v1.json. Use before Compass playbooks with kind=capability or agentstack.execute task hints.", "title": "Guidance List Capability Tasks", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Discover taskId, domain, and comfortBudget for platform micro-tasks.", "write_mode": null}, {"action": "guidance.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.list", "related_tools": ["guidance.match_playbook", "guidance.start_path", "guidance.list_capability_tasks"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance List", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Browse playbooks before start_path."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.list", "related_tools": ["guidance.match_playbook", "guidance.start_path", "guidance.list_capability_tasks"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance List", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Browse playbooks before start_path."}, "domain": "guidance", "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Browse playbooks before start_path.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.match_playbook", "guidance.start_path", "guidance.list_capability_tasks"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_list", "semantic_input_mode": "inherit_workflow", "summary": "List platform Compass playbook definitions plus tenant path overlays for a project. Mirror of REST GET /api/projects/{id}/guidance/definitions.", "title": "Guidance List", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Browse playbooks before start_path.", "write_mode": null}, {"action": "guidance.recommend_skills", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.recommend_skills", "related_tools": ["guidance.preview_instructions", "guidance.match_playbook", "discovery.search"], "semantic_input_mode": "per_step_nl", "source": "overlay", "title": "Guidance Recommend Skills", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Required params text (goal) and project_id — pass text=<user goal> plus context.project_id.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id before guidance.recommend_skills.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Outcome-oriented ecosystem skill cards for a goal text."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.recommend_skills", "related_tools": ["guidance.preview_instructions", "guidance.match_playbook", "discovery.search"], "semantic_input_mode": "per_step_nl", "source": "overlay", "title": "Guidance Recommend Skills", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Required params text (goal) and project_id — pass text=<user goal> plus context.project_id.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id before guidance.recommend_skills.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Outcome-oriented ecosystem skill cards for a goal text."}, "domain": "guidance", "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "effect_kind": "read", "examples": [{"name": "Unified skill pick", "request": {"params": {"project_id": 1, "text": "ship CRM rollout"}, "tool": "guidance.recommend_skills"}, "response": {"data": {"intent_id": "crm.pipeline.update", "skills": [{"id": "coding.kiss"}], "skills_reason": "unified"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Outcome-oriented ecosystem skill cards for a goal text.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.preview_instructions", "guidance.match_playbook", "discovery.search"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_recommend_skills", "semantic_input_mode": "per_step_nl", "summary": "Outcome-oriented skill pack for a goal (no LLM, no extra tools).", "title": "Guidance Recommend Skills", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Required params text (goal) and project_id — pass text=<user goal> plus context.project_id.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id before guidance.recommend_skills.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Outcome-oriented ecosystem skill cards for a goal text.", "write_mode": null}, {"action": "guidance.preview_instructions", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.preview_instructions", "related_tools": ["guidance.recommend_skills", "discovery.search", "discovery.describe"], "semantic_input_mode": "per_step_nl", "source": "overlay", "title": "Guidance Preview Instructions", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Pass text=<user goal>; optional project_id for unified skill hydration.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_recommended": "Skills stay empty without project_id — pass context.project_id for parity with work_next.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "route_empty": "discovery.search or rephrase goal — no intent_id and no semantic_contract.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Developer preview — read-only route + instruction_packet for a goal; bind project_id for skill cards."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.preview_instructions", "related_tools": ["guidance.recommend_skills", "discovery.search", "discovery.describe"], "semantic_input_mode": "per_step_nl", "source": "overlay", "title": "Guidance Preview Instructions", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Pass text=<user goal>; optional project_id for unified skill hydration.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_recommended": "Skills stay empty without project_id — pass context.project_id for parity with work_next.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "route_empty": "discovery.search or rephrase goal — no intent_id and no semantic_contract.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Developer preview — read-only route + instruction_packet for a goal; bind project_id for skill cards."}, "domain": "guidance", "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "effect_kind": "read", "examples": [{"name": "Read-only analytics goal", "request": {"params": {"project_id": 1, "text": "Show weekly signups in a dashboard without changing data."}, "tool": "guidance.preview_instructions"}, "response": {"data": {"instruction_packet": {}, "skills_reason": "unified"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Developer preview — read-only route + instruction_packet for a goal; bind project_id for skill card…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.recommend_skills", "discovery.search", "discovery.describe"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_preview_instructions", "semantic_input_mode": "per_step_nl", "summary": "Read-only: route goal → playbook, quality, instruction packet, allowed actions (no LLM).", "title": "Guidance Preview Instructions", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Pass text=<user goal>; optional project_id for unified skill hydration.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_recommended": "Skills stay empty without project_id — pass context.project_id for parity with work_next.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "route_empty": "discovery.search or rephrase goal — no intent_id and no semantic_contract.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Developer preview — read-only route + instruction_packet for a goal; bind project_id for skill cards.", "write_mode": null}, {"action": "guidance.match_playbook", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.match_playbook", "related_tools": ["guidance.path_status", "guidance.start_session"], "semantic_input_mode": "per_step_nl", "source": "overlay", "title": "Guidance Match Playbook", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "NL goal → playbook id + verifyKinds before start_path; skip when work_next already returned next_action."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.match_playbook", "related_tools": ["guidance.path_status", "guidance.start_session"], "semantic_input_mode": "per_step_nl", "source": "overlay", "title": "Guidance Match Playbook", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "NL goal → playbook id + verifyKinds before start_path; skip when work_next already returned next_action."}, "do_not_use_when": "Do not match a playbook when agents.work_next already returned next_action.", "domain": "guidance", "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "effect_kind": "read", "examples": [{"name": "Playbook match with fingerprint echo", "request": {"params": {"goal_text": "telegram shop bot", "semantic_contract": {"fingerprint": "example-fp-playbook", "primary_intent": "commerce.storefront"}}, "tool": "guidance.match_playbook"}, "response": {"data": {"playbook_id": "commerce.telegram_storefront", "semantic_contract": {"fingerprint": "example-fp-playbook"}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "NL goal → playbook id + verifyKinds before start_path; skip when work_next already returned next_ac…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Copy the playbook id into mcp_guidance_start.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.path_status", "guidance.start_session"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_match_playbook", "semantic_input_mode": "per_step_nl", "summary": "Match natural-language goal text to a Platform Compass playbook id using bundled intent patterns + RU/EN synonyms. Returns verifyKinds for bot/commerce paths.", "title": "Guidance Match Playbook", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_not_to_use": "Do not match a playbook when agents.work_next already returned next_action.", "when_to_use": "NL goal → playbook id + verifyKinds before start_path; skip when work_next already returned next_action.", "write_mode": null}, {"action": "guidance.path_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.platform.compass.gen1"], "id": "guidance.path_status", "related_tools": ["guidance.match_playbook", "bots.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Path Status", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Poll funnel progress — not discovery.list for step state."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.platform.compass.gen1"], "id": "guidance.path_status", "related_tools": ["guidance.match_playbook", "bots.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Path Status", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Poll funnel progress — not discovery.list for step state."}, "do_not_use_when": "Not a tool catalog — discovery.search lists actions; this polls verify gates.", "domain": "guidance", "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Poll funnel progress — not discovery.list for step state.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.match_playbook", "bots.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_path_status", "semantic_input_mode": "inherit_workflow", "summary": "Snapshot Compass verify gates for a project: botExists, botLive, botChannelAttached, hostedVitrinePublished. Use after playbook steps or before go-live checks.", "title": "Guidance Path Status", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_not_to_use": "Not a tool catalog — discovery.search lists actions; this polls verify gates.", "when_to_use": "Poll funnel progress — not discovery.list for step state.", "write_mode": null}, {"action": "guidance.funnel_stats", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.funnel_stats", "related_tools": ["guidance.path_status", "guidance.start_session"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Funnel Stats", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Ops/agent checks cross-user bot Compass funnel without OpTrace ring scan."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.funnel_stats", "related_tools": ["guidance.path_status", "guidance.start_session"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Funnel Stats", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Ops/agent checks cross-user bot Compass funnel without OpTrace ring scan."}, "domain": "guidance", "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Ops/agent checks cross-user bot Compass funnel without OpTrace ring scan.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.path_status", "guidance.start_session"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_funnel_stats", "semantic_input_mode": "inherit_workflow", "summary": "O(1) in-process Compass funnel counters for messaging-channel-bot: path_started, per-task completions, channel mix, dual_channel_attach. No database scan.", "title": "Guidance Funnel Stats", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Ops/agent checks cross-user bot Compass funnel without OpTrace ring scan.", "write_mode": null}, {"action": "guidance.start_session", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.start_session", "related_tools": ["guidance.match_playbook", "guidance.path_status", "guidance.record_step"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Start Session", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "External agent starts a guided bot/commerce path for a user."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.start_session", "related_tools": ["guidance.match_playbook", "guidance.path_status", "guidance.record_step"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Start Session", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "External agent starts a guided bot/commerce path for a user."}, "domain": "guidance", "domain_title": "Guidance MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "External agent starts a guided bot/commerce path for a user.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.match_playbook", "guidance.path_status", "guidance.record_step"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "guidance_start_session", "semantic_input_mode": "inherit_workflow", "summary": "Start a Platform Compass guidance session on the server (8DNA data.guidance). Use with messaging-channel-bot for cross-device resume.", "title": "Guidance Start Session", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "External agent starts a guided bot/commerce path for a user.", "write_mode": null}, {"action": "guidance.start_path", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.platform.compass.gen1"], "id": "guidance.start_path", "related_tools": ["guidance.start_session", "guidance.complete_step", "guidance.path_status"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Guidance Start Path", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Begin a Compass playbook — path_status before complete_step."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.platform.compass.gen1"], "id": "guidance.start_path", "related_tools": ["guidance.start_session", "guidance.complete_step", "guidance.path_status"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Guidance Start Path", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Begin a Compass playbook — path_status before complete_step."}, "do_not_use_when": "Raw agentstack.execute for one-off reads — resolve schema via discovery.list (optional domain=) then discovery.describe(params.action); discovery.search only in a separate execute when NL lookup is needed (avoid goal-anchored batch conflicts).", "domain": "guidance", "domain_title": "Guidance MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Begin a Compass playbook — path_status before complete_step.", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["guidance.path_status"], "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"playbookId": {"description": "Playbook id started", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "projectId": {"description": "Project id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "sessionId": {"description": "Guidance session id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "state": {"description": "Playbook state v2 blob", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.start_session", "guidance.complete_step", "guidance.path_status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "guidance_start_path", "semantic_input_mode": "inherit_workflow", "summary": "Alias for guidance.start_session — start a Platform Compass guided path on the server. Prefer this name in agent playbooks; identical parameters and response.", "title": "Guidance Start Path", "verification": ["guidance.path_status", "guidance.get_session"], "verify": [{"action": "guidance.path_status", "predicate": "named resource is visible"}, {"action": "guidance.get_session", "predicate": "named resource is visible"}], "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_not_to_use": "Raw agentstack.execute for one-off reads — resolve schema via discovery.list (optional domain=) then discovery.describe(params.action); discovery.search only in a separate execute when NL lookup is needed (avoid goal-anchored batch conflicts).", "when_to_use": "Begin a Compass playbook — path_status before complete_step.", "write_mode": null}, {"action": "guidance.record_step", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.record_step", "related_tools": ["guidance.start_session", "guidance.get_session", "guidance.path_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Record Step", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Record path progress after an agent completes a playbook step."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.record_step", "related_tools": ["guidance.start_session", "guidance.get_session", "guidance.path_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Record Step", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Record path progress after an agent completes a playbook step."}, "domain": "guidance", "domain_title": "Guidance MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Record path progress after an agent completes a playbook step.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.start_session", "guidance.get_session", "guidance.path_status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "guidance_record_step", "semantic_input_mode": "inherit_workflow", "summary": "Patch an active guidance session state (answers, currentNodeId, completedNodeIds, percent). Agent parity with SPA pathServerSync step PATCH.", "title": "Guidance Record Step", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Record path progress after an agent completes a playbook step.", "write_mode": null}, {"action": "guidance.list_active_sessions", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.list_active_sessions", "related_tools": ["guidance.get_session", "guidance.start_session"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance List Active Sessions", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Resume or inspect in-progress Compass paths from an agent."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.list_active_sessions", "related_tools": ["guidance.get_session", "guidance.start_session"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance List Active Sessions", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Resume or inspect in-progress Compass paths from an agent."}, "domain": "guidance", "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Resume or inspect in-progress Compass paths from an agent.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.get_session", "guidance.start_session"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_list_active_sessions", "semantic_input_mode": "inherit_workflow", "summary": "List active guidance sessions for the authenticated user in a project.", "title": "Guidance List Active Sessions", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Resume or inspect in-progress Compass paths from an agent.", "write_mode": null}, {"action": "guidance.list_active_paths", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.list_active_paths", "related_tools": ["guidance.list_active_sessions", "guidance.start_path", "guidance.complete_step"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance List Active Paths", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "List in-progress guided paths before choosing resume or complete_step."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.list_active_paths", "related_tools": ["guidance.list_active_sessions", "guidance.start_path", "guidance.complete_step"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance List Active Paths", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "List in-progress guided paths before choosing resume or complete_step."}, "domain": "guidance", "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "List in-progress guided paths before choosing resume or complete_step.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.list_active_sessions", "guidance.start_path", "guidance.complete_step"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_list_active_paths", "semantic_input_mode": "inherit_workflow", "summary": "Alias for guidance.list_active_sessions — active Compass paths with percent and state. Use for agent resume decisions.", "title": "Guidance List Active Paths", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "List in-progress guided paths before choosing resume or complete_step.", "write_mode": null}, {"action": "guidance.get_session", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.get_session", "related_tools": ["guidance.list_active_sessions", "guidance.record_step"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Get Session", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Hydrate path state before completing or verifying steps."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.get_session", "related_tools": ["guidance.list_active_sessions", "guidance.record_step"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Get Session", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Hydrate path state before completing or verifying steps."}, "domain": "guidance", "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Hydrate path state before completing or verifying steps.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.list_active_sessions", "guidance.record_step"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_get_session", "semantic_input_mode": "inherit_workflow", "summary": "Get one guidance session by id for the authenticated user.", "title": "Guidance Get Session", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Hydrate path state before completing or verifying steps.", "write_mode": null}, {"action": "guidance.complete_step", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.platform.compass.gen1"], "id": "guidance.complete_step", "related_tools": ["guidance.path_status", "guidance.record_step"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Complete Step", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "After verify kind passes — idempotent step completion."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.platform.compass.gen1"], "id": "guidance.complete_step", "related_tools": ["guidance.path_status", "guidance.record_step"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Complete Step", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "After verify kind passes — idempotent step completion."}, "domain": "guidance", "domain_title": "Guidance MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "After verify kind passes — idempotent step completion.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.path_status", "guidance.record_step"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "guidance_complete_step", "semantic_input_mode": "inherit_workflow", "summary": "Mark a guidance step complete with optional artifact after server verify gates. Agent parity with SPA completePathStep.", "title": "Guidance Complete Step", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "After verify kind passes — idempotent step completion.", "write_mode": null}, {"action": "integrations.list_recipes", "aliases": ["discovery.list_recipes"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.list_recipes", "related_tools": ["integrations.connector_schema", "integrations.install_recipe", "integrations.list_connections"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Recipes", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "Filter params must be valid strings when provided", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "First step for any SaaS/API connect — filter provider/category/q, then integrations.connector_schema and integrations.install_recipe."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.list_recipes", "related_tools": ["integrations.connector_schema", "integrations.install_recipe", "integrations.list_connections"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Recipes", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "Filter params must be valid strings when provided", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "First step for any SaaS/API connect — filter provider/category/q, then integrations.connector_schema and integrations.install_recipe."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "First step for any SaaS/API connect — filter provider/category/q, then integrations.connector_schem…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.connector_schema", "integrations.install_recipe", "integrations.list_connections"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_recipes", "semantic_input_mode": "inherit_workflow", "summary": "List integration recipe templates (Stripe, GitHub, Telegram, etc.).", "title": "List Integration Recipes", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "Filter params must be valid strings when provided", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "First step for any SaaS/API connect — filter provider/category/q, then integrations.connector_schema and integrations.install_recipe.", "write_mode": null}, {"action": "integrations.recipe_taxonomies", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.recipe_taxonomies", "related_tools": ["integrations.connector_schema", "integrations.install_recipe", "integrations.list_connections"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Recipe Taxonomies", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Facet lists for integration recipes (provider, category, tags). Use before integrations.list_recipes to build filters — same payload as GET /api/integrations/recipes/taxonomies."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.recipe_taxonomies", "related_tools": ["integrations.connector_schema", "integrations.install_recipe", "integrations.list_connections"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Recipe Taxonomies", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Facet lists for integration recipes (provider, category, tags). Use before integrations.list_recipes to build filters — same payload as GET /api/integrations/recipes/taxonomies."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Facet lists for integration recipes (provider, category, tags). Use before integrations.list_recipe…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.connector_schema", "integrations.install_recipe", "integrations.list_connections"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_recipe_taxonomies", "semantic_input_mode": "inherit_workflow", "summary": "Facet lists for integration recipes (provider, category, tags). Use before integrations.list_recipes to build filters — same payload as GET /api/integrations/recipes/taxonomies.", "title": "Integrations Recipe Taxonomies", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Facet lists for integration recipes (provider, category, tags). Use before integrations.list_recipes to build filters — same payload as GET /api/integrations/recipes/taxonomies.", "write_mode": null}, {"action": "integrations.install_recipe", "aliases": ["webhooks.create_endpoint", "webhooks.register"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not store signing_secret or API tokens in projects.patch_data — use secrets= on install.", "Do not call webhooks.register — use Integration Hub recipes/connections.", "Retry with the same idempotency_key only when params unchanged; else use a new key."], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.install_recipe", "mutation_risk": "low", "related_tools": ["integrations.list_recipes", "integrations.connector_schema", "integrations.list_connections", "integrations.test_hook", "logic.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Integrations Install Recipe", "when_blocked": {"connection_not_found": "integrations.list_connections — reinstall or create_connection", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "duplicate_request": "same idempotency_key only when params unchanged — else new key", "forbidden": "Permission denied — integrations:write or project_admin", "insufficient_permissions": "integrations:write cap + project_admin on tenant PID", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "recipe_not_found": "integrations.list_recipes (provider/q) → connector_schema before install", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Install inbound/outbound recipe — replaces legacy webhooks.register. Secrets in secrets= only — never projects.patch_data."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.install_recipe", "mutation_risk": "low", "related_tools": ["integrations.list_recipes", "integrations.connector_schema", "integrations.list_connections", "integrations.test_hook", "logic.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Integrations Install Recipe", "when_blocked": {"connection_not_found": "integrations.list_connections — reinstall or create_connection", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "duplicate_request": "same idempotency_key only when params unchanged — else new key", "forbidden": "Permission denied — integrations:write or project_admin", "insufficient_permissions": "integrations:write cap + project_admin on tenant PID", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "recipe_not_found": "integrations.list_recipes (provider/q) → connector_schema before install", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Install inbound/outbound recipe — replaces legacy webhooks.register. Secrets in secrets= only — never projects.patch_data."}, "do_not_use_when": "A catalog recipe is missing — integrations.list_recipes first. Preview imports do not install.", "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Install inbound/outbound recipe — replaces legacy webhooks.register. Secrets in secrets= only — nev…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"connection_id": {"description": "New connection UUID", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "hook_url": {"description": "Inbound webhook URL when applicable", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "logic_id": {"description": "Bound logic rule id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "owner_kind": {"description": "project | personal", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Scoped project id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "Install finished", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_recipes", "integrations.connector_schema", "integrations.list_connections", "integrations.test_hook", "logic.create"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["generation.realign_to_prod"], "safe_action": "integrations_install_recipe", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Install a recipe: creates connection + declarative logic rule.", "title": "Integrations Install Recipe", "verification": ["integrations.list_connections", "integrations.connection_health"], "verify": [{"action": "integrations.list_connections", "predicate": "named resource is visible"}, {"action": "integrations.connection_health", "predicate": "named resource is visible"}], "when_blocked": {"connection_not_found": "integrations.list_connections — reinstall or create_connection", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "duplicate_request": "same idempotency_key only when params unchanged — else new key", "forbidden": "Permission denied — integrations:write or project_admin", "insufficient_permissions": "integrations:write cap + project_admin on tenant PID", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "recipe_not_found": "integrations.list_recipes (provider/q) → connector_schema before install", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "A catalog recipe is missing — integrations.list_recipes first. Preview imports do not install.", "when_to_use": "Install inbound/outbound recipe — replaces legacy webhooks.register. Secrets in secrets= only — never projects.patch_data.", "write_mode": null}, {"action": "integrations.list_connections", "aliases": ["webhooks.get", "webhooks.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.list_connections", "related_tools": ["integrations.get_connection", "integrations.connection_health", "integrations.oauth_begin"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Integrations List Connections", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "rbac.check_permission on tenant project — integrations:read or project membership", "invalid_parameters": "Tenant connectors: bind context.project_id to a workspace PID (> ecosystem). Ecosystem project_id=1: pass owner_kind=personal + user_id for operator-linked hooks (inbound /api/hooks/ecosystem/users/{user_id}/...). auth.get_profile or projects.get_projects — not OAuth default PID 1 for tenant app hooks.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List connectors for a tenant project_id — not ecosystem PID 1. Bind context.project_id via auth.get_profile or projects.get_projects."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.list_connections", "related_tools": ["integrations.get_connection", "integrations.connection_health", "integrations.oauth_begin"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Integrations List Connections", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "rbac.check_permission on tenant project — integrations:read or project membership", "invalid_parameters": "Tenant connectors: bind context.project_id to a workspace PID (> ecosystem). Ecosystem project_id=1: pass owner_kind=personal + user_id for operator-linked hooks (inbound /api/hooks/ecosystem/users/{user_id}/...). auth.get_profile or projects.get_projects — not OAuth default PID 1 for tenant app hooks.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List connectors for a tenant project_id — not ecosystem PID 1. Bind context.project_id via auth.get_profile or projects.get_projects."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List connectors for a tenant project_id — not ecosystem PID 1. Bind context.project_id via auth.get…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"connections": {"description": "Connection cards", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "total": {"description": "Total matching filter", "type": "integer"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.get_connection", "integrations.connection_health", "integrations.oauth_begin"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_connections", "semantic_input_mode": "inherit_workflow", "summary": "List integration connections for project or personal scope. Each row is id plus spec.provider, spec.label, and spec.status. webhook_activation, routing, and logic_id are null here. The nested card_row", "title": "Integrations List Connections", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "rbac.check_permission on tenant project — integrations:read or project membership", "invalid_parameters": "Tenant connectors: bind context.project_id to a workspace PID (> ecosystem). Ecosystem project_id=1: pass owner_kind=personal + user_id for operator-linked hooks (inbound /api/hooks/ecosystem/users/{user_id}/...). auth.get_profile or projects.get_projects — not OAuth default PID 1 for tenant app hooks.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List connectors for a tenant project_id — not ecosystem PID 1. Bind context.project_id via auth.get_profile or projects.get_projects.", "write_mode": null}, {"action": "integrations.get_connection", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_connection", "related_tools": ["integrations.list_connections", "integrations.delete_connection"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get Connection", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load connector config after integrations.list_connections."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_connection", "related_tools": ["integrations.list_connections", "integrations.delete_connection"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get Connection", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load connector config after integrations.list_connections."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Load connector config after integrations.list_connections.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_connections", "integrations.delete_connection"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_get_connection", "semantic_input_mode": "inherit_workflow", "summary": "Get integration connection metadata (secrets redacted).", "title": "Integrations Get Connection", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load connector config after integrations.list_connections.", "write_mode": null}, {"action": "integrations.delete_connection", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.delete_connection", "mutation_risk": "high", "related_tools": ["integrations.get_connection", "integrations.list_connections"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Delete Connection", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "insufficient_permissions": "project_admin + integrations:write", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rollback after certification or remove stale connectors."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.delete_connection", "mutation_risk": "high", "related_tools": ["integrations.get_connection", "integrations.list_connections"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Delete Connection", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "insufficient_permissions": "project_admin + integrations:write", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rollback after certification or remove stale connectors."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Rollback after certification or remove stale connectors.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.get_connection", "integrations.list_connections"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "integrations_delete_connection", "semantic_input_mode": "inherit_workflow", "summary": "Delete an integration connection and unregister webhook bindings.", "title": "Integrations Delete Connection", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "insufficient_permissions": "project_admin + integrations:write", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rollback after certification or remove stale connectors.", "write_mode": null}, {"action": "integrations.create_connection", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Prefer install_recipe when a catalog recipe exists — less schema drift.", "Inbound/bidirectional requires signing material unless allow_unsigned_dev_only (dev only)."], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.create_connection", "mutation_risk": "low", "related_tools": ["integrations.install_recipe", "integrations.list_connections", "integrations.connector_schema"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Create Connection", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "duplicate_request": "list_connections — reuse connection_id or new idempotency_key", "forbidden": "Permission denied — integrations:write or project_admin", "insufficient_permissions": "integrations:write + signing material for inbound", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_not_found": "list_recipes or list_apps — use catalog provider id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Low-level connector birth when no recipe covers the provider. Prefer integrations.install_recipe when a catalog recipe exists. Recipe mcp_tenant_business_assistant_v1 uses Telegram token + bots.attach"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.create_connection", "mutation_risk": "low", "related_tools": ["integrations.install_recipe", "integrations.list_connections", "integrations.connector_schema"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Create Connection", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "duplicate_request": "list_connections — reuse connection_id or new idempotency_key", "forbidden": "Permission denied — integrations:write or project_admin", "insufficient_permissions": "integrations:write + signing material for inbound", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_not_found": "list_recipes or list_apps — use catalog provider id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Low-level connector birth when no recipe covers the provider. Prefer integrations.install_recipe when a catalog recipe exists. Recipe mcp_tenant_business_assistant_v1 uses Telegram token + bots.attach"}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Low-level connector birth when no recipe covers the provider. Prefer integrations.install_recipe wh…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"connection": {"description": "Connection spec envelope after mutation", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "True when write succeeded", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.install_recipe", "integrations.list_connections", "integrations.connector_schema"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["integrations.delete_connection"], "safe_action": "integrations_create_connection", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create an integration connection (REST POST /api/integrations/connections parity). Prefer integrations.install_recipe for packaged inbound webhooks.", "title": "Integrations Create Connection", "verification": ["integrations.list_connections"], "verify": [{"action": "integrations.list_connections", "predicate": "named resource is visible"}], "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "duplicate_request": "list_connections — reuse connection_id or new idempotency_key", "forbidden": "Permission denied — integrations:write or project_admin", "insufficient_permissions": "integrations:write + signing material for inbound", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_not_found": "list_recipes or list_apps — use catalog provider id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Low-level connector birth when no recipe covers the provider. Prefer integrations.install_recipe when a catalog recipe exists. Recipe mcp_tenant_business_assistant_v1 uses Telegram token + bots.attach", "write_mode": null}, {"action": "integrations.test_hook", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not treat success=false as transport failure — read error_code (hook_verify_failed, hook_no_rule_match).", "Include provider signature headers in headers= when testing Stripe/Svix connectors."], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.test_hook", "related_tools": ["integrations.install_recipe", "integrations.connector_schema", "integrations.list_connections", "logic.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Integrations Test Hook", "when_blocked": {"connection_not_found": "integrations.list_connections — install_recipe first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "hook_no_rule_match": "logic.dry_run on installed rule_id — fix FieldMap transforms", "hook_verify_failed": "connector_schema for headers; Telegram needs X-Telegram-Bot-Api-Secret-Token matching connection webhook_secret — after deploy run integrations.activate_webhook or platform_telegram_doctor (401 detail.code webhook_secret_missing | webhook_signature_mismatch)", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_not_found": "list_recipes / list_apps — exact provider id from catalog row", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run provider signature + payload mapping before go-live — read error_code, not only success=false (hook_verify_failed, hook_no_rule_match)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.test_hook", "related_tools": ["integrations.install_recipe", "integrations.connector_schema", "integrations.list_connections", "logic.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Integrations Test Hook", "when_blocked": {"connection_not_found": "integrations.list_connections — install_recipe first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "hook_no_rule_match": "logic.dry_run on installed rule_id — fix FieldMap transforms", "hook_verify_failed": "connector_schema for headers; Telegram needs X-Telegram-Bot-Api-Secret-Token matching connection webhook_secret — after deploy run integrations.activate_webhook or platform_telegram_doctor (401 detail.code webhook_secret_missing | webhook_signature_mismatch)", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_not_found": "list_recipes / list_apps — exact provider id from catalog row", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run provider signature + payload mapping before go-live — read error_code, not only success=false (hook_verify_failed, hook_no_rule_match)."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "effect_depends_on_params": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Dry-run provider signature + payload mapping before go-live — read error_code, not only success=fal…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"duplicate": {"description": "Idempotent duplicate delivery", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "matched": {"description": "Matched rule count", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "Hook test finished", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.install_recipe", "integrations.connector_schema", "integrations.list_connections", "logic.dry_run"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_test_hook", "semantic_input_mode": "inherit_workflow", "summary": "Dry-run inbound hook verify + normalize (sync dispatch to logic).", "title": "Integrations Test Hook", "when_blocked": {"connection_not_found": "integrations.list_connections — install_recipe first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "hook_no_rule_match": "logic.dry_run on installed rule_id — fix FieldMap transforms", "hook_verify_failed": "connector_schema for headers; Telegram needs X-Telegram-Bot-Api-Secret-Token matching connection webhook_secret — after deploy run integrations.activate_webhook or platform_telegram_doctor (401 detail.code webhook_secret_missing | webhook_signature_mismatch)", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_not_found": "list_recipes / list_apps — exact provider id from catalog row", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run provider signature + payload mapping before go-live — read error_code, not only success=false (hook_verify_failed, hook_no_rule_match).", "write_mode": null}, {"action": "integrations.export_connection", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.export_connection", "related_tools": ["integrations.list_connections", "integrations.get_connection", "integrations.import_connection"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Export Connection", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "mcp_read on tenant project or ecosystem operator scope", "invalid_parameters": "connection_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Backup or audit one connector — public spec + config; signing_secret redacted. Pair with integrations.import_connection on target project (secrets= optional)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.export_connection", "related_tools": ["integrations.list_connections", "integrations.get_connection", "integrations.import_connection"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Export Connection", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "mcp_read on tenant project or ecosystem operator scope", "invalid_parameters": "connection_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Backup or audit one connector — public spec + config; signing_secret redacted. Pair with integrations.import_connection on target project (secrets= optional)."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Backup or audit one connector — public spec + config; signing_secret redacted. Pair with integratio…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_connections", "integrations.get_connection", "integrations.import_connection"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_export_connection", "semantic_input_mode": "inherit_workflow", "summary": "Export connection public spec + config (secrets redacted).", "title": "Integrations Export Connection", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "mcp_read on tenant project or ecosystem operator scope", "invalid_parameters": "connection_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Backup or audit one connector — public spec + config; signing_secret redacted. Pair with integrations.import_connection on target project (secrets= optional).", "write_mode": null}, {"action": "integrations.import_connection", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.import_connection", "mutation_risk": "low", "related_tools": ["integrations.export_connection", "integrations.list_connections", "integrations.install_recipe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import Connection", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project_admin on target project_id", "invalid_parameters": "project_id and connection object required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Restore connector from export_connection JSON — project_admin; use secrets= when rotating into a new workspace without re-OAuth."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.import_connection", "mutation_risk": "low", "related_tools": ["integrations.export_connection", "integrations.list_connections", "integrations.install_recipe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import Connection", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project_admin on target project_id", "invalid_parameters": "project_id and connection object required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Restore connector from export_connection JSON — project_admin; use secrets= when rotating into a new workspace without re-OAuth."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Restore connector from export_connection JSON — project_admin; use secrets= when rotating into a ne…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.export_connection", "integrations.list_connections", "integrations.install_recipe"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_import_connection", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Import connection from export JSON (optionally with secrets).", "title": "Integrations Import Connection", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project_admin on target project_id", "invalid_parameters": "project_id and connection object required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Restore connector from export_connection JSON — project_admin; use secrets= when rotating into a new workspace without re-OAuth.", "write_mode": null}, {"action": "integrations.rotate_secret", "aliases": ["webhooks.rotate_secret"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.rotate_secret", "mutation_risk": "low", "related_tools": ["integrations.get_connection", "integrations.list_connections", "integrations.test_hook"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Integrations Rotate Secret", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "insufficient_permissions": "project_admin — protected secret rotation", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rotate signing secret atomically for a connection."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.rotate_secret", "mutation_risk": "low", "related_tools": ["integrations.get_connection", "integrations.list_connections", "integrations.test_hook"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Integrations Rotate Secret", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "insufficient_permissions": "project_admin — protected secret rotation", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rotate signing secret atomically for a connection."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Rotate signing secret atomically for a connection.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "Mutation succeeded", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.get_connection", "integrations.list_connections", "integrations.test_hook"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "integrations_rotate_secret", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Rotate a protected secret key for a connection.", "title": "Integrations Rotate Secret", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "insufficient_permissions": "project_admin — protected secret rotation", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rotate signing secret atomically for a connection.", "write_mode": null}, {"action": "integrations.replay_delivery", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.replay_delivery", "related_tools": ["integrations.list_issues", "integrations.list_connections"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Integrations Replay Delivery", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "delivery_not_found": "integrations.list_issues — copy delivery_id from failed row", "forbidden": "mcp_read on tenant project", "invalid_parameters": "project_id and delivery_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_target_url": "integrations.list_issues — row lacks target_url; fix connection", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Re-send one failed outbound delivery by delivery_id after integrations.list_issues."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.replay_delivery", "related_tools": ["integrations.list_issues", "integrations.list_connections"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Integrations Replay Delivery", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "delivery_not_found": "integrations.list_issues — copy delivery_id from failed row", "forbidden": "mcp_read on tenant project", "invalid_parameters": "project_id and delivery_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_target_url": "integrations.list_issues — row lacks target_url; fix connection", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Re-send one failed outbound delivery by delivery_id after integrations.list_issues."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Re-send one failed outbound delivery by delivery_id after integrations.list_issues.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"replay_lineage": {"description": "parent_log_id and idempotency_key when present", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "result": {"description": "Delivery outcome — status_code, error, delivery_id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "Replay accepted", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_issues", "integrations.list_connections"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_replay_delivery", "semantic_input_mode": "inherit_workflow", "summary": "Replay outbound delivery by durable delivery_id (execution log).", "title": "Integrations Replay Delivery", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "delivery_not_found": "integrations.list_issues — copy delivery_id from failed row", "forbidden": "mcp_read on tenant project", "invalid_parameters": "project_id and delivery_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_target_url": "integrations.list_issues — row lacks target_url; fix connection", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Re-send one failed outbound delivery by delivery_id after integrations.list_issues.", "write_mode": null}, {"action": "integrations.replay_delivery_url", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.replay_delivery_url", "related_tools": ["integrations.list_issues", "integrations.test_hook"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Replay Delivery Url", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "mcp_read on tenant project", "invalid_parameters": "project_id and target_url required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Debug one outbound target_url (ops) — same as REST deliveries/replay; not batch replay."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.replay_delivery_url", "related_tools": ["integrations.list_issues", "integrations.test_hook"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Replay Delivery Url", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "mcp_read on tenant project", "invalid_parameters": "project_id and target_url required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Debug one outbound target_url (ops) — same as REST deliveries/replay; not batch replay."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Debug one outbound target_url (ops) — same as REST deliveries/replay; not batch replay.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_issues", "integrations.test_hook"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_replay_delivery_url", "semantic_input_mode": "inherit_workflow", "summary": "Replay outbound POST to an explicit target_url (same as REST deliveries/replay query).", "title": "Integrations Replay Delivery Url", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "mcp_read on tenant project", "invalid_parameters": "project_id and target_url required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Debug one outbound target_url (ops) — same as REST deliveries/replay; not batch replay.", "write_mode": null}, {"action": "integrations.connection_health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.connection_health", "related_tools": ["integrations.list_connections", "integrations.get_connection", "integrations.test_hook"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Connection Health", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "needs_auth": "integrations.oauth_begin then refresh_token — reconnect OAuth", "oauth_credentials_missing": "BYO secrets missing — Quick Setup client_id/secret then install", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "x_credits_depleted": "Top up X API credits / check developer console", "x_rate_limited": "Backoff; honor Retry-After; retry with same idempotency_key"}, "when_to_use": "After install_recipe — verify connector snapshot before test_hook go-live."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.connection_health", "related_tools": ["integrations.list_connections", "integrations.get_connection", "integrations.test_hook"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Connection Health", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "needs_auth": "integrations.oauth_begin then refresh_token — reconnect OAuth", "oauth_credentials_missing": "BYO secrets missing — Quick Setup client_id/secret then install", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "x_credits_depleted": "Top up X API credits / check developer console", "x_rate_limited": "Backoff; honor Retry-After; retry with same idempotency_key"}, "when_to_use": "After install_recipe — verify connector snapshot before test_hook go-live."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "After install_recipe — verify connector snapshot before test_hook go-live.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_connections", "integrations.get_connection", "integrations.test_hook"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_connection_health", "semantic_input_mode": "inherit_workflow", "summary": "Read connection health snapshot (public spec only).", "title": "Integrations Connection Health", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "needs_auth": "integrations.oauth_begin then refresh_token — reconnect OAuth", "oauth_credentials_missing": "BYO secrets missing — Quick Setup client_id/secret then install", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "x_credits_depleted": "Top up X API credits / check developer console", "x_rate_limited": "Backoff; honor Retry-After; retry with same idempotency_key"}, "when_to_use": "After install_recipe — verify connector snapshot before test_hook go-live.", "write_mode": null}, {"action": "integrations.connector_schema", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.connector_schema", "related_tools": ["integrations.list_recipes", "integrations.install_recipe", "integrations.create_connection"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Connector Schema", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "provider string required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_not_found": "integrations.list_recipes — exact provider id from catalog row", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Provider setup schema before install_recipe or create_connection — copy secrets= keys from setup_steps."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.connector_schema", "related_tools": ["integrations.list_recipes", "integrations.install_recipe", "integrations.create_connection"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Connector Schema", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "provider string required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_not_found": "integrations.list_recipes — exact provider id from catalog row", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Provider setup schema before install_recipe or create_connection — copy secrets= keys from setup_steps."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Provider setup schema before install_recipe or create_connection — copy secrets= keys from setup_st…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_recipes", "integrations.install_recipe", "integrations.create_connection"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_connector_schema", "semantic_input_mode": "inherit_workflow", "summary": "Provider setup schema (required secrets, setup_steps, quick_setup) — call before install_recipe or create_connection so agents know which secrets= keys to pass.", "title": "Read Connector Schema", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "provider string required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_not_found": "integrations.list_recipes — exact provider id from catalog row", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Provider setup schema before install_recipe or create_connection — copy secrets= keys from setup_steps.", "write_mode": null}, {"action": "integrations.process_inbox_batch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.process_inbox_batch", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Process Inbox Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Process durable inbound integration inbox (worker-style batch)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.process_inbox_batch", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Process Inbox Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Process durable inbound integration inbox (worker-style batch)."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Process durable inbound integration inbox (worker-style batch).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_process_inbox_batch", "semantic_input_mode": "inherit_workflow", "summary": "Process durable inbound integration inbox (worker-style batch).", "title": "Integrations Process Inbox Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Process durable inbound integration inbox (worker-style batch).", "write_mode": null}, {"action": "integrations.process_outbound_batch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.process_outbound_batch", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Process Outbound Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Process outbound webhook delivery work queue (webhooks.outbound batch)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.process_outbound_batch", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Process Outbound Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Process outbound webhook delivery work queue (webhooks.outbound batch)."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Process outbound webhook delivery work queue (webhooks.outbound batch).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_process_outbound_batch", "semantic_input_mode": "inherit_workflow", "summary": "Process outbound webhook delivery work queue (webhooks.outbound batch).", "title": "Integrations Process Outbound Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Process outbound webhook delivery work queue (webhooks.outbound batch).", "write_mode": null}, {"action": "integrations.process_polling_batch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.process_polling_batch", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Process Polling Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Worker sweep for due poll connectors — ops diagnose, not connect ladder step 1."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.process_polling_batch", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Process Polling Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Worker sweep for due poll connectors — ops diagnose, not connect ladder step 1."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Worker sweep for due poll connectors — ops diagnose, not connect ladder step 1.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_process_polling_batch", "semantic_input_mode": "inherit_workflow", "summary": "Poll due integration connections (config.poll_enabled, cursor watermark).", "title": "Integrations Process Polling Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Worker sweep for due poll connectors — ops diagnose, not connect ladder step 1.", "write_mode": null}, {"action": "integrations.hydrate_triggers", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": true, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.hydrate_triggers", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Hydrate Triggers", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rebuild trigger registry from connection DNA before rebind_triggers when rules are missing."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": true, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.hydrate_triggers", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Hydrate Triggers", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rebuild trigger registry from connection DNA before rebind_triggers when rules are missing."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": true, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Rebuild trigger registry from connection DNA before rebind_triggers when rules are missing.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_hydrate_triggers", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Hydrate integration trigger registry from connection DNA (cold start recovery).", "title": "Integrations Hydrate Triggers", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rebuild trigger registry from connection DNA before rebind_triggers when rules are missing.", "write_mode": null}, {"action": "integrations.rebind_triggers", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": true, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.rebind_triggers", "related_tools": ["integrations.hydrate_triggers", "integrations.list_connections", "logic.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Rebind Triggers", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id must be a positive int when provided", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Re-sync enabled logic rule triggers for a project or all connection projects."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": true, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.rebind_triggers", "related_tools": ["integrations.hydrate_triggers", "integrations.list_connections", "logic.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Rebind Triggers", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id must be a positive int when provided", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Re-sync enabled logic rule triggers for a project or all connection projects."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": true, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Re-sync enabled logic rule triggers for a project or all connection projects.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.hydrate_triggers", "integrations.list_connections", "logic.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_rebind_triggers", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Re-sync enabled logic rule triggers for a project or all connection projects.", "title": "Integrations Rebind Triggers", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id must be a positive int when provided", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Re-sync enabled logic rule triggers for a project or all connection projects.", "write_mode": null}, {"action": "integrations.list_inbox_events", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.list_inbox_events", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Inbox Events", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit inbound intake after test_hook — inspect queued rows before integrations.replay_inbox."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.list_inbox_events", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Inbox Events", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit inbound intake after test_hook — inspect queued rows before integrations.replay_inbox."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Audit inbound intake after test_hook — inspect queued rows before integrations.replay_inbox.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_inbox_events", "semantic_input_mode": "inherit_workflow", "summary": "List durable integration inbox audit rows for a project.", "title": "Integrations List Inbox Events", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit inbound intake after test_hook — inspect queued rows before integrations.replay_inbox.", "write_mode": null}, {"action": "integrations.replay_inbox", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.replay_inbox", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Replay Inbox", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Re-drive one inbox audit row when the provider delivered but logic did not run."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.replay_inbox", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Replay Inbox", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Re-drive one inbox audit row when the provider delivered but logic did not run."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Re-drive one inbox audit row when the provider delivered but logic did not run.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_replay_inbox", "semantic_input_mode": "inherit_workflow", "summary": "Replay a durable inbox event through the test-hook intake path.", "title": "Integrations Replay Inbox", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Re-drive one inbox audit row when the provider delivered but logic did not run.", "write_mode": null}, {"action": "integrations.export_scenario", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.export_scenario", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Export Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export portable scenario bundle (rule document + field maps, secrets redacted)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.export_scenario", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Export Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export portable scenario bundle (rule document + field maps, secrets redacted)."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Export portable scenario bundle (rule document + field maps, secrets redacted).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_export_scenario", "semantic_input_mode": "inherit_workflow", "summary": "Export portable scenario bundle (rule document + field maps, secrets redacted).", "title": "Integrations Export Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export portable scenario bundle (rule document + field maps, secrets redacted).", "write_mode": null}, {"action": "integrations.preview_scenario_maps", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.preview_scenario_maps", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Preview Scenario Maps", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Evaluate scenario field maps against a sample payload (secrets redacted)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.preview_scenario_maps", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Preview Scenario Maps", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Evaluate scenario field maps against a sample payload (secrets redacted)."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Evaluate scenario field maps against a sample payload (secrets redacted).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_preview_scenario_maps", "semantic_input_mode": "inherit_workflow", "summary": "Evaluate scenario field maps against a sample payload (secrets redacted).", "title": "Integrations Preview Scenario Maps", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Evaluate scenario field maps against a sample payload (secrets redacted).", "write_mode": null}, {"action": "integrations.generate_signing_secret", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.generate_signing_secret", "mutation_risk": "low", "related_tools": ["integrations.list_connections", "integrations.rotate_secret", "integrations.test_hook"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Generate Signing Secret", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project_admin on connection project", "invalid_parameters": "connection_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rotate webhook signing_secret server-side when old value is unknown — prefer over integrations.rotate_secret when key name is signing_secret."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.generate_signing_secret", "mutation_risk": "low", "related_tools": ["integrations.list_connections", "integrations.rotate_secret", "integrations.test_hook"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Generate Signing Secret", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project_admin on connection project", "invalid_parameters": "connection_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rotate webhook signing_secret server-side when old value is unknown — prefer over integrations.rotate_secret when key name is signing_secret."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Rotate webhook signing_secret server-side when old value is unknown — prefer over integrations.rota…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_connections", "integrations.rotate_secret", "integrations.test_hook"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_generate_signing_secret", "semantic_input_mode": "inherit_workflow", "summary": "Rotate signing_secret server-side without reading the old value.", "title": "Integrations Generate Signing Secret", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project_admin on connection project", "invalid_parameters": "connection_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rotate webhook signing_secret server-side when old value is unknown — prefer over integrations.rotate_secret when key name is signing_secret.", "write_mode": null}, {"action": "integrations.export_connection_manifest", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.export_connection_manifest", "related_tools": ["integrations.list_connections", "integrations.export_connection"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Export Connection Manifest", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "mcp_read on tenant project", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compact manifest for agent tool loops — ids/providers only; use export_connection for full spec per connector."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.export_connection_manifest", "related_tools": ["integrations.list_connections", "integrations.export_connection"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Export Connection Manifest", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "mcp_read on tenant project", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compact manifest for agent tool loops — ids/providers only; use export_connection for full spec per connector."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Compact manifest for agent tool loops — ids/providers only; use export_connection for full spec per…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_connections", "integrations.export_connection"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_export_connection_manifest", "semantic_input_mode": "inherit_workflow", "summary": "Export project integration connections as JSON manifest for agent tool loops.", "title": "Integrations Export Connection Manifest", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "mcp_read on tenant project", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compact manifest for agent tool loops — ids/providers only; use export_connection for full spec per connector.", "write_mode": null}, {"action": "integrations.import_zapier_preview", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.import_zapier_preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import Zapier Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run preview: map Zapier export JSON to recipe + logic block draft."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.import_zapier_preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import Zapier Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run preview: map Zapier export JSON to recipe + logic block draft."}, "do_not_use_when": "Applying the import. Preview does not install or run.", "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "read_only_hint": true, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Dry-run preview: map Zapier export JSON to recipe + logic block draft.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_import_zapier_preview", "semantic_input_mode": "inherit_workflow", "summary": "Dry-run preview: map Zapier export JSON to recipe + logic block draft.", "title": "Integrations Import Zapier Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Applying the import. Preview does not install or run.", "when_to_use": "Dry-run preview: map Zapier export JSON to recipe + logic block draft.", "write_mode": null}, {"action": "integrations.import_zapier_commit", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.import_zapier_commit", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import Zapier Commit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Commit Zapier export JSON → installed connection + logic (not dry-run)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.import_zapier_commit", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import Zapier Commit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Commit Zapier export JSON → installed connection + logic (not dry-run)."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Commit Zapier export JSON → installed connection + logic (not dry-run).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "integrations:write", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_import_zapier_commit", "semantic_input_mode": "inherit_workflow", "summary": "Commit Zapier export JSON → installed connection + logic (not dry-run).", "title": "Integrations Import Zapier Commit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Commit Zapier export JSON → installed connection + logic (not dry-run).", "write_mode": null}, {"action": "integrations.import_make_commit", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.import_make_commit", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import Make Commit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Commit Make scenario JSON → installed connection + logic (not dry-run)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.import_make_commit", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import Make Commit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Commit Make scenario JSON → installed connection + logic (not dry-run)."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Commit Make scenario JSON → installed connection + logic (not dry-run).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "integrations:write", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_import_make_commit", "semantic_input_mode": "inherit_workflow", "summary": "Commit Make scenario JSON → installed connection + logic (not dry-run).", "title": "Integrations Import Make Commit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Commit Make scenario JSON → installed connection + logic (not dry-run).", "write_mode": null}, {"action": "integrations.import_make_preview", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.import_make_preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import Make Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run preview: map Make scenario JSON to recipe + logic block draft."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.import_make_preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import Make Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run preview: map Make scenario JSON to recipe + logic block draft."}, "do_not_use_when": "Applying the import. Preview does not install or run.", "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "read_only_hint": true, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Dry-run preview: map Make scenario JSON to recipe + logic block draft.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_import_make_preview", "semantic_input_mode": "inherit_workflow", "summary": "Dry-run preview: map Make scenario JSON to recipe + logic block draft.", "title": "Integrations Import Make Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Applying the import. Preview does not install or run.", "when_to_use": "Dry-run preview: map Make scenario JSON to recipe + logic block draft.", "write_mode": null}, {"action": "integrations.list_issues", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.list_issues", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Issues", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cluster failed outbound deliveries before integrations.replay_delivery."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.list_issues", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Issues", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cluster failed outbound deliveries before integrations.replay_delivery."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Cluster failed outbound deliveries before integrations.replay_delivery.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_issues", "semantic_input_mode": "inherit_workflow", "summary": "Cluster failed outbound deliveries into issues (Hookdeck-style).", "title": "Integrations List Issues", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cluster failed outbound deliveries before integrations.replay_delivery.", "write_mode": null}, {"action": "integrations.get_diagnostics", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.get_diagnostics", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get Diagnostics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Roll up Integration Hub worker health for a tenant project_id when hooks look stuck."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.get_diagnostics", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get Diagnostics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Roll up Integration Hub worker health for a tenant project_id when hooks look stuck."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Roll up Integration Hub worker health for a tenant project_id when hooks look stuck.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_get_diagnostics", "semantic_input_mode": "inherit_workflow", "summary": "Integration Hub diagnostics rollup and worker flags.", "title": "Integrations Get Diagnostics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Roll up Integration Hub worker health for a tenant project_id when hooks look stuck.", "write_mode": null}, {"action": "integrations.get_platform_diagnostics", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_platform_diagnostics", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get Platform Diagnostics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cross-tenant Integration Hub rollup (platform admin ops)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_platform_diagnostics", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get Platform Diagnostics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cross-tenant Integration Hub rollup (platform admin ops)."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Cross-tenant Integration Hub rollup (platform admin ops).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_get_platform_diagnostics", "semantic_input_mode": "inherit_workflow", "summary": "Cross-tenant Integration Hub rollup (platform admin ops).", "title": "Integrations Get Platform Diagnostics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cross-tenant Integration Hub rollup (platform admin ops).", "write_mode": null}, {"action": "integrations.get_hubspot_relay_stats", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_hubspot_relay_stats", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get Hubspot Relay Stats", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "HubSpot platform relay rollup (7d success/denied/no-connection/missing portal)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_hubspot_relay_stats", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get Hubspot Relay Stats", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "HubSpot platform relay rollup (7d success/denied/no-connection/missing portal)."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "HubSpot platform relay rollup (7d success/denied/no-connection/missing portal).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_get_hubspot_relay_stats", "semantic_input_mode": "inherit_workflow", "summary": "HubSpot platform relay rollup (7d success/denied/no-connection/missing portal).", "title": "Integrations Get Hubspot Relay Stats", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "HubSpot platform relay rollup (7d success/denied/no-connection/missing portal).", "write_mode": null}, {"action": "integrations.migrate_legacy_webhooks", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.migrate_legacy_webhooks", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Migrate Legacy Webhooks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Copy projects.config.webhooks into integration_connection rows."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.migrate_legacy_webhooks", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Migrate Legacy Webhooks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Copy projects.config.webhooks into integration_connection rows."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Copy projects.config.webhooks into integration_connection rows.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_migrate_legacy_webhooks", "semantic_input_mode": "inherit_workflow", "summary": "Copy projects.config.webhooks into integration_connection rows.", "title": "Integrations Migrate Legacy Webhooks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Copy projects.config.webhooks into integration_connection rows.", "write_mode": null}, {"action": "integrations.poll_connection", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.poll_connection", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Poll Connection", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll one poll_enabled connector — use scheduler + process_polling_batch for cadence."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.poll_connection", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Poll Connection", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll one poll_enabled connector — use scheduler + process_polling_batch for cadence."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Poll one poll_enabled connector — use scheduler + process_polling_batch for cadence.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_poll_connection", "semantic_input_mode": "inherit_workflow", "summary": "Run connector polling for a connection (cursor watermark in config.poll_state).", "title": "Integrations Poll Connection", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll one poll_enabled connector — use scheduler + process_polling_batch for cadence.", "write_mode": null}, {"action": "integrations.oauth_begin", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Callback URI must include /oauth/{provider}/callback/{project_id} — copy from Quick Setup.", "Provider id is x — not twitter.", "Secrets only via install_recipe secrets= or rotate — never projects.patch_data."], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.oauth_begin", "related_tools": ["integrations.list_connections", "integrations.list_recipes", "integrations.refresh_token", "integrations.connection_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Oauth Begin", "when_blocked": {"connection_not_found": "install_recipe or create_connection before oauth_begin", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "rbac.check_permission — integrations:read on tenant project", "input_required": "provider and connection_id required — integrations.list_connections", "invalid_parameters": "provider/connection_id strings required; request_base optional", "invalid_state": "Restart OAuth from hub — stale browser tab or CSRF state.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "oauth_credentials_missing": "Paste client_id/client_secret in Quick Setup, install, then oauth_begin", "project_mismatch": "Register callback URI with same project_id as workspace.", "provider_mismatch": "Reconnect using the connection's provider row (e.g. x not twitter).", "provider_not_found": "list_recipes — OAuth provider must exist in catalog", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "OAuth 2.0 PKCE — returns authorization_url after install_recipe or create_connection. User completes browser flow; then integrations.refresh_token / connection_health."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.oauth_begin", "related_tools": ["integrations.list_connections", "integrations.list_recipes", "integrations.refresh_token", "integrations.connection_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Oauth Begin", "when_blocked": {"connection_not_found": "install_recipe or create_connection before oauth_begin", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "rbac.check_permission — integrations:read on tenant project", "input_required": "provider and connection_id required — integrations.list_connections", "invalid_parameters": "provider/connection_id strings required; request_base optional", "invalid_state": "Restart OAuth from hub — stale browser tab or CSRF state.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "oauth_credentials_missing": "Paste client_id/client_secret in Quick Setup, install, then oauth_begin", "project_mismatch": "Register callback URI with same project_id as workspace.", "provider_mismatch": "Reconnect using the connection's provider row (e.g. x not twitter).", "provider_not_found": "list_recipes — OAuth provider must exist in catalog", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "OAuth 2.0 PKCE — returns authorization_url after install_recipe or create_connection. User completes browser flow; then integrations.refresh_token / connection_health."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "OAuth 2.0 PKCE — returns authorization_url after install_recipe or create_connection. User complete…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_connections", "integrations.list_recipes", "integrations.refresh_token", "integrations.connection_health"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_oauth_begin", "semantic_input_mode": "inherit_workflow", "summary": "Start OAuth 2.0 PKCE flow for an integration connection (returns authorization_url).", "title": "Integrations Oauth Begin", "when_blocked": {"connection_not_found": "install_recipe or create_connection before oauth_begin", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "rbac.check_permission — integrations:read on tenant project", "input_required": "provider and connection_id required — integrations.list_connections", "invalid_parameters": "provider/connection_id strings required; request_base optional", "invalid_state": "Restart OAuth from hub — stale browser tab or CSRF state.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "oauth_credentials_missing": "Paste client_id/client_secret in Quick Setup, install, then oauth_begin", "project_mismatch": "Register callback URI with same project_id as workspace.", "provider_mismatch": "Reconnect using the connection's provider row (e.g. x not twitter).", "provider_not_found": "list_recipes — OAuth provider must exist in catalog", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "OAuth 2.0 PKCE — returns authorization_url after install_recipe or create_connection. User completes browser flow; then integrations.refresh_token / connection_health.", "write_mode": null}, {"action": "integrations.refresh_token", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.refresh_token", "related_tools": ["integrations.oauth_begin", "integrations.connection_health", "integrations.list_connections"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Refresh Token", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "connection_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_refresh_token": "integrations.oauth_begin — offline.access consent", "needs_auth": "oauth_begin then refresh_token", "no_access_token": "Token exchange succeeded but access_token empty", "refresh_failed": "Retry; then oauth_begin if HTTP persists", "refresh_no_token": "integrations.oauth_begin — reconnect OAuth", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "token_exchange_failed": "Token endpoint HTTP error during refresh", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After oauth_begin and the browser flow — refresh an expired OAuth token before outbound calls."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.refresh_token", "related_tools": ["integrations.oauth_begin", "integrations.connection_health", "integrations.list_connections"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Refresh Token", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "connection_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_refresh_token": "integrations.oauth_begin — offline.access consent", "needs_auth": "oauth_begin then refresh_token", "no_access_token": "Token exchange succeeded but access_token empty", "refresh_failed": "Retry; then oauth_begin if HTTP persists", "refresh_no_token": "integrations.oauth_begin — reconnect OAuth", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "token_exchange_failed": "Token endpoint HTTP error during refresh", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After oauth_begin and the browser flow — refresh an expired OAuth token before outbound calls."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "After oauth_begin and the browser flow — refresh an expired OAuth token before outbound calls.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.oauth_begin", "integrations.connection_health", "integrations.list_connections"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_refresh_token", "semantic_input_mode": "inherit_workflow", "summary": "Refresh OAuth access token for a connection when expired (protected storage).", "title": "Integrations Refresh Token", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "connection_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_refresh_token": "integrations.oauth_begin — offline.access consent", "needs_auth": "oauth_begin then refresh_token", "no_access_token": "Token exchange succeeded but access_token empty", "refresh_failed": "Retry; then oauth_begin if HTTP persists", "refresh_no_token": "integrations.oauth_begin — reconnect OAuth", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "token_exchange_failed": "Token endpoint HTTP error during refresh", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After oauth_begin and the browser flow — refresh an expired OAuth token before outbound calls.", "write_mode": null}, {"action": "integrations.diagnose_telegram", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.diagnose_telegram", "related_tools": ["integrations.activate_webhook", "integrations.connection_health", "integrations.rotate_secret"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Diagnose Telegram", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_a_telegram_connection": "Provider must be telegram", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Telegram webhook triage before integrations.activate_webhook — token, secret, public URL, getWebhookInfo alignment. Read-only; no setWebhook."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.diagnose_telegram", "related_tools": ["integrations.activate_webhook", "integrations.connection_health", "integrations.rotate_secret"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Diagnose Telegram", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_a_telegram_connection": "Provider must be telegram", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Telegram webhook triage before integrations.activate_webhook — token, secret, public URL, getWebhookInfo alignment. Read-only; no setWebhook."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Telegram webhook triage before integrations.activate_webhook — token, secret, public URL, getWebhoo…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.activate_webhook", "integrations.connection_health", "integrations.rotate_secret"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_diagnose_telegram", "semantic_input_mode": "inherit_workflow", "summary": "Read-only Telegram connection health: token, webhook_secret, public URL, getWebhookInfo.", "title": "Integrations Diagnose Telegram", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_a_telegram_connection": "Provider must be telegram", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Telegram webhook triage before integrations.activate_webhook — token, secret, public URL, getWebhookInfo alignment. Read-only; no setWebhook.", "write_mode": null}, {"action": "integrations.activate_webhook", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.activate_webhook", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Activate Webhook", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hub-level setWebhook when OAuth/manual retry needs it. Prefer bots.go_live activate_webhook=true for fleet bots (mentor gate + lifecycle). Dual-token migration: bots.pause legacy primary first."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.activate_webhook", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Activate Webhook", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hub-level setWebhook when OAuth/manual retry needs it. Prefer bots.go_live activate_webhook=true for fleet bots (mentor gate + lifecycle). Dual-token migration: bots.pause legacy primary first."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Hub-level setWebhook when OAuth/manual retry needs it. Prefer bots.go_live activate_webhook=true fo…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_activate_webhook", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Register provider inbound webhook for a connection (post-OAuth or manual retry). Telegram: sets BotFather webhook URL to this connection's hook slug.", "title": "Integrations Activate Webhook", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hub-level setWebhook when OAuth/manual retry needs it. Prefer bots.go_live activate_webhook=true for fleet bots (mentor gate + lifecycle). Dual-token migration: bots.pause legacy primary first.", "write_mode": null}, {"action": "integrations.update_connection", "aliases": ["webhooks.delete"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.update_connection", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Update Connection", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch label, status, direction, or poll config — never secrets (use rotate_secret)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.update_connection", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Update Connection", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch label, status, direction, or poll config — never secrets (use rotate_secret)."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Patch label, status, direction, or poll config — never secrets (use rotate_secret).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_update_connection", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch integration connection metadata (label, status, config, direction).", "title": "Integrations Update Connection", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch label, status, direction, or poll config — never secrets (use rotate_secret).", "write_mode": null}, {"action": "integrations.list_scenarios", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_scenarios", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Scenarios", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List integration scenarios for a project scope."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_scenarios", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Scenarios", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List integration scenarios for a project scope."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List integration scenarios for a project scope.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_scenarios", "semantic_input_mode": "inherit_workflow", "summary": "List integration scenarios for a project scope.", "title": "Integrations List Scenarios", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List integration scenarios for a project scope.", "write_mode": null}, {"action": "integrations.get_scenario", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_scenario", "related_tools": ["integrations.list_scenarios", "integrations.save_scenario_draft"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get integration scenario detail (draft + publish metadata)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_scenario", "related_tools": ["integrations.list_scenarios", "integrations.save_scenario_draft"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get integration scenario detail (draft + publish metadata)."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Get integration scenario detail (draft + publish metadata).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_scenarios", "integrations.save_scenario_draft"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_get_scenario", "semantic_input_mode": "inherit_workflow", "summary": "Get integration scenario detail (draft + publish metadata).", "title": "Integrations Get Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get integration scenario detail (draft + publish metadata).", "write_mode": null}, {"action": "integrations.reveal_secrets", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.reveal_secrets", "related_tools": ["integrations.get_connection", "integrations.rotate_secret"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Reveal Secrets", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reveal connection secrets for operators (audit-logged; high privilege)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.reveal_secrets", "related_tools": ["integrations.get_connection", "integrations.rotate_secret"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Reveal Secrets", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reveal connection secrets for operators (audit-logged; high privilege)."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Reveal connection secrets for operators (audit-logged; high privilege).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.get_connection", "integrations.rotate_secret"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_reveal_secrets", "semantic_input_mode": "inherit_workflow", "summary": "Reveal connection secrets for operators (audit-logged; high privilege).", "title": "Integrations Reveal Secrets", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reveal connection secrets for operators (audit-logged; high privilege).", "write_mode": null}, {"action": "integrations.create_scenario", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.create_scenario", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Create Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Draft multi-step outbound HTTP when catalog recipes are too narrow — pair with logic.create."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.create_scenario", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Create Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Draft multi-step outbound HTTP when catalog recipes are too narrow — pair with logic.create."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Draft multi-step outbound HTTP when catalog recipes are too narrow — pair with logic.create.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_create_scenario", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a draft integration scenario with backing logic rule.", "title": "Integrations Create Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Draft multi-step outbound HTTP when catalog recipes are too narrow — pair with logic.create.", "write_mode": null}, {"action": "integrations.save_scenario_draft", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": true, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.save_scenario_draft", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Save Scenario Draft", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Save scenario draft (spec and/or logic patch). Parity with REST POST /scenarios/{id}/draft."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": true, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.save_scenario_draft", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Save Scenario Draft", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Save scenario draft (spec and/or logic patch). Parity with REST POST /scenarios/{id}/draft."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": true, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Save scenario draft (spec and/or logic patch). Parity with REST POST /scenarios/{id}/draft.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_save_scenario_draft", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Save scenario draft (spec and/or logic patch). Parity with REST POST /scenarios/{id}/draft.", "title": "Integrations Save Scenario Draft", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Save scenario draft (spec and/or logic patch). Parity with REST POST /scenarios/{id}/draft.", "write_mode": null}, {"action": "integrations.unpublish_scenario", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.unpublish_scenario", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Unpublish Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Unpublish scenario (pause) and disable backing logic. Parity with REST unpublish."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.unpublish_scenario", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Unpublish Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Unpublish scenario (pause) and disable backing logic. Parity with REST unpublish."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Unpublish scenario (pause) and disable backing logic. Parity with REST unpublish.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "production_publish", "safe_action": "integrations_unpublish_scenario", "semantic_input_mode": "inherit_workflow", "summary": "Unpublish scenario (pause) and disable backing logic. Parity with REST unpublish.", "title": "Integrations Unpublish Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Unpublish scenario (pause) and disable backing logic. Parity with REST unpublish.", "write_mode": null}, {"action": "integrations.publish_scenario", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.publish_scenario", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Publish Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scenario_not_found": "integrations.list_scenarios — create_scenario or import preview first", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verification_failed": "integrations.test_scenario_step before publish"}, "when_to_use": "Go live on a draft scenario only after integrations.test_scenario_step passes."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.publish_scenario", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Publish Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scenario_not_found": "integrations.list_scenarios — create_scenario or import preview first", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verification_failed": "integrations.test_scenario_step before publish"}, "when_to_use": "Go live on a draft scenario only after integrations.test_scenario_step passes."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Go live on a draft scenario only after integrations.test_scenario_step passes.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "production_publish", "safe_action": "integrations_publish_scenario", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Publish scenario (live) and enable backing logic.", "title": "Integrations Publish Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scenario_not_found": "integrations.list_scenarios — create_scenario or import preview first", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verification_failed": "integrations.test_scenario_step before publish"}, "when_to_use": "Go live on a draft scenario only after integrations.test_scenario_step passes.", "write_mode": null}, {"action": "integrations.test_scenario_step", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.test_scenario_step", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Test Scenario Step", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run one scenario step before publish_scenario."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.test_scenario_step", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Test Scenario Step", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run one scenario step before publish_scenario."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Dry-run one scenario step before publish_scenario.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_test_scenario_step", "semantic_input_mode": "inherit_workflow", "summary": "Dry-run a scenario step via logic simulation.", "title": "Integrations Test Scenario Step", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run one scenario step before publish_scenario.", "write_mode": null}, {"action": "integrations.list_scenario_runs", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_scenario_runs", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Scenario Runs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List recorded test/run history for a scenario."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_scenario_runs", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Scenario Runs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List recorded test/run history for a scenario."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List recorded test/run history for a scenario.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_scenario_runs", "semantic_input_mode": "inherit_workflow", "summary": "List recorded test/run history for a scenario.", "title": "Integrations List Scenario Runs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List recorded test/run history for a scenario.", "write_mode": null}, {"action": "integrations.list_apps", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_apps", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Apps", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List integration app catalog entries (connectors + recipe metadata)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_apps", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Apps", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List integration app catalog entries (connectors + recipe metadata)."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List integration app catalog entries (connectors + recipe metadata).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_apps", "semantic_input_mode": "inherit_workflow", "summary": "List integration app catalog entries (connectors + recipe metadata).", "title": "Integrations List Apps", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List integration app catalog entries (connectors + recipe metadata).", "write_mode": null}, {"action": "integrations.get_app", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_app", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get App", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get a single integration app definition by provider id."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_app", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get App", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get a single integration app definition by provider id."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Get a single integration app definition by provider id.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_get_app", "semantic_input_mode": "inherit_workflow", "summary": "Get a single integration app definition by provider id.", "title": "Integrations Get App", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get a single integration app definition by provider id.", "write_mode": null}, {"action": "integrations.list_app_triggers", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_app_triggers", "related_tools": ["integrations.get_app", "integrations.list_app_actions"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List App Triggers", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List trigger definitions for an integration app provider."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_app_triggers", "related_tools": ["integrations.get_app", "integrations.list_app_actions"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List App Triggers", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List trigger definitions for an integration app provider."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List trigger definitions for an integration app provider.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.get_app", "integrations.list_app_actions"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_app_triggers", "semantic_input_mode": "inherit_workflow", "summary": "List trigger definitions for an integration app provider.", "title": "Integrations List App Triggers", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List trigger definitions for an integration app provider.", "write_mode": null}, {"action": "integrations.list_app_actions", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_app_actions", "related_tools": ["integrations.get_app", "integrations.list_app_triggers"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List App Actions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List action definitions for an integration app provider."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_app_actions", "related_tools": ["integrations.get_app", "integrations.list_app_triggers"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List App Actions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List action definitions for an integration app provider."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List action definitions for an integration app provider.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.get_app", "integrations.list_app_triggers"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_app_actions", "semantic_input_mode": "inherit_workflow", "summary": "List action definitions for an integration app provider.", "title": "Integrations List App Actions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List action definitions for an integration app provider.", "write_mode": null}, {"action": "integrations.dynamic_fields", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.dynamic_fields", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Dynamic Fields", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List dynamic field sources for an integration app (schema-only in Phase 1)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.dynamic_fields", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Dynamic Fields", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List dynamic field sources for an integration app (schema-only in Phase 1)."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List dynamic field sources for an integration app (schema-only in Phase 1).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_dynamic_fields", "semantic_input_mode": "inherit_workflow", "summary": "List dynamic field sources for an integration app (schema-only in Phase 1).", "title": "Integrations Dynamic Fields", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List dynamic field sources for an integration app (schema-only in Phase 1).", "write_mode": null}, {"action": "integrations.list_dlq_deliveries", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_dlq_deliveries", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Dlq Deliveries", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List integration outbound deliveries in DLQ or terminal failure state."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_dlq_deliveries", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Dlq Deliveries", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List integration outbound deliveries in DLQ or terminal failure state."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List integration outbound deliveries in DLQ or terminal failure state.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_dlq_deliveries", "semantic_input_mode": "inherit_workflow", "summary": "List integration outbound deliveries in DLQ or terminal failure state.", "title": "Integrations List Dlq Deliveries", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List integration outbound deliveries in DLQ or terminal failure state.", "write_mode": null}, {"action": "integrations.generate_scenario", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.generate_scenario", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Generate Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Keyword-only RuleDocumentV1 draft (no LLM). Server sets preview_only=true. Continue with integrations.save_scenario_draft then logic.dry_run before publish."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.generate_scenario", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Generate Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Keyword-only RuleDocumentV1 draft (no LLM). Server sets preview_only=true. Continue with integrations.save_scenario_draft then logic.dry_run before publish."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Keyword-only RuleDocumentV1 draft (no LLM). Server sets preview_only=true. Continue with integratio…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_generate_scenario", "semantic_input_mode": "inherit_workflow", "summary": "Keyword-only RuleDocumentV1 draft (no LLM). Server sets preview_only=true. Continue with integrations.save_scenario_draft then logic.dry_run before publish.", "title": "Integrations Generate Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Keyword-only RuleDocumentV1 draft (no LLM). Server sets preview_only=true. Continue with integrations.save_scenario_draft then logic.dry_run before publish.", "write_mode": null}, {"action": "integrations.import_n8n_preview", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.import_n8n_preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import N8N Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Map known nodes (webhook, set, manual, schedule, if). parameters and edges are copied. stub is true when a node has no action. This preview does not install or run the workflow."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.import_n8n_preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import N8N Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Map known nodes (webhook, set, manual, schedule, if). parameters and edges are copied. stub is true when a node has no action. This preview does not install or run the workflow."}, "do_not_use_when": "Applying the import. Preview does not install or run.", "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "read_only_hint": true, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Map known nodes (webhook, set, manual, schedule, if). parameters and edges are copied. stub is true…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_import_n8n_preview", "semantic_input_mode": "inherit_workflow", "summary": "Preview n8n workflow JSON as AgentStack steps. Does not install or run it.", "title": "Integrations Import N8N Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Applying the import. Preview does not install or run.", "when_to_use": "Map known nodes (webhook, set, manual, schedule, if). parameters and edges are copied. stub is true when a node has no action. This preview does not install or run the workflow.", "write_mode": null}, {"action": "integrations.import_n8n_commit", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.import_n8n_commit", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import N8N Commit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Commit n8n workflow JSON → installed connection + logic (not dry-run)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.import_n8n_commit", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import N8N Commit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Commit n8n workflow JSON → installed connection + logic (not dry-run)."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Commit n8n workflow JSON → installed connection + logic (not dry-run).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "integrations:write", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_import_n8n_commit", "semantic_input_mode": "inherit_workflow", "summary": "Commit n8n workflow JSON → installed connection + logic (not dry-run).", "title": "Integrations Import N8N Commit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Commit n8n workflow JSON → installed connection + logic (not dry-run).", "write_mode": null}, {"action": "integrations.list_modules", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_modules", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Modules", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List reusable sub-scenario module stubs."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_modules", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Modules", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List reusable sub-scenario module stubs."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List reusable sub-scenario module stubs.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_modules", "semantic_input_mode": "inherit_workflow", "summary": "List reusable sub-scenario module stubs.", "title": "Integrations List Modules", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List reusable sub-scenario module stubs.", "write_mode": null}, {"action": "integrations.register_module", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.register_module", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Register Module", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Register a reusable sub-scenario module stub on a parent connection."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.register_module", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Register Module", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Register a reusable sub-scenario module stub on a parent connection."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Register a reusable sub-scenario module stub on a parent connection.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_register_module", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Register a reusable sub-scenario module stub on a parent connection.", "title": "Integrations Register Module", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Register a reusable sub-scenario module stub on a parent connection.", "write_mode": null}, {"action": "integrations.list_module_registrations", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_module_registrations", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Module Registrations", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List module registrations persisted on connection DNA rows."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_module_registrations", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Module Registrations", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List module registrations persisted on connection DNA rows."}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List module registrations persisted on connection DNA rows.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_module_registrations", "semantic_input_mode": "inherit_workflow", "summary": "List module registrations persisted on connection DNA rows.", "title": "Integrations List Module Registrations", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List module registrations persisted on connection DNA rows.", "write_mode": null}, {"action": "integrations.mailbox", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not put the message body or the OAuth token in logs or in a second chat sender.", "anti_patterns": ["Do not put the message body or the OAuth token in logs or in a second chat sender.", "Do not call op=send to reply to corporate mail; that path is the outbound queue.", "Do not request gmail.modify."], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.oauth.gen1"], "id": "integrations.mailbox", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Mailbox", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "The user connected Gmail or Microsoft Mail and wants those letters listed, read, or answered. For @agentstack.tech use the corporate mailbox. For chat delivery use notifications.update_prefs {category"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.oauth.gen1"], "id": "integrations.mailbox", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Mailbox", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "The user connected Gmail or Microsoft Mail and wants those letters listed, read, or answered. For @agentstack.tech use the corporate mailbox. For chat delivery use notifications.update_prefs {category"}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "The user connected Gmail or Microsoft Mail and wants those letters listed, read, or answered. For @…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_mailbox", "semantic_input_mode": "inherit_workflow", "summary": "Read or send mail on a connected Gmail or Microsoft mailbox. op is list, get, or send. Tokens stay on the connection. list returns id, subject, from, snippet (max 10). get returns plain text whole unt", "title": "Integrations Mailbox", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "The user connected Gmail or Microsoft Mail and wants those letters listed, read, or answered. For @agentstack.tech use the corporate mailbox. For chat delivery use notifications.update_prefs {category", "write_mode": null}, {"action": "integrations.social_post", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not call without connection_id from list_connections after recipe_x_publish + oauth_begin.", "Do not blind-retry x_duplicate_content; change text or accept failure.", "Do not use build_outbound/http_fetch when integrations.social_post exists.", "Do not omit idempotency_key on live create/thread/delete."], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1", "core.integrations.oauth.gen1"], "id": "integrations.social_post", "mutation_risk": "high", "related_tools": ["integrations.oauth_begin", "integrations.refresh_token", "integrations.list_connections", "agents.approve_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Social Post", "when_blocked": {"connection_not_found": "integrations.list_connections — install recipe_x_publish first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "draft_id_required": "op=cancel requires draft_id from draft_upsert", "forbidden": "Permission denied — integrations:write or project_admin", "idempotency_conflict": "Wait and replay; completed claim returns same tweet_id", "idempotency_key_required": "Pass stable idempotency_key on live create/thread/delete (dry_run may omit)", "idempotency_unavailable": "Idempotency store unavailable — retry with same key; do not assume dedupe", "invalid_op": "op must be create|thread|delete|draft_upsert|cancel", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "needs_auth": "integrations.oauth_begin then refresh_token — reconnect X", "oauth_credentials_missing": "Store client_id/client_secret on connection secrets, then oauth_begin", "provider_error": "X API error — read status in response; fix text/credits/auth", "provider_mismatch": "Connection provider must be x — integrations.list_connections", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "thread_parts_required": "op=thread needs parts[] with ≥2 strings (or text+parts)", "unsupported_channel": "provider must be x (not twitter alias)", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "x_credits_depleted": "Top up X API credits / check developer console", "x_duplicate_content": "Change text or accept failure — do not blind retry", "x_rate_limited": "Backoff; honor Retry-After; retry with same idempotency_key"}, "when_to_use": "Connected X (provider=x): op=create|thread|delete|draft_upsert|cancel. Prefer dry_run then same idempotency_key on live create/thread/delete. Not notifications.deliver, bots.staff_reply, or AgentSocia"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1", "core.integrations.oauth.gen1"], "id": "integrations.social_post", "mutation_risk": "high", "related_tools": ["integrations.oauth_begin", "integrations.refresh_token", "integrations.list_connections", "agents.approve_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Social Post", "when_blocked": {"connection_not_found": "integrations.list_connections — install recipe_x_publish first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "draft_id_required": "op=cancel requires draft_id from draft_upsert", "forbidden": "Permission denied — integrations:write or project_admin", "idempotency_conflict": "Wait and replay; completed claim returns same tweet_id", "idempotency_key_required": "Pass stable idempotency_key on live create/thread/delete (dry_run may omit)", "idempotency_unavailable": "Idempotency store unavailable — retry with same key; do not assume dedupe", "invalid_op": "op must be create|thread|delete|draft_upsert|cancel", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "needs_auth": "integrations.oauth_begin then refresh_token — reconnect X", "oauth_credentials_missing": "Store client_id/client_secret on connection secrets, then oauth_begin", "provider_error": "X API error — read status in response; fix text/credits/auth", "provider_mismatch": "Connection provider must be x — integrations.list_connections", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "thread_parts_required": "op=thread needs parts[] with ≥2 strings (or text+parts)", "unsupported_channel": "provider must be x (not twitter alias)", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "x_credits_depleted": "Top up X API credits / check developer console", "x_duplicate_content": "Change text or accept failure — do not blind retry", "x_rate_limited": "Backoff; honor Retry-After; retry with same idempotency_key"}, "when_to_use": "Connected X (provider=x): op=create|thread|delete|draft_upsert|cancel. Prefer dry_run then same idempotency_key on live create/thread/delete. Not notifications.deliver, bots.staff_reply, or AgentSocia"}, "domain": "integrations", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Connected X (provider=x): op=create|thread|delete|draft_upsert|cancel. Prefer dry_run then same ide…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.oauth_begin", "integrations.refresh_token", "integrations.list_connections", "agents.approve_run"], "required_cap": "mcp_write", "requires_preflight": true, "risk_class": "read", "safe_action": "integrations_social_post", "semantic_input_mode": "inherit_workflow", "summary": "Publish, thread, delete, or draft on a connected X account (provider=x). OAuth connection required. Prefer over raw http_fetch. Not for user alerts (notifications.deliver) or TG chat (bots.staff_reply", "title": "Integrations Social Post", "when_blocked": {"connection_not_found": "integrations.list_connections — install recipe_x_publish first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "draft_id_required": "op=cancel requires draft_id from draft_upsert", "forbidden": "Permission denied — integrations:write or project_admin", "idempotency_conflict": "Wait and replay; completed claim returns same tweet_id", "idempotency_key_required": "Pass stable idempotency_key on live create/thread/delete (dry_run may omit)", "idempotency_unavailable": "Idempotency store unavailable — retry with same key; do not assume dedupe", "invalid_op": "op must be create|thread|delete|draft_upsert|cancel", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "needs_auth": "integrations.oauth_begin then refresh_token — reconnect X", "oauth_credentials_missing": "Store client_id/client_secret on connection secrets, then oauth_begin", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "provider_error": "X API error — read status in response; fix text/credits/auth", "provider_mismatch": "Connection provider must be x — integrations.list_connections", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "thread_parts_required": "op=thread needs parts[] with ≥2 strings (or text+parts)", "unsupported_channel": "provider must be x (not twitter alias)", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "x_credits_depleted": "Top up X API credits / check developer console", "x_duplicate_content": "Change text or accept failure — do not blind retry", "x_rate_limited": "Backoff; honor Retry-After; retry with same idempotency_key"}, "when_to_use": "Connected X (provider=x): op=create|thread|delete|draft_upsert|cancel. Prefer dry_run then same idempotency_key on live create/thread/delete. Not notifications.deliver, bots.staff_reply, or AgentSocia", "write_mode": null}, {"action": "knowledge.config.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.config.get", "related_tools": ["knowledge.config.patch", "knowledge.prompt.get", "knowledge.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Config Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read knowledge config before patch or playground. When shape.mode is not leaf, config is null and outline is names only. Do not patch that outline back. Fat configs (Unity gene_pack): pass detail=full"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.config.get", "related_tools": ["knowledge.config.patch", "knowledge.prompt.get", "knowledge.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Config Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read knowledge config before patch or playground. When shape.mode is not leaf, config is null and outline is names only. Do not patch that outline back. Fat configs (Unity gene_pack): pass detail=full"}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Prod config", "request": {"params": {"project_id": 1}, "tool": "knowledge.config.get"}, "response": {"data": {"config": {}, "safety_playbooks": []}, "success": true}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts."}, "instruction_hint": "Read knowledge config before patch or playground. When shape.mode is not leaf, config is null and o…", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT", "KNOWLEDGE_CONFIG_PATCH_VS_PATCH_DATA", "KNOWLEDGE_TENANT_EDIT_LADDER", "GENERATION_SAFE_CYCLE_LADDER"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.config.patch", "knowledge.prompt.get", "knowledge.health"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_config_get", "semantic_input_mode": "inherit_workflow", "summary": "GET knowledge config — RAG lanes, entitlements, default_playground_bot_uuid, ingest policy.", "title": "Knowledge Config Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read knowledge config before patch or playground. When shape.mode is not leaf, config is null and outline is names only. Do not patch that outline back. Fat configs (Unity gene_pack): pass detail=full", "write_mode": null}, {"action": "knowledge.prompt.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.prompt.get", "related_tools": ["knowledge.prompt.patch", "knowledge.playground", "knowledge.kb.ingest"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Prompt Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load Plan instructions before prompt.patch. Check plan_instructions_chars before replace."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.prompt.get", "related_tools": ["knowledge.prompt.patch", "knowledge.playground", "knowledge.kb.ingest"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Prompt Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load Plan instructions before prompt.patch. Check plan_instructions_chars before replace."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Default grounded prompt", "request": {"params": {"project_id": 1}, "tool": "knowledge.prompt.get"}, "response": {"data": {"prompt": {}}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Load Plan instructions before prompt.patch. Check plan_instructions_chars before replace.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.prompt.patch", "knowledge.playground", "knowledge.kb.ingest"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_prompt_get", "semantic_input_mode": "inherit_workflow", "summary": "Grounded assistant preamble + plan_instructions (same as GET /knowledge/prompt). Both strings come back whole. A field over the compact envelope is a preview, not the field to patch. system_preamble_c", "title": "Knowledge Prompt Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load Plan instructions before prompt.patch. Check plan_instructions_chars before replace.", "write_mode": null}, {"action": "knowledge.prompt.patch", "ai_tips": "GET first and check plan_instructions_chars. Sending a short stub as plan_instructions used to wipe a 7k-char plan. write_mode=append adds a bullet. write_mode=search_replace plus replacements edits the stored field without pasting it. Stub replace → prompt_shrink_blocked unless allow_shrink=true. See GET /mcp/actions write_modes and prompt agentstack_write_modes.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Sending a 7-line plan_instructions as a patch — omit-unset is keys only; the sent string replaces the whole field.", "anti_patterns": ["Sending a 7-line plan_instructions as a patch — omit-unset is keys only; the sent string replaces the whole field.", "Skipping knowledge.prompt.get and inventing a shorter plan.", "Using write_mode=merge on prompt fields (unsupported; use append or get+replace)."], "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.prompt.patch", "mutation_risk": "low", "related_tools": ["knowledge.prompt.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Prompt Patch", "when_blocked": {"ambiguous_anchor": "Multiple find matches — set count or use a longer unique find", "assistant_agent_not_found": "knowledge.prompt.get — bind a grounded assistant first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "Re-read the prompt field; retry unified_diff or search_replace", "patch_too_large": "Shorten unified_diff or edit a smaller field window", "prompt_patch_required": "Pass system_preamble, plan_instructions, version, or replacements", "prompt_shrink_blocked": "search_replace on field=plan_instructions|system_preamble", "replacement_not_found": "GET prompt — substring not in that field", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "Unknown write_mode — see BODY_WRITE_MODE_ENUM", "write_mode_unsupported": "Prompt fields: append|search_replace|replace — not merge"}, "when_to_use": "Edit one sentence with search_replace (field=plan_instructions). Append a bullet, or replace the whole field after prompt.get."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.prompt.patch", "mutation_risk": "low", "related_tools": ["knowledge.prompt.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Prompt Patch", "when_blocked": {"ambiguous_anchor": "Multiple find matches — set count or use a longer unique find", "assistant_agent_not_found": "knowledge.prompt.get — bind a grounded assistant first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "Re-read the prompt field; retry unified_diff or search_replace", "patch_too_large": "Shorten unified_diff or edit a smaller field window", "prompt_patch_required": "Pass system_preamble, plan_instructions, version, or replacements", "prompt_shrink_blocked": "search_replace on field=plan_instructions|system_preamble", "replacement_not_found": "GET prompt — substring not in that field", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "Unknown write_mode — see BODY_WRITE_MODE_ENUM", "write_mode_unsupported": "Prompt fields: append|search_replace|replace — not merge"}, "when_to_use": "Edit one sentence with search_replace (field=plan_instructions). Append a bullet, or replace the whole field after prompt.get."}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Edit one sentence with search_replace (field=plan_instructions). Append a bullet, or replace the wh…", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "body", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.prompt.get"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_prompt_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch grounded assistant system_preamble and/or plan_instructions (same as PATCH /knowledge/prompt). omit-unset keeps unsent keys; a sent field is the full string. Writes prompt_settings leaf via patc", "title": "Knowledge Prompt Patch", "when_blocked": {"ambiguous_anchor": "Multiple find matches — set count or use a longer unique find", "assistant_agent_not_found": "knowledge.prompt.get — bind a grounded assistant first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "Re-read the prompt field; retry unified_diff or search_replace", "patch_too_large": "Shorten unified_diff or edit a smaller field window", "prompt_patch_required": "Pass system_preamble, plan_instructions, version, or replacements", "prompt_shrink_blocked": "search_replace on field=plan_instructions|system_preamble", "replacement_not_found": "GET prompt — substring not in that field", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "Unknown write_mode — see BODY_WRITE_MODE_ENUM", "write_mode_unsupported": "Prompt fields: append|search_replace|replace — not merge"}, "when_to_use": "Edit one sentence with search_replace (field=plan_instructions). Append a bullet, or replace the whole field after prompt.get.", "write_mode": ["replace", "write", "append", "prepend", "search_replace", "unified_diff"], "write_mode_note": "omit-unset keeps unsent keys only. A sent plan_instructions / system_preamble replaces that entire string. GET first; write_mode=append for a new bullet; search_replace edits field without a full paste; stub replace → prompt_shrink_blocked."}, {"action": "knowledge.access.grant", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "entitlement", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.access.grant", "related_tools": ["knowledge.access.list", "knowledge.access.revoke", "knowledge.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Access Grant", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "principal_user_id_and_product_id_required": "principal_user_id and product_id required — knowledge.access.list for rows", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Grant product/tier access to a principal user (entitlement row)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "entitlement", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.access.grant", "related_tools": ["knowledge.access.list", "knowledge.access.revoke", "knowledge.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Access Grant", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "principal_user_id_and_product_id_required": "principal_user_id and product_id required — knowledge.access.list for rows", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Grant product/tier access to a principal user (entitlement row)."}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Grant product/tier access to a principal user (entitlement row).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.access.list", "knowledge.access.revoke", "knowledge.health"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_access_grant", "semantic_input_mode": "inherit_workflow", "summary": "Grant product/tier access to a principal user (entitlement row).", "title": "Knowledge Access Grant", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "principal_user_id_and_product_id_required": "principal_user_id and product_id required — knowledge.access.list for rows", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Grant product/tier access to a principal user (entitlement row).", "write_mode": null}, {"action": "knowledge.access.revoke", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "entitlement", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.access.revoke", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Access Revoke", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "grant_not_found": "knowledge.access.list — no row for principal_user_id + product_id", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke a principal product grant after refund or role change."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "entitlement", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.access.revoke", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Access Revoke", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "grant_not_found": "knowledge.access.list — no row for principal_user_id + product_id", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke a principal product grant after refund or role change."}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Revoke a principal product grant after refund or role change.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": true, "risk_class": "destructive", "safe_action": "knowledge_access_revoke", "semantic_input_mode": "inherit_workflow", "summary": "Revoke a principal product grant after refund or role change.", "title": "Knowledge Access Revoke", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "grant_not_found": "knowledge.access.list — no row for principal_user_id + product_id", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke a principal product grant after refund or role change.", "write_mode": null}, {"action": "knowledge.access.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "entitlement", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.access.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Access List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List access grants before grant/revoke or entitlement QA."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "entitlement", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.access.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Access List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List access grants before grant/revoke or entitlement QA."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List access grants before grant/revoke or entitlement QA.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_access_list", "semantic_input_mode": "inherit_workflow", "summary": "List access grants before grant/revoke or entitlement QA.", "title": "Knowledge Access List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List access grants before grant/revoke or entitlement QA.", "write_mode": null}, {"action": "knowledge.kb.ingest", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "mutates_when": {"validate_only": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.kb.ingest", "mutates_when": {"validate_only": false}, "related_tools": ["rag.document_add_batch", "rag.ingest_job_status", "rag.search", "knowledge.playground", "knowledge.eval.run", "knowledge.export"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Knowledge Kb Ingest", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "entitlement_blocked": "RAG tier/collection limit — knowledge.health or buffs.get_effective_limits", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "ingest_shed": "Queue shed — retry later or enqueue=false for sync ingest", "invalid_parameters": "documents[] shape or project_id invalid — discovery.describe", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "knowledge_entitlement_denied": "Check buffs / tier before bulk ingest", "knowledge_ingest_failed": "See data.errors[] for per-document failure rows", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ingest KB document into project knowledge index."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "mutates_when": {"validate_only": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.kb.ingest", "mutates_when": {"validate_only": false}, "related_tools": ["rag.document_add_batch", "rag.ingest_job_status", "rag.search", "knowledge.playground", "knowledge.eval.run", "knowledge.export"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Knowledge Kb Ingest", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "entitlement_blocked": "RAG tier/collection limit — knowledge.health or buffs.get_effective_limits", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "ingest_shed": "Queue shed — retry later or enqueue=false for sync ingest", "invalid_parameters": "documents[] shape or project_id invalid — discovery.describe", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "knowledge_entitlement_denied": "Check buffs / tier before bulk ingest", "knowledge_ingest_failed": "See data.errors[] for per-document failure rows", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ingest KB document into project knowledge index."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "validate_only=true validates paths and queue policy without enqueue; default queues ingest job (mutate)", "effect_depends_on_params": true, "execution_class": "cheap", "generation": true, "kind": "mutate", "mutates_when": {"validate_only": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Async ingest one doc", "request": {"params": {"documents": [{"content": "Hello", "metadata": {"title": "demo"}}], "project_id": 1}, "tool": "knowledge.kb.ingest"}, "response": {"data": {"job_ids": [], "queued": true}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Ingest KB document into project knowledge index.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "next_actions": ["knowledge.health"], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"collection_id": {"description": "Scoped collection id used for ingest", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "documents": {"description": "Prepared document summaries", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "errors": {"description": "Per-document error rows on partial failure", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "job_ids": {"description": "Work queue job ids (or shed on overload)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "ok": {"description": "Ingest accepted", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "partial": {"description": "True when sync ingest had per-doc failures", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "queued": {"description": "True when jobs were enqueued", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "quota": {"description": "Collection quota snapshot after success", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "rag_plane": {"description": "Sandbox vs prod RAG plane label", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["rag.document_add_batch", "rag.ingest_job_status", "rag.search", "knowledge.playground", "knowledge.eval.run", "knowledge.export"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "rollback": ["generation.realign_to_prod"], "safe_action": "knowledge_kb_ingest", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Ingest documents into a KB collection (async by default). Failures attach instruction_slice and recovery_hint in the request locale.", "title": "Knowledge Kb Ingest", "verification": ["knowledge.health", "knowledge.config.get"], "verify": [{"action": "knowledge.health", "predicate": "named resource is visible"}, {"action": "knowledge.config.get", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "entitlement_blocked": "RAG tier/collection limit — knowledge.health or buffs.get_effective_limits", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "ingest_shed": "Queue shed — retry later or enqueue=false for sync ingest", "invalid_parameters": "documents[] shape or project_id invalid — discovery.describe", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "knowledge_entitlement_denied": "Check buffs / tier before bulk ingest", "knowledge_ingest_failed": "See data.errors[] for per-document failure rows", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ingest KB document into project knowledge index.", "write_mode": null}, {"action": "knowledge.kb.heal_index", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.kb.heal_index", "related_tools": ["knowledge.health", "knowledge.kb.ingest", "knowledge.content.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Kb Heal Index", "when_blocked": {"collection_not_found": "knowledge.health — verify collection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rag_index_sha256_mismatch": "This action realigns index; retry heal_index after ingest", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fix rag_index_sha256_mismatch without wiping collection."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.kb.heal_index", "related_tools": ["knowledge.health", "knowledge.kb.ingest", "knowledge.content.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Kb Heal Index", "when_blocked": {"collection_not_found": "knowledge.health — verify collection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rag_index_sha256_mismatch": "This action realigns index; retry heal_index after ingest", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fix rag_index_sha256_mismatch without wiping collection."}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Fix rag_index_sha256_mismatch without wiping collection.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.health", "knowledge.kb.ingest", "knowledge.content.list"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_kb_heal_index", "semantic_input_mode": "inherit_workflow", "summary": "Realign DNA storage_ref.sha256 to on-disk sqlite for a KB collection (no wipe). Fixes rag_index_sha256_mismatch. Default collection_id=content_registry.", "title": "Knowledge Kb Heal Index", "when_blocked": {"collection_not_found": "knowledge.health — verify collection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rag_index_sha256_mismatch": "This action realigns index; retry heal_index after ingest", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fix rag_index_sha256_mismatch without wiping collection.", "write_mode": null}, {"action": "knowledge.export", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.export", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Export", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export knowledge config + KB snapshot for backup. A fat bundle returns shape.mode outline and no bodies. detail=full raises the ceiling."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.export", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Export", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export knowledge config + KB snapshot for backup. A fat bundle returns shape.mode outline and no bodies. detail=full raises the ceiling."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Export knowledge config + KB snapshot for backup. A fat bundle returns shape.mode outline and no bo…", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_export", "semantic_input_mode": "inherit_workflow", "summary": "Export knowledge config + KB snapshot for backup. A fat bundle returns shape.mode outline and no bodies. detail=full raises the ceiling.", "title": "Knowledge Export", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export knowledge config + KB snapshot for backup. A fat bundle returns shape.mode outline and no bodies. detail=full raises the ceiling.", "write_mode": null}, {"action": "knowledge.eval.run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.eval.run", "related_tools": ["knowledge.eval.run_all", "knowledge.eval.retrieval", "knowledge.doctor.run", "generation.gates", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Eval Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eval_failed": "data.eval_passed false — not transport success; read cases[]", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before eval", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run single eval case against knowledge config."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.eval.run", "related_tools": ["knowledge.eval.run_all", "knowledge.eval.retrieval", "knowledge.doctor.run", "generation.gates", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Eval Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eval_failed": "data.eval_passed false — not transport success; read cases[]", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before eval", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run single eval case against knowledge config."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "instruction_hint": "Run single eval case against knowledge config.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.eval.run_all", "knowledge.eval.retrieval", "knowledge.doctor.run", "generation.gates", "generation.promote"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_eval_run", "semantic_input_mode": "inherit_workflow", "summary": "Golden safety eval cases against live KnowledgeConfig.", "title": "Knowledge Eval Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eval_failed": "data.eval_passed false — not transport success; read cases[]", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before eval", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run single eval case against knowledge config.", "write_mode": null}, {"action": "knowledge.eval.retrieval", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.eval.retrieval", "related_tools": ["mentor.eval.retrieval", "knowledge.eval.run_all", "knowledge.health", "knowledge.kb.ingest"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Eval Retrieval", "when_blocked": {"collection_id_required": "Pass collection_id from knowledge.health", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "corpus_empty": "knowledge.kb.ingest + heal_index; data.corpus_empty on empty store", "eval_failed": "data.eval_passed false — ingest KB then knowledge.doctor.run", "feature_not_available": "knowledge.doctor.run — collections entitlement before eval", "fixture_missing": "Alias of fixture_required — resolved path empty or unreadable", "fixture_required": "Pass fixture or fixture_path (not retrieval_smoke_v1 for canonical_310826)", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Retrieval fixture eval — parity with mentor.eval.retrieval and REST POST /eval/retrieval."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.eval.retrieval", "related_tools": ["mentor.eval.retrieval", "knowledge.eval.run_all", "knowledge.health", "knowledge.kb.ingest"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Eval Retrieval", "when_blocked": {"collection_id_required": "Pass collection_id from knowledge.health", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "corpus_empty": "knowledge.kb.ingest + heal_index; data.corpus_empty on empty store", "eval_failed": "data.eval_passed false — ingest KB then knowledge.doctor.run", "feature_not_available": "knowledge.doctor.run — collections entitlement before eval", "fixture_missing": "Alias of fixture_required — resolved path empty or unreadable", "fixture_required": "Pass fixture or fixture_path (not retrieval_smoke_v1 for canonical_310826)", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Retrieval fixture eval — parity with mentor.eval.retrieval and REST POST /eval/retrieval."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "instruction_hint": "Retrieval fixture eval — parity with mentor.eval.retrieval and REST POST /eval/retrieval.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["mentor.eval.retrieval", "knowledge.eval.run_all", "knowledge.health", "knowledge.kb.ingest"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_eval_retrieval", "semantic_input_mode": "inherit_workflow", "summary": "Retrieval fixture eval — parity with mentor.eval.retrieval and REST POST /eval/retrieval.", "title": "Knowledge Eval Retrieval", "when_blocked": {"collection_id_required": "Pass collection_id from knowledge.health", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "corpus_empty": "knowledge.kb.ingest + heal_index; data.corpus_empty on empty store", "eval_failed": "data.eval_passed false — ingest KB then knowledge.doctor.run", "feature_not_available": "knowledge.doctor.run — collections entitlement before eval", "fixture_missing": "Alias of fixture_required — resolved path empty or unreadable", "fixture_required": "Pass fixture or fixture_path (not retrieval_smoke_v1 for canonical_310826)", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Retrieval fixture eval — parity with mentor.eval.retrieval and REST POST /eval/retrieval.", "write_mode": null}, {"action": "knowledge.config.patch", "ai_tips": "safety_playbooks_write_mode: patch (default) overlays one playbook; replace wipes to the sent dict only; merge fills empty template fields only. Use knowledge.policy_templates.apply for catalog overlays. context_lanes sets faq|consult|coding|design|architecture collections and a preamble. coding/design/architecture default to project_code, project_design, project_architecture. context_limits (prompt_tail_chars, lane_preamble_chars, builder_snippet_chars, resource_text_chars, lane_collection_cap) is the size SoT — patch it instead of assuming a fixed cap. Ingest design CSS/HTML with knowledge.kb.ingest content_type css|html|style|code. After patch, use config_stats (response=stats or default compact echo). One g", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "PATCHing knowledge.config.get outline when config is null.", "anti_patterns": ["PATCHing knowledge.config.get outline when config is null.", "Full gene_pack fixture via config.patch when knowledge.phenotype.upsert fits.", "Bundling gene_pack + product_id_map in one sync execute on large tenants."], "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.config.patch", "mutation_risk": "low", "related_tools": ["knowledge.config.get", "knowledge.phenotype.upsert", "knowledge.gene_pack.pinned_shape.upsert", "knowledge.kb.ingest", "knowledge.content.patch", "knowledge.prompt.patch"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Knowledge Config Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before config patch", "generation_fork_required": "auto_generation_mode on — omit env_uuid for auto-fork on patch or pass sandbox anchor; then generation.diff_vs_prod → generation.gates → generation.promote", "invalid_parameters": "discovery.describe; bind context.project_id; use env_uuid in generation sandbox", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_required": "Pass patch or config with at least one KnowledgeConfig field", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch one knowledge config key — prefer leaf paths over full blob. One heavy key per sync execute: full gene_pack OR product_id_map, not both."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.config.patch", "mutation_risk": "low", "related_tools": ["knowledge.config.get", "knowledge.phenotype.upsert", "knowledge.gene_pack.pinned_shape.upsert", "knowledge.kb.ingest", "knowledge.content.patch", "knowledge.prompt.patch"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Knowledge Config Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before config patch", "generation_fork_required": "auto_generation_mode on — omit env_uuid for auto-fork on patch or pass sandbox anchor; then generation.diff_vs_prod → generation.gates → generation.promote", "invalid_parameters": "discovery.describe; bind context.project_id; use env_uuid in generation sandbox", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_required": "Pass patch or config with at least one KnowledgeConfig field", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch one knowledge config key — prefer leaf paths over full blob. One heavy key per sync execute: full gene_pack OR product_id_map, not both."}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "generation_atoms": {"GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts."}, "instruction_hint": "Patch one knowledge config key — prefer leaf paths over full blob. One heavy key per sync execute: …", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT", "KNOWLEDGE_CONFIG_PATCH_VS_PATCH_DATA", "KNOWLEDGE_TENANT_EDIT_LADDER", "GENERATION_SAFE_CYCLE_LADDER"], "mutation_kind": "body", "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"config": {"description": "KnowledgeConfig body when shape.mode is leaf; null when outline-only", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "config_stats": {"description": "gene_pack_phenotype_n, product_id_map_keys, material_offer_catalog_n", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "outline": {"description": "Compact names-only view when config exceeds json_view budget", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "safety_playbooks": {"description": "Merged safety playbook map", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "shape": {"description": "json_view mode (leaf | item_page | …) and counts", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.config.get", "knowledge.phenotype.upsert", "knowledge.gene_pack.pinned_shape.upsert", "knowledge.kb.ingest", "knowledge.content.patch", "knowledge.prompt.patch"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "rollback": ["generation.realign_to_prod"], "safe_action": "knowledge_config_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch knowledge DNA config + safety playbooks (same as PATCH /knowledge/config). gene_pack merges by name; safety_playbooks default write_mode is patch (per-playbook overlay — other playbook ids are k", "title": "Knowledge Config Patch", "verification": ["knowledge.config.get", "knowledge.health"], "verify": [{"action": "knowledge.config.get", "predicate": "named resource is visible"}, {"action": "knowledge.health", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before config patch", "generation_fork_required": "auto_generation_mode on — omit env_uuid for auto-fork on patch or pass sandbox anchor; then generation.diff_vs_prod → generation.gates → generation.promote", "invalid_parameters": "discovery.describe; bind context.project_id; use env_uuid in generation sandbox", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_required": "Pass patch or config with at least one KnowledgeConfig field", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch one knowledge config key — prefer leaf paths over full blob. One heavy key per sync execute: full gene_pack OR product_id_map, not both.", "write_mode": null}, {"action": "knowledge.policy_templates.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.policy_templates.list", "related_tools": ["knowledge.policy_templates.apply", "knowledge.prompt.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Policy Templates List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover safety/policy templates before apply."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.policy_templates.list", "related_tools": ["knowledge.policy_templates.apply", "knowledge.prompt.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Policy Templates List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover safety/policy templates before apply."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Discover safety/policy templates before apply.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.policy_templates.apply", "knowledge.prompt.get"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_policy_templates_list", "semantic_input_mode": "inherit_workflow", "summary": "Platform policy templates (synthesis / crisis / situational needles / gate). Same catalog as GET /knowledge/policy-templates. Apply writes 8DNA via existing prompt+config PATCH — not a second bus.", "title": "Knowledge Policy Templates List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover safety/policy templates before apply.", "write_mode": null}, {"action": "knowledge.policy_templates.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.policy_templates.status", "related_tools": ["knowledge.policy_templates.list", "knowledge.policy_templates.apply", "knowledge.prompt.get", "knowledge.config.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Policy Templates Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.health — confirm project scope before status read", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read which policy templates are active on project."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.policy_templates.status", "related_tools": ["knowledge.policy_templates.list", "knowledge.policy_templates.apply", "knowledge.prompt.get", "knowledge.config.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Policy Templates Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.health — confirm project scope before status read", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read which policy templates are active on project."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read which policy templates are active on project.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.policy_templates.list", "knowledge.policy_templates.apply", "knowledge.prompt.get", "knowledge.config.get"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_policy_templates_status", "semantic_input_mode": "inherit_workflow", "summary": "Read-only policy snapshot: synthesis [policy:id] markers in plan_instructions, playbook ids, gate mode, situational needle count. Same as GET /knowledge/policy-templates/status.", "title": "Knowledge Policy Templates Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.health — confirm project scope before status read", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read which policy templates are active on project.", "write_mode": null}, {"action": "knowledge.policy_templates.apply", "ai_tips": "Default slots = all slots on the template. Re-apply is a no-op (skipped). Do not put program track names in Core — templates are generic; Unity stays in tenant Plan. knowledge.prompt.patch omit-unset is still keys-only.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Inventing a second policy service or full-blob DNA write.", "anti_patterns": ["Inventing a second policy service or full-blob DNA write.", "Sending Unity program nouns as a new Core template."], "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.policy_templates.apply", "mutation_risk": "low", "related_tools": ["knowledge.policy_templates.list", "knowledge.config.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Policy Templates Apply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before policy apply", "invalid_parameters": "discovery.describe; bind context.project_id; pass template_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "slots_empty": "Omit slots or pick synthesis|crisis|situational|gate from list row", "template_id_required": "Pass template_id from knowledge.policy_templates.list", "unknown_template": "knowledge.policy_templates.list — use a catalog template_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply curated policy template slots to project config."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.policy_templates.apply", "mutation_risk": "low", "related_tools": ["knowledge.policy_templates.list", "knowledge.config.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Policy Templates Apply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before policy apply", "invalid_parameters": "discovery.describe; bind context.project_id; pass template_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "slots_empty": "Omit slots or pick synthesis|crisis|situational|gate from list row", "template_id_required": "Pass template_id from knowledge.policy_templates.list", "unknown_template": "knowledge.policy_templates.list — use a catalog template_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply curated policy template slots to project config."}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Apply curated policy template slots to project config.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "body", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.policy_templates.list", "knowledge.config.patch"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_policy_templates_apply", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Apply a platform policy template onto the tenant: plan_instructions append (marker [policy:id]), merge crisis match_any (keep tenant template), union gene_pack.situational_needles, optional safety_fai", "title": "Knowledge Policy Templates Apply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before policy apply", "invalid_parameters": "discovery.describe; bind context.project_id; pass template_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "slots_empty": "Omit slots or pick synthesis|crisis|situational|gate from list row", "template_id_required": "Pass template_id from knowledge.policy_templates.list", "unknown_template": "knowledge.policy_templates.list — use a catalog template_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply curated policy template slots to project config.", "write_mode": null}, {"action": "knowledge.journal.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.journal.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Journal List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier before journal reads", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit mentor turn journal — support escalations and replay triage."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.journal.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Journal List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier before journal reads", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit mentor turn journal — support escalations and replay triage."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Audit mentor turn journal — support escalations and replay triage.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_journal_list", "semantic_input_mode": "inherit_workflow", "summary": "Mentor journal turns. Default 50, server max 200. No cursor.", "title": "Knowledge Journal List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier before journal reads", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit mentor turn journal — support escalations and replay triage.", "write_mode": null}, {"action": "knowledge.eval.run_all", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.eval.run_all", "related_tools": ["knowledge.eval.run", "knowledge.eval.retrieval", "knowledge.acceptance.run", "knowledge.health", "generation.gates", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Eval Run All", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eval_failed": "data.eval_passed false — read harness sections; not transport success", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before run_all", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run full platform eval harness (hit-rate gate before promote)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.eval.run_all", "related_tools": ["knowledge.eval.run", "knowledge.eval.retrieval", "knowledge.acceptance.run", "knowledge.health", "generation.gates", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Eval Run All", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eval_failed": "data.eval_passed false — read harness sections; not transport success", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before run_all", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run full platform eval harness (hit-rate gate before promote)."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "instruction_hint": "Run full platform eval harness (hit-rate gate before promote).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.eval.run", "knowledge.eval.retrieval", "knowledge.acceptance.run", "knowledge.health", "generation.gates", "generation.promote"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_eval_run_all", "semantic_input_mode": "inherit_workflow", "summary": "Full platform eval harness (safety + retrieval + readback).", "title": "Knowledge Eval Run All", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eval_failed": "data.eval_passed false — read harness sections; not transport success", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before run_all", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run full platform eval harness (hit-rate gate before promote).", "write_mode": null}, {"action": "knowledge.health", "aliases": ["knowledge.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.health", "related_tools": ["preflight.check", "knowledge.kb.ingest", "knowledge.config.get", "knowledge.config.patch", "generation.diff_vs_prod", "knowledge.eval.run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Knowledge plane health before ingest or playground."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.health", "related_tools": ["preflight.check", "knowledge.kb.ingest", "knowledge.config.get", "knowledge.config.patch", "generation.diff_vs_prod", "knowledge.eval.run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Knowledge plane health before ingest or playground."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Preflight KB empty", "request": {"params": {"project_id": 1}, "tool": "knowledge.health"}, "response": {"data": {"kb_empty": true, "ready": false}, "success": true}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts."}, "instruction_hint": "Knowledge plane health before ingest or playground.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT", "KNOWLEDGE_TENANT_EDIT_LADDER", "GENERATION_SAFE_CYCLE_LADDER"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["preflight.check", "knowledge.kb.ingest", "knowledge.config.get", "knowledge.config.patch", "generation.diff_vs_prod", "knowledge.eval.run"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_health", "semantic_input_mode": "inherit_workflow", "summary": "Knowledge plane health snapshot before ingest or playground. instruction_slice and recovery_hint use context.locale / instruction_locale.", "title": "Knowledge Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Knowledge plane health before ingest or playground.", "write_mode": null}, {"action": "knowledge.content.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.content.list", "related_tools": ["knowledge.content.get", "knowledge.kb.ingest", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Content List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Page operator KB documents. Each item's text is the joined body of this fetch, not a preview."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.content.list", "related_tools": ["knowledge.content.get", "knowledge.kb.ingest", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Content List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Page operator KB documents. Each item's text is the joined body of this fetch, not a preview."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Default collection", "request": {"params": {"collection_id": "knowledge_kb", "project_id": 1}, "tool": "knowledge.content.list"}, "response": {"data": {"items": []}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Page operator KB documents. Each item's text is the joined body of this fetch, not a preview.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.content.get", "knowledge.kb.ingest", "discovery.describe"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_content_list", "semantic_input_mode": "inherit_workflow", "summary": "Page operator KB documents (default 50). Each item includes title, source_doc_id, chunk_count, and joined text from this fetch (at most 2000 chunks), not an unbounded document.", "title": "Knowledge Content List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Page operator KB documents. Each item's text is the joined body of this fetch, not a preview.", "write_mode": null}, {"action": "knowledge.content.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.content.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Content Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "document_not_found": "knowledge.content.list — fix source_doc_id or collection_id", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_doc_id_required": "Pass source_doc_id from knowledge.content.list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "The joined body comes back whole until 64000 characters. Pass offset only when truncated is true, before content.patch replace."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.content.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Content Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "document_not_found": "knowledge.content.list — fix source_doc_id or collection_id", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_doc_id_required": "Pass source_doc_id from knowledge.content.list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "The joined body comes back whole until 64000 characters. Pass offset only when truncated is true, before content.patch replace."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "The joined body comes back whole until 64000 characters. Pass offset only when truncated is true, b…", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_content_get", "semantic_input_mode": "inherit_workflow", "summary": "Get one KB document by source_doc_id. text is a character window only past the compact envelope (64000). Concatenate windows before a replace. One window is not the document. text_chars is the full jo", "title": "Knowledge Content Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "document_not_found": "knowledge.content.list — fix source_doc_id or collection_id", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_doc_id_required": "Pass source_doc_id from knowledge.content.list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "The joined body comes back whole until 64000 characters. Pass offset only when truncated is true, before content.patch replace.", "write_mode": null}, {"action": "knowledge.content.patch", "ai_tips": "A known substring: write_mode=search_replace and replacements [{find, replace}]. A hunk from a diff: write_mode=unified_diff and unified_diff (fuzzy if context drifts). Full replace: GET first. Truncated body → content_shrink_blocked; allow_shrink=true only when the shorter body is intentional. See GET /mcp/actions write_modes and prompt agentstack_write_modes.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Sending one H2 as text without write_mode=append — that used to wipe the rest of the card.", "anti_patterns": ["Sending one H2 as text without write_mode=append — that used to wipe the rest of the card.", "Skipping knowledge.content.get and inventing a shorter full body.", "Using write_mode=merge on markdown (unsupported; use append or get+replace)."], "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.content.patch", "mutation_risk": "low", "related_tools": ["knowledge.content.get", "knowledge.content.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Content Patch", "when_blocked": {"ambiguous_anchor": "Multiple find matches — set count or use a longer unique find", "anchor_not_found": "knowledge.content.get — confirm find/where against joined text", "content_shrink_blocked": "Use search_replace or allow_shrink=true for a shorter body", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "document_not_found": "knowledge.content.list — fix source_doc_id", "empty_patch": "Pass patch.text or metadata fields", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "project_id, source_doc_id, or patch shape invalid", "invalid_patch": "Pass patch.text, replacements, unified_diff, or metadata fields", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "metadata_patch_failed": "Retry metadata-only fields or knowledge.kb.ingest; check RAG/index health", "patch_apply_failed": "Re-read body; retry unified_diff or strict_diff=true", "patch_too_large": "Shorter unified_diff or search_replace", "replacement_not_found": "GET content.get — find string not in joined document", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_doc_id_and_patch_required": "source_doc_id + patch object required", "text_anchor_miss": "Narrow find or GET body before unified_diff", "text_revision_conflict": "dry_run again or GET body — commit with previous_sha256 as expected_sha256", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "Use BODY_WRITE_MODE_ENUM values on write_mode param", "write_mode_unsupported": "Body text: append|prepend|search_replace|unified_diff|replace — not merge"}, "when_to_use": "Change a known sentence with search_replace (no GET). Append a section, or replace the whole body after content.get. Body commit with CAS: dry_run first (previous_sha256 + next_actions), then commit w"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.content.patch", "mutation_risk": "low", "related_tools": ["knowledge.content.get", "knowledge.content.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Content Patch", "when_blocked": {"ambiguous_anchor": "Multiple find matches — set count or use a longer unique find", "anchor_not_found": "knowledge.content.get — confirm find/where against joined text", "content_shrink_blocked": "Use search_replace or allow_shrink=true for a shorter body", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "document_not_found": "knowledge.content.list — fix source_doc_id", "empty_patch": "Pass patch.text or metadata fields", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "project_id, source_doc_id, or patch shape invalid", "invalid_patch": "Pass patch.text, replacements, unified_diff, or metadata fields", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "metadata_patch_failed": "Retry metadata-only fields or knowledge.kb.ingest; check RAG/index health", "patch_apply_failed": "Re-read body; retry unified_diff or strict_diff=true", "patch_too_large": "Shorter unified_diff or search_replace", "replacement_not_found": "GET content.get — find string not in joined document", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_doc_id_and_patch_required": "source_doc_id + patch object required", "text_anchor_miss": "Narrow find or GET body before unified_diff", "text_revision_conflict": "dry_run again or GET body — commit with previous_sha256 as expected_sha256", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "Use BODY_WRITE_MODE_ENUM values on write_mode param", "write_mode_unsupported": "Body text: append|prepend|search_replace|unified_diff|replace — not merge"}, "when_to_use": "Change a known sentence with search_replace (no GET). Append a section, or replace the whole body after content.get. Body commit with CAS: dry_run first (previous_sha256 + next_actions), then commit w"}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Change a known sentence with search_replace (no GET). Append a section, or replace the whole body a…", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT", "KNOWLEDGE_CONTENT_PATCH_DRY_RUN"], "mutation_kind": "body", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.content.get", "knowledge.content.list"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_content_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch a KB document: metadata (title, gene_stems, …) and/or body. Body write_mode is replace, append, prepend, search_replace, or unified_diff (fuzzy, same editor as App Studio source.patch). Same as ", "title": "Knowledge Content Patch", "when_blocked": {"ambiguous_anchor": "Multiple find matches — set count or use a longer unique find", "anchor_not_found": "knowledge.content.get — confirm find/where against joined text", "content_shrink_blocked": "Use search_replace or allow_shrink=true for a shorter body", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "document_not_found": "knowledge.content.list — fix source_doc_id", "empty_patch": "Pass patch.text or metadata fields", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "project_id, source_doc_id, or patch shape invalid", "invalid_patch": "Pass patch.text, replacements, unified_diff, or metadata fields", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "metadata_patch_failed": "Retry metadata-only fields or knowledge.kb.ingest; check RAG/index health", "patch_apply_failed": "Re-read body; retry unified_diff or strict_diff=true", "patch_too_large": "Shorter unified_diff or search_replace", "replacement_not_found": "GET content.get — find string not in joined document", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_doc_id_and_patch_required": "source_doc_id + patch object required", "text_anchor_miss": "Narrow find or GET body before unified_diff", "text_revision_conflict": "dry_run again or GET body — commit with previous_sha256 as expected_sha256", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "Use BODY_WRITE_MODE_ENUM values on write_mode param", "write_mode_unsupported": "Body text: append|prepend|search_replace|unified_diff|replace — not merge"}, "when_to_use": "Change a known sentence with search_replace (no GET). Append a section, or replace the whole body after content.get. Body commit with CAS: dry_run first (previous_sha256 + next_actions), then commit w", "write_mode": ["replace", "write", "append", "prepend", "search_replace", "unified_diff"], "write_mode_note": "text is a full body unless write_mode=append|prepend. GET the document first; shrinking a long body needs allow_shrink=true. SDK Studio sets allow_shrink for operator save — AI must GET first."}, {"action": "knowledge.chunk.patch", "ai_tips": "replacements [{find, replace}] on the assembled document — no GET when the phrase is known. Or pass text to replace only this chunk's segment (legacy replace).", "aliases": ["knowledge.chunk.text.patch", "knowledge.kb.chunk.patch"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Using chunk.patch when source_doc_id is known — content.patch is the document SoT.", "anti_patterns": ["Using chunk.patch when source_doc_id is known — content.patch is the document SoT.", "Sending a truncated chunk window as full text without allow_shrink."], "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.chunk.patch", "mutation_risk": "low", "related_tools": ["knowledge.content.get", "knowledge.content.patch", "knowledge.content.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Chunk Patch", "when_blocked": {"ambiguous_anchor": "Multiple find matches — set count or use a longer unique find", "chunk_not_found": "knowledge.content.get — verify chunks[].doc_id", "content_shrink_blocked": "Prefer replacements; allow_shrink only when intentional", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "invalid_patch": "Pass text, replacements, or unified_diff", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "unified_diff missed the parent document — GET content and retry", "patch_too_large": "Shorter unified_diff or search_replace on the parent body", "replacement_not_found": "Phrase missing from joined parent document", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "Use BODY_WRITE_MODE_ENUM values on write_mode param", "write_mode_unsupported": "Parent body: append|prepend|search_replace|unified_diff|replace — not merge"}, "when_to_use": "You have a chunk doc_id from content.get chunks[] and need a phrase fix without source_doc_id routing. Prefer knowledge.content.patch when you already have source_doc_id."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.chunk.patch", "mutation_risk": "low", "related_tools": ["knowledge.content.get", "knowledge.content.patch", "knowledge.content.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Chunk Patch", "when_blocked": {"ambiguous_anchor": "Multiple find matches — set count or use a longer unique find", "chunk_not_found": "knowledge.content.get — verify chunks[].doc_id", "content_shrink_blocked": "Prefer replacements; allow_shrink only when intentional", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "invalid_patch": "Pass text, replacements, or unified_diff", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "unified_diff missed the parent document — GET content and retry", "patch_too_large": "Shorter unified_diff or search_replace on the parent body", "replacement_not_found": "Phrase missing from joined parent document", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "Use BODY_WRITE_MODE_ENUM values on write_mode param", "write_mode_unsupported": "Parent body: append|prepend|search_replace|unified_diff|replace — not merge"}, "when_to_use": "You have a chunk doc_id from content.get chunks[] and need a phrase fix without source_doc_id routing. Prefer knowledge.content.patch when you already have source_doc_id."}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "You have a chunk doc_id from content.get chunks[] and need a phrase fix without source_doc_id routi…", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "body", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.content.get", "knowledge.content.patch", "knowledge.content.list"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_chunk_patch", "semantic_input_mode": "inherit_workflow", "summary": "Patch one indexed chunk by chunk doc_id; re-ingests the parent document. search_replace / unified_diff apply to the full joined body (same editor as content.patch). REST: PATCH /knowledge/kb/chunks/{d", "title": "Knowledge Chunk Patch", "when_blocked": {"ambiguous_anchor": "Multiple find matches — set count or use a longer unique find", "chunk_not_found": "knowledge.content.get — verify chunks[].doc_id", "content_shrink_blocked": "Prefer replacements; allow_shrink only when intentional", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "invalid_patch": "Pass text, replacements, or unified_diff", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "unified_diff missed the parent document — GET content and retry", "patch_too_large": "Shorter unified_diff or search_replace on the parent body", "replacement_not_found": "Phrase missing from joined parent document", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "Use BODY_WRITE_MODE_ENUM values on write_mode param", "write_mode_unsupported": "Parent body: append|prepend|search_replace|unified_diff|replace — not merge"}, "when_to_use": "You have a chunk doc_id from content.get chunks[] and need a phrase fix without source_doc_id routing. Prefer knowledge.content.patch when you already have source_doc_id.", "write_mode": ["replace", "write", "append", "prepend", "search_replace", "unified_diff"], "write_mode_note": "Chunk id from content.get; editor applies to parent document text."}, {"action": "knowledge.content.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.content.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Content Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "document_not_found": "Row missing — knowledge.content.list or already deleted", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_doc_id_required": "Pass source_doc_id from knowledge.content.list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove KB document by source_doc_id (irreversible)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.content.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Content Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "document_not_found": "Row missing — knowledge.content.list or already deleted", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_doc_id_required": "Pass source_doc_id from knowledge.content.list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove KB document by source_doc_id (irreversible)."}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Remove KB document by source_doc_id (irreversible).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": true, "risk_class": "destructive", "safe_action": "knowledge_content_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Deactivate or hard-delete a KB document by source_doc_id. Same as DELETE /knowledge/content/{id}.", "title": "Knowledge Content Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "document_not_found": "Row missing — knowledge.content.list or already deleted", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_doc_id_required": "Pass source_doc_id from knowledge.content.list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove KB document by source_doc_id (irreversible).", "write_mode": null}, {"action": "knowledge.registry.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.registry.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Registry List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List content registry entries before upsert."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.registry.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Registry List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List content registry entries before upsert."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List content registry entries before upsert.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_registry_list", "semantic_input_mode": "inherit_workflow", "summary": "List content registry entries before upsert.", "title": "Knowledge Registry List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List content registry entries before upsert.", "write_mode": null}, {"action": "knowledge.registry.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.registry.upsert", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Registry Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "entry_required": "Pass entry object or flat registry keys on knowledge.registry.upsert", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "registry payload shape — discovery.describe knowledge.registry.upsert", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Upsert registry metadata for FAQ/guide documents."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.registry.upsert", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Registry Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "entry_required": "Pass entry object or flat registry keys on knowledge.registry.upsert", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "registry payload shape — discovery.describe knowledge.registry.upsert", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Upsert registry metadata for FAQ/guide documents."}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Upsert registry metadata for FAQ/guide documents.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_registry_upsert", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Upsert registry metadata for FAQ/guide documents.", "title": "Knowledge Registry Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "entry_required": "Pass entry object or flat registry keys on knowledge.registry.upsert", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "registry payload shape — discovery.describe knowledge.registry.upsert", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Upsert registry metadata for FAQ/guide documents.", "write_mode": null}, {"action": "knowledge.import", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.import", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Import", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "import_failed": "See data.errors[] — partial apply may need knowledge.health", "invalid_parameters": "bundle JSON shape — pair with knowledge.export for round-trip", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Import knowledge pack JSON into project scope."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.import", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Import", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "import_failed": "See data.errors[] — partial apply may need knowledge.health", "invalid_parameters": "bundle JSON shape — pair with knowledge.export for round-trip", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Import knowledge pack JSON into project scope."}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Import knowledge pack JSON into project scope.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"chunks": {"description": "Chunk rows ingested", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "grants": {"description": "Grant rows processed", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "ok": {"description": "Import finished", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "rollback": ["generation.realign_to_prod"], "safe_action": "knowledge_import", "semantic_input_mode": "inherit_workflow", "summary": "Import knowledge pack JSON into project scope.", "title": "Knowledge Import", "verification": ["knowledge.health", "knowledge.config.get"], "verify": [{"action": "knowledge.health", "predicate": "named resource is visible"}, {"action": "knowledge.config.get", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "import_failed": "See data.errors[] — partial apply may need knowledge.health", "invalid_parameters": "bundle JSON shape — pair with knowledge.export for round-trip", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Import knowledge pack JSON into project scope.", "write_mode": null}, {"action": "knowledge.gc.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.gc.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Gc Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "GC queue status before reconcile or bulk ingest cleanup."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.gc.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Gc Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "GC queue status before reconcile or bulk ingest cleanup."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "GC queue status before reconcile or bulk ingest cleanup.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_gc_status", "semantic_input_mode": "inherit_workflow", "summary": "GC queue status before reconcile or bulk ingest cleanup.", "title": "Knowledge Gc Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "GC queue status before reconcile or bulk ingest cleanup.", "write_mode": null}, {"action": "knowledge.gc.reconcile", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.gc.reconcile", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Gc Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enqueue principal/GetCourse GC reconcile (async heavy job)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.gc.reconcile", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Gc Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enqueue principal/GetCourse GC reconcile (async heavy job)."}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Enqueue principal/GetCourse GC reconcile (async heavy job).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": true, "risk_class": "destructive", "safe_action": "knowledge_gc_reconcile", "semantic_input_mode": "inherit_workflow", "summary": "Enqueue principal/GetCourse GC reconcile (async heavy job).", "title": "Knowledge Gc Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enqueue principal/GetCourse GC reconcile (async heavy job).", "write_mode": null}, {"action": "knowledge.playground", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Using rag.search alone for mentor answer QA (skips gene_pack / Plan).", "anti_patterns": ["Using rag.search alone for mentor answer QA (skips gene_pack / Plan).", "Do not run fabula 12/12 batch through knowledge.playground — use bots.simulate."], "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "heavy_llm", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "heavy", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.playground", "recovery_blocks": {"orchestrator_binding_stale": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "orchestrator_binding_stale"}}, "related_tools": ["bots.simulate", "knowledge.config.get", "knowledge.prompt.get"], "semantic_input_mode": "per_step_nl", "source": "handler", "title": "Knowledge Playground", "when_blocked": {"agent_not_found": "default_playground_bot_uuid + bots.set_brain agent binding", "bot_not_found": "bots.get — playground bot_id missing on project slice", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "corpus_empty": "Ingest on Knowledge → Content; run knowledge.eval.retrieval smoke first", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "text required unless action=capabilities|skill_preview", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "knowledge_collections_unavailable": "Retry once; verify collection_id exists", "knowledge_entitlement_denied": "Run knowledge.doctor.run; check project tier", "mcp_async_worker_unavailable": "process_role=api without worker — retry sync (no options.async)", "orchestrator_binding_stale": "bots.set_brain refresh agent_uuid after fleet edits", "orchestrator_failed": "Worker/API traceback — read data.detail and data.exc_type on simulate", "registry_miss": "data.synthesis_path registry_catalog_link|registry_nav — knowledge.registry.list + knowledge.retrieve.probe", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wrong_tier_or_product": "knowledge.principal.simulate — inspect context.product_ids; knowledge.access.grant or GetCourse reconcile if mismatch"}, "when_to_use": "Full mentor simulate with RAG/safety/gene-lock trace — one heavy_llm per sync execute. Preflight: action=capabilities (no text). Ladder: knowledge.principal.simulate → text + principal_user_id; read s"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "heavy_llm", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "heavy", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.playground", "recovery_blocks": {"orchestrator_binding_stale": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "orchestrator_binding_stale"}}, "related_tools": ["bots.simulate", "knowledge.config.get", "knowledge.prompt.get"], "semantic_input_mode": "per_step_nl", "source": "handler", "title": "Knowledge Playground", "when_blocked": {"agent_not_found": "default_playground_bot_uuid + bots.set_brain agent binding", "bot_not_found": "bots.get — playground bot_id missing on project slice", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "corpus_empty": "Ingest on Knowledge → Content; run knowledge.eval.retrieval smoke first", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "text required unless action=capabilities|skill_preview", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "knowledge_collections_unavailable": "Retry once; verify collection_id exists", "knowledge_entitlement_denied": "Run knowledge.doctor.run; check project tier", "mcp_async_worker_unavailable": "process_role=api without worker — retry sync (no options.async)", "orchestrator_binding_stale": "bots.set_brain refresh agent_uuid after fleet edits", "orchestrator_failed": "Worker/API traceback — read data.detail and data.exc_type on simulate", "registry_miss": "data.synthesis_path registry_catalog_link|registry_nav — knowledge.registry.list + knowledge.retrieve.probe", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wrong_tier_or_product": "knowledge.principal.simulate — inspect context.product_ids; knowledge.access.grant or GetCourse reconcile if mismatch"}, "when_to_use": "Full mentor simulate with RAG/safety/gene-lock trace — one heavy_llm per sync execute. Preflight: action=capabilities (no text). Ladder: knowledge.principal.simulate → text + principal_user_id; read s"}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "conditional_mutate": "action=capabilities | skill_preview | plan_affinity_preview = read-only probes (no LLM); plan_suggest without use_llm is cheap. Default simulate holds ai_stream up to ~180s — one heavy_llm per sync MCP batch; prefer options.async=true + discovery.job_status on busy hosts.", "effect_depends_on_params": true, "execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "effect_kind": "read", "examples": [{"name": "Capabilities preflight (no LLM)", "request": {"params": {"action": "capabilities", "project_id": 1}, "tool": "knowledge.playground"}, "response": {"data": {"mode": "capabilities"}, "success": true}}, {"name": "Mentor turn with principal (entitlement trace)", "request": {"params": {"principal_user_id": 12345, "project_id": 1444, "text": "Где урок про …?"}, "tool": "knowledge.playground"}, "response": {"data": {"context": {"product_ids": ["sku-1"]}, "synthesis_path": "registry_catalog_link"}, "success": true}}, {"name": "1444 free fabula named nav (playground trace)", "request": {"params": {"bot_uuid": "a1f4c56a-5d66-40e0-8de8-68cba1d520a6", "external_user_id": "fabula-baseline-a11", "principal_user_id": 1, "project_id": 1444, "text": "Где скачать Фабулу Любви к себе?"}, "tool": "knowledge.playground"}, "response": {"data": {"reply": "…lesson/view?id=345047850#a11…", "synthesis_path": "registry_named_exact"}, "success": true}}], "execution_class": "heavy", "instruction_hint": "Full mentor simulate with RAG/safety/gene-lock trace — one heavy_llm per sync execute. Preflight: a…", "knowledge_atoms": ["KNOWLEDGE_PLAYGROUND_HEAVY", "KNOWLEDGE_PLAYGROUND_VS_BOTS"], "mutation_kind": "none", "next_actions": [{"action": "discovery.job_status", "note": "Poll until completed or failed; do not re-run simulate to check status.", "params": {"job_id": "<job_id from async execute receipt>"}}], "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"abstain_reason": {"description": "Mentor abstain reason when present", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "access_tier": {"description": "Effective entitlement tier", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "citation_applied": {"description": "Lightweight citation marker in reply", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "citations": {"description": "RAG citation objects", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "correlation_id": {"description": "Turn or request correlation id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "error": {"description": "Machine code when ok=false (orchestrator_failed, bot_not_found, …)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "evidence_snippet_count": {"description": "RAG snippets surfaced count", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "glossary_rewrite_applied": {"description": "Post-reply glossary rewrite ran", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "mode": {"description": "capabilities | skill_preview | plan_suggest when action set", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "model": {"description": "LLM model id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "ok": {"description": "Simulate succeeded (false when orchestrator or policy refused)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "rag": {"description": "RAG debug object (snippets under rag.snippets)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "rag_snippets": {"description": "Flat RAG snippet strings", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "raw_grounded_message": {"description": "Message before glossary rewrite", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "recommend_attached_count": {"description": "Recommend blocks attached (turn_trace)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "recommend_match_keys": {"description": "Recommend matcher keys", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "refused": {"description": "Policy or RAG refusal flag", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "reply": {"description": "Primary assistant reply text", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "safety": {"description": "Safety classifier outcome", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "synthesis_path": {"description": "Router branch id (e.g. registry_named_exact for free fabula #aN nav)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "text": {"description": "Alias of reply", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "trace": {"description": "Full orchestrator simulate payload", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "turn_trace": {"description": "Mentor/RAG trace for QA", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "knowledge.playground is heavy_llm — one per sync execute. Entitlement errors: knowledge.doctor.run before bulk ingest. Corrections: knowledge.correction.propose then acceptance gates.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["bots.simulate", "knowledge.config.get", "knowledge.prompt.get"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_playground", "semantic_input_mode": "per_step_nl", "summary": "Full bot simulate with RAG/safety/gene-lock trace (REST playground). Heavy LLM: one per sync agentstack.execute. Prefer over raw rag.search for mentor fidelity. Same budget as bots.simulate. instructi", "title": "Knowledge Playground", "when_blocked": {"agent_not_found": "default_playground_bot_uuid + bots.set_brain agent binding", "bot_not_found": "bots.get — playground bot_id missing on project slice", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "corpus_empty": "Ingest on Knowledge → Content; run knowledge.eval.retrieval smoke first", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "text required unless action=capabilities|skill_preview", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "knowledge_collections_unavailable": "Retry once; verify collection_id exists", "knowledge_entitlement_denied": "Run knowledge.doctor.run; check project tier", "mcp_async_worker_unavailable": "process_role=api without worker — retry sync (no options.async)", "orchestrator_binding_stale": "bots.set_brain refresh agent_uuid after fleet edits", "orchestrator_failed": "Worker/API traceback — read data.detail and data.exc_type on simulate", "registry_miss": "data.synthesis_path registry_catalog_link|registry_nav — knowledge.registry.list + knowledge.retrieve.probe", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wrong_tier_or_product": "knowledge.principal.simulate — inspect context.product_ids; knowledge.access.grant or GetCourse reconcile if mismatch"}, "when_to_use": "Full mentor simulate with RAG/safety/gene-lock trace — one heavy_llm per sync execute. Preflight: action=capabilities (no text). Ladder: knowledge.principal.simulate → text + principal_user_id; read s", "write_mode": null}, {"action": "knowledge.principal.simulate", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.principal.simulate", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Principal Simulate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read effective tier and context.product_ids before knowledge.playground — no LLM. Optional product_id simulates paid-SKU gate downgrade."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.principal.simulate", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Principal Simulate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read effective tier and context.product_ids before knowledge.playground — no LLM. Optional product_id simulates paid-SKU gate downgrade."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read effective tier and context.product_ids before knowledge.playground — no LLM. Optional product_…", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_principal_simulate", "semantic_input_mode": "inherit_workflow", "summary": "Read effective tier and context.product_ids before knowledge.playground — no LLM. Optional product_id simulates paid-SKU gate downgrade.", "title": "Knowledge Principal Simulate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read effective tier and context.product_ids before knowledge.playground — no LLM. Optional product_id simulates paid-SKU gate downgrade.", "write_mode": null}, {"action": "knowledge.project_ai_keys.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.project_ai_keys.patch", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Project Ai Keys Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rotate project-scoped AI provider keys (protected leaf)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.project_ai_keys.patch", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Project Ai Keys Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rotate project-scoped AI provider keys (protected leaf)."}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Rotate project-scoped AI provider keys (protected leaf).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_project_ai_keys_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch tenant project AI keys in project.protected (KeySelector). Same storage as PUT /api/projects/{id}/ai-keys — no secret values in GET.", "title": "Knowledge Project Ai Keys Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rotate project-scoped AI provider keys (protected leaf).", "write_mode": null}, {"action": "knowledge.project_ai_keys.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.project_ai_keys.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Project Ai Keys Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read AI key binding status without exposing secrets."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.project_ai_keys.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Project Ai Keys Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read AI key binding status without exposing secrets."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read AI key binding status without exposing secrets.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_project_ai_keys_status", "semantic_input_mode": "inherit_workflow", "summary": "AI key presence + ai_settings flags (no secret values).", "title": "Knowledge Project Ai Keys Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read AI key binding status without exposing secrets.", "write_mode": null}, {"action": "knowledge.project_secrets.apply", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.project_secrets.apply", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Project Secrets Apply", "when_blocked": {"apply_partial_failure": "Inspect data report steps (openai, getcourse, max, telegram, knowledge_config, product_id_map); knowledge_config soft_fail does not roll back Hub/protected keys", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_secrets_provided": "Pass at least one of openai, getcourse, max, telegram, telegram2, product_id_map_json", "preflight_blocked": "preflight.check action=knowledge.project_secrets.apply — bind context.project_id; read blockers[] (RBAC, FAP, supply, service_cap_denied)", "project_id_required": "Bind context.project_id before knowledge.project_secrets.apply", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply encrypted project secrets bundle (ops migration). Sole helper bot on 1444: pass telegram2 + telegram2_bot_uuid + telegram2_connection_slug (not telegram alone on legacy primary UUID)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.project_secrets.apply", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Project Secrets Apply", "when_blocked": {"apply_partial_failure": "Inspect data report steps (openai, getcourse, max, telegram, knowledge_config, product_id_map); knowledge_config soft_fail does not roll back Hub/protected keys", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_secrets_provided": "Pass at least one of openai, getcourse, max, telegram, telegram2, product_id_map_json", "preflight_blocked": "preflight.check action=knowledge.project_secrets.apply — bind context.project_id; read blockers[] (RBAC, FAP, supply, service_cap_denied)", "project_id_required": "Bind context.project_id before knowledge.project_secrets.apply", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply encrypted project secrets bundle (ops migration). Sole helper bot on 1444: pass telegram2 + telegram2_bot_uuid + telegram2_connection_slug (not telegram alone on legacy primary UUID)."}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Apply encrypted project secrets bundle (ops migration). Sole helper bot on 1444: pass telegram2 + t…", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": true, "risk_class": "low_write", "safe_action": "knowledge_project_secrets_apply", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Apply Unity tenant secrets: OpenAI → project.protected; GetCourse/MAX/Telegram → Integration Hub protected (telegram → wire_unity_telegram). Pass openai/getcourse/max/telegram[/telegram2] and optional", "title": "Knowledge Project Secrets Apply", "when_blocked": {"apply_partial_failure": "Inspect data report steps (openai, getcourse, max, telegram, knowledge_config, product_id_map); knowledge_config soft_fail does not roll back Hub/protected keys", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_secrets_provided": "Pass at least one of openai, getcourse, max, telegram, telegram2, product_id_map_json", "preflight_blocked": "preflight.check action=knowledge.project_secrets.apply — bind context.project_id; read blockers[] (RBAC, FAP, supply, service_cap_denied)", "project_id_required": "Bind context.project_id before knowledge.project_secrets.apply", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply encrypted project secrets bundle (ops migration). Sole helper bot on 1444: pass telegram2 + telegram2_bot_uuid + telegram2_connection_slug (not telegram alone on legacy primary UUID).", "write_mode": null}, {"action": "knowledge.journal.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.journal.get", "related_tools": ["knowledge.journal.list", "knowledge.correction.propose", "knowledge.playground"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Journal Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "correlation_id_or_turn_id_required": "Pass correlation_id or turn_id from journal.list", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before journal reads", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "turn_not_found": "knowledge.journal.list — pick correlation_id from recent turns", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fetch one mentor journal turn by correlation_id or turn_id for diagnose/correction."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.journal.get", "related_tools": ["knowledge.journal.list", "knowledge.correction.propose", "knowledge.playground"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Journal Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "correlation_id_or_turn_id_required": "Pass correlation_id or turn_id from journal.list", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before journal reads", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "turn_not_found": "knowledge.journal.list — pick correlation_id from recent turns", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fetch one mentor journal turn by correlation_id or turn_id for diagnose/correction."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Diagnose by correlation_id", "request": {"params": {"correlation_id": "corr-abc", "project_id": 1}, "tool": "knowledge.journal.get"}, "response": {"data": {"turn_id": "…"}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Fetch one mentor journal turn by correlation_id or turn_id for diagnose/correction.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.journal.list", "knowledge.correction.propose", "knowledge.playground"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_journal_get", "semantic_input_mode": "inherit_workflow", "summary": "Fetch one mentor journal turn by correlation_id or turn_id for diagnose/correction.", "title": "Knowledge Journal Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "correlation_id_or_turn_id_required": "Pass correlation_id or turn_id from journal.list", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before journal reads", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "turn_not_found": "knowledge.journal.list — pick correlation_id from recent turns", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fetch one mentor journal turn by correlation_id or turn_id for diagnose/correction.", "write_mode": null}, {"action": "knowledge.correction.propose", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.correction.propose", "related_tools": ["knowledge.journal.get", "knowledge.config.patch", "knowledge.acceptance.case.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Correction Propose", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Draft correction steps from a journal turn — NO auto-write."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.correction.propose", "related_tools": ["knowledge.journal.get", "knowledge.config.patch", "knowledge.acceptance.case.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Correction Propose", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Draft correction steps from a journal turn — NO auto-write."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Draft correction steps from a journal turn — NO auto-write.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "knowledge.playground is heavy_llm — one per sync execute. Entitlement errors: knowledge.doctor.run before bulk ingest. Corrections: knowledge.correction.propose then acceptance gates.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.journal.get", "knowledge.config.patch", "knowledge.acceptance.case.upsert"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_correction_propose", "semantic_input_mode": "inherit_workflow", "summary": "Draft correction steps from a journal turn — NO auto-write.", "title": "Knowledge Correction Propose", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Draft correction steps from a journal turn — NO auto-write.", "write_mode": null}, {"action": "knowledge.acceptance.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.acceptance.list", "related_tools": ["knowledge.acceptance.run", "knowledge.acceptance.case.run", "knowledge.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Acceptance List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List built-in acceptance fixture suites before knowledge.acceptance.run."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.acceptance.list", "related_tools": ["knowledge.acceptance.run", "knowledge.acceptance.case.run", "knowledge.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Acceptance List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List built-in acceptance fixture suites before knowledge.acceptance.run."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List built-in acceptance fixture suites before knowledge.acceptance.run.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.acceptance.run", "knowledge.acceptance.case.run", "knowledge.health"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_acceptance_list", "semantic_input_mode": "inherit_workflow", "summary": "List built-in acceptance fixture suites before knowledge.acceptance.run.", "title": "Knowledge Acceptance List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List built-in acceptance fixture suites before knowledge.acceptance.run.", "write_mode": null}, {"action": "knowledge.acceptance.run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.acceptance.run", "related_tools": ["knowledge.acceptance.list", "knowledge.acceptance.case.run", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Acceptance Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run acceptance suite (rule-based; eval_mode=retrieval avoids LLM)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.acceptance.run", "related_tools": ["knowledge.acceptance.list", "knowledge.acceptance.case.run", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Acceptance Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run acceptance suite (rule-based; eval_mode=retrieval avoids LLM)."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "instruction_hint": "Run acceptance suite (rule-based; eval_mode=retrieval avoids LLM).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.acceptance.list", "knowledge.acceptance.case.run", "generation.promote"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_acceptance_run", "semantic_input_mode": "inherit_workflow", "summary": "Run built-in or tenant acceptance suite; gate on data.eval_passed.", "title": "Knowledge Acceptance Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run acceptance suite (rule-based; eval_mode=retrieval avoids LLM).", "write_mode": null}, {"action": "knowledge.acceptance.case.run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.acceptance.case.run", "related_tools": ["knowledge.acceptance.run", "knowledge.acceptance.list", "generation.gates"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Acceptance Case Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run one acceptance case by id from a suite."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.acceptance.case.run", "related_tools": ["knowledge.acceptance.run", "knowledge.acceptance.list", "generation.gates"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Acceptance Case Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run one acceptance case by id from a suite."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "instruction_hint": "Run one acceptance case by id from a suite.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.acceptance.run", "knowledge.acceptance.list", "generation.gates"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_acceptance_case_run", "semantic_input_mode": "inherit_workflow", "summary": "Run one acceptance case; eval_passed mirrors harness ok.", "title": "Knowledge Acceptance Case Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run one acceptance case by id from a suite.", "write_mode": null}, {"action": "knowledge.acceptance.case.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.acceptance.case.upsert", "mutation_risk": "low", "related_tools": ["knowledge.acceptance.case.run", "knowledge.config.patch", "generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Acceptance Case Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append regression case to config.knowledge.acceptance_cases (merge, not replace)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.acceptance.case.upsert", "mutation_risk": "low", "related_tools": ["knowledge.acceptance.case.run", "knowledge.config.patch", "generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Acceptance Case Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append regression case to config.knowledge.acceptance_cases (merge, not replace)."}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Append regression case to config.knowledge.acceptance_cases (merge, not replace).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.acceptance.case.run", "knowledge.config.patch", "generation.diff_vs_prod"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_acceptance_case_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Append regression case to config.knowledge.acceptance_cases (merge, not replace).", "title": "Knowledge Acceptance Case Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append regression case to config.knowledge.acceptance_cases (merge, not replace).", "write_mode": null}, {"action": "knowledge.doctor.run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.doctor.run", "related_tools": ["knowledge.health", "knowledge.kb.ingest", "knowledge.config.get", "generation.diff_vs_prod", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Doctor Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "doctor_failed": "data.ok false — read checks{}; canonical_mentor_cards → knowledge.kb.ingest", "feature_not_available": "knowledge.health — confirm tier/buffs before doctor", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only mentor doctor for any project (gene pack + retrieval probe)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.doctor.run", "related_tools": ["knowledge.health", "knowledge.kb.ingest", "knowledge.config.get", "generation.diff_vs_prod", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Doctor Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "doctor_failed": "data.ok false — read checks{}; canonical_mentor_cards → knowledge.kb.ingest", "feature_not_available": "knowledge.health — confirm tier/buffs before doctor", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only mentor doctor for any project (gene pack + retrieval probe)."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "examples": [{"name": "Read-only preflight", "request": {"params": {"project_id": 1, "skip_retrieval": true}, "tool": "knowledge.doctor.run"}, "response": {"data": {"checks": {}, "ok": true}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Read-only mentor doctor for any project (gene pack + retrieval probe).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "knowledge.playground is heavy_llm — one per sync execute. Entitlement errors: knowledge.doctor.run before bulk ingest. Corrections: knowledge.correction.propose then acceptance gates.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.health", "knowledge.kb.ingest", "knowledge.config.get", "generation.diff_vs_prod", "preflight.check"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_doctor_run", "semantic_input_mode": "inherit_workflow", "summary": "Read-only mentor doctor for any project (gene pack + retrieval probe).", "title": "Knowledge Doctor Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "doctor_failed": "data.ok false — read checks{}; canonical_mentor_cards → knowledge.kb.ingest", "feature_not_available": "knowledge.health — confirm tier/buffs before doctor", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only mentor doctor for any project (gene pack + retrieval probe).", "write_mode": null}, {"action": "knowledge.retrieve.probe", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.retrieve.probe", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Retrieve Probe", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm collections entitlement before probe", "invalid_parameters": "Fix query shape or bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "query_required": "Pass non-empty query string", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hybrid retrieval probe (no LLM) — top doc_ids for a query."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.retrieve.probe", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Retrieve Probe", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm collections entitlement before probe", "invalid_parameters": "Fix query shape or bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "query_required": "Pass non-empty query string", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hybrid retrieval probe (no LLM) — top doc_ids for a query."}, "domain": "knowledge", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "examples": [{"name": "Top-k hybrid (no LLM)", "request": {"params": {"project_id": 1, "query": "refund policy", "top_k": 3}, "tool": "knowledge.retrieve.probe"}, "response": {"data": {"doc_ids": []}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Hybrid retrieval probe (no LLM) — top doc_ids for a query.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_retrieve_probe", "semantic_input_mode": "inherit_workflow", "summary": "Hybrid retrieval probe (no LLM) — top doc_ids for a query.", "title": "Knowledge Retrieve Probe", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm collections entitlement before probe", "invalid_parameters": "Fix query shape or bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "query_required": "Pass non-empty query string", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hybrid retrieval probe (no LLM) — top doc_ids for a query.", "write_mode": null}, {"action": "knowledge.phenotype.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.phenotype.upsert", "mutation_risk": "low", "related_tools": ["knowledge.config.get", "knowledge.retrieve.probe", "knowledge.gene_pack.pinned_shape.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Phenotype Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "generation_fork_required": "auto_generation_mode on — omit env_uuid for auto-fork on patch or pass sandbox anchor; then generation.diff_vs_prod → generation.gates → generation.promote", "invalid_parameters": "discovery.describe; bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "phenotype_name_required": "phenotype.name non-empty string required", "phenotype_required": "Pass phenotype object", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Partial gene_pack phenotype merge by name + compile_warnings (prefer over raw config.patch)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.phenotype.upsert", "mutation_risk": "low", "related_tools": ["knowledge.config.get", "knowledge.retrieve.probe", "knowledge.gene_pack.pinned_shape.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Phenotype Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "generation_fork_required": "auto_generation_mode on — omit env_uuid for auto-fork on patch or pass sandbox anchor; then generation.diff_vs_prod → generation.gates → generation.promote", "invalid_parameters": "discovery.describe; bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "phenotype_name_required": "phenotype.name non-empty string required", "phenotype_required": "Pass phenotype object", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Partial gene_pack phenotype merge by name + compile_warnings (prefer over raw config.patch)."}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "generation_atoms": {"GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts."}, "instruction_hint": "Partial gene_pack phenotype merge by name + compile_warnings (prefer over raw config.patch).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT", "KNOWLEDGE_TENANT_EDIT_LADDER", "GENERATION_SAFE_CYCLE_LADDER"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.config.get", "knowledge.retrieve.probe", "knowledge.gene_pack.pinned_shape.upsert"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_phenotype_upsert", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Single FAQ route / gene_pack row — merge by name; prefer over full gene_pack patch. Then knowledge.retrieve.probe; promote via generation.* when auto_generation_mode on.", "title": "Knowledge Phenotype Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "generation_fork_required": "auto_generation_mode on — omit env_uuid for auto-fork on patch or pass sandbox anchor; then generation.diff_vs_prod → generation.gates → generation.promote", "invalid_parameters": "discovery.describe; bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "phenotype_name_required": "phenotype.name non-empty string required", "phenotype_required": "Pass phenotype object", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Partial gene_pack phenotype merge by name + compile_warnings (prefer over raw config.patch).", "write_mode": null}, {"action": "knowledge.gene_pack.pinned_shape.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.gene_pack.pinned_shape.upsert", "mutation_risk": "low", "related_tools": ["knowledge.phenotype.upsert", "knowledge.config.get", "knowledge.retrieve.probe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Gene Pack Pinned Shape Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "generation_fork_required": "auto_generation_mode on — omit env_uuid for auto-fork on patch or pass sandbox anchor; then generation.diff_vs_prod → generation.gates → generation.promote", "invalid_parameters": "discovery.describe; bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "phenotype_name_required": "phenotype.name non-empty string required", "phenotype_required": "Pass phenotype object", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Merge one pinned_shapes binding (phenotype → glossary_stem) + compile_warnings."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.gene_pack.pinned_shape.upsert", "mutation_risk": "low", "related_tools": ["knowledge.phenotype.upsert", "knowledge.config.get", "knowledge.retrieve.probe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Gene Pack Pinned Shape Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "generation_fork_required": "auto_generation_mode on — omit env_uuid for auto-fork on patch or pass sandbox anchor; then generation.diff_vs_prod → generation.gates → generation.promote", "invalid_parameters": "discovery.describe; bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "phenotype_name_required": "phenotype.name non-empty string required", "phenotype_required": "Pass phenotype object", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Merge one pinned_shapes binding (phenotype → glossary_stem) + compile_warnings."}, "domain": "knowledge", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "generation_atoms": {"GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts."}, "instruction_hint": "Merge one pinned_shapes binding (phenotype → glossary_stem) + compile_warnings.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT", "KNOWLEDGE_TENANT_EDIT_LADDER", "GENERATION_SAFE_CYCLE_LADDER"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.phenotype.upsert", "knowledge.config.get", "knowledge.retrieve.probe"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_gene_pack_pinned_shape_upsert", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Merge one pinned_shapes binding (phenotype → glossary_stem) + compile_warnings.", "title": "Knowledge Gene Pack Pinned Shape Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "generation_fork_required": "auto_generation_mode on — omit env_uuid for auto-fork on patch or pass sandbox anchor; then generation.diff_vs_prod → generation.gates → generation.promote", "invalid_parameters": "discovery.describe; bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "phenotype_name_required": "phenotype.name non-empty string required", "phenotype_required": "Pass phenotype object", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Merge one pinned_shapes binding (phenotype → glossary_stem) + compile_warnings.", "write_mode": null}, {"action": "logic.create", "aliases": ["function.compile", "function.create", "functions.compile", "functions.create", "logic.write", "rules.create", "rules.create_rules"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not logic.create a second rule — logic.get the id from the create receipt.", "anti_patterns": ["Do not logic.create a second rule — logic.get the id from the create receipt.", "Do not enable on production traffic before logic.dry_run.", "Integration Hub recipes may already attach rules — do not duplicate inbound intake."], "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.create", "mutation_risk": "low", "related_tools": ["logic.attach_template", "logic.list", "logic.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Logic Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "logic_write cap + project membership on tenant PID", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic.get_commands + logic.signals_catalog before triggers/space", "invalid_structure": "logic.get_processors for processor ids — fix graph before retry", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "processor_not_found": "logic.get_processors — specified processor not available", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "When X then Y automation — prefer over custom event handlers. Save logic_id; logic.dry_run before enable."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.create", "mutation_risk": "low", "related_tools": ["logic.attach_template", "logic.list", "logic.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Logic Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "logic_write cap + project membership on tenant PID", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic.get_commands + logic.signals_catalog before triggers/space", "invalid_structure": "logic.get_processors for processor ids — fix graph before retry", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "processor_not_found": "logic.get_processors — specified processor not available", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "When X then Y automation — prefer over custom event handlers. Save logic_id; logic.dry_run before enable."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"insufficient_permissions": "logic_write cap + project membership on tenant PID", "invalid_parameters": "logic.get_commands + logic.signals_catalog before triggers/space", "invalid_structure": "logic.get_processors for processor ids — fix graph before retry", "processor_not_found": "logic.get_processors — specified processor not available"}, "examples": [{"description": "Create a rule that executes when a specific command is called", "name": "Create rule with command trigger", "request": {"params": {"description": "Check and grant daily rewards to users", "enabled": true, "name": "Daily Reward Check", "priority": 5, "space": [{"action": "add", "parameters": {"field1": "user.daily_streak", "field2": 1, "result_field": "user.daily_streak"}, "processor": "field_operations_processor"}, {"action": "set", "parameters": {"field": "user.last_reward_date", "value": "{{now}}"}, "processor": "field_operations_processor"}], "triggers": [{"command": "check.daily_reward", "type": "command", "when": {}}]}, "tool": "logic.create"}, "response": {"data": {"created_at": "2025-01-20T10:00:00Z", "description": "Check and grant daily rewards to users", "enabled": true, "id": "550e8400-e29b-41d4-a716-446655440000", "name": "Daily Reward Check", "priority": 5, "space": [], "triggers": [{"command": "check.daily_reward", "type": "command"}]}, "success": true}}, {"description": "Create a rule that runs on a schedule using cron expression", "name": "Create rule with scheduler", "request": {"params": {"description": "Run daily cleanup task at 2 AM UTC", "enabled": true, "name": "Daily Cleanup", "schedulers": [{"cron": "0 2 * * *", "timezone": "UTC"}], "space": [{"action": "delete", "parameters": {"entity": "temp_data", "filters": {"created_at": {"$lt": "now-7d"}}}, "processor": "dna_operations_processor"}]}, "tool": "logic.create"}, "response": {"data": {"created_at": "2025-01-20T10:00:00Z", "enabled": true, "id": "550e8400-e29b-41d4-a716-446655440001", "name": "Daily Cleanup"}, "success": true}}, {"description": "Create a rule with multiple processor blocks executing sequentially", "name": "Create complex rule with multiple processors", "request": {"params": {"description": "Handle new user registration with multiple steps", "enabled": true, "name": "User Registration Handler", "priority": 7, "space": [{"action": "set", "parameters": {"field": "user.registration_date", "value": "{{now}}"}, "processor": "field_operations_processor"}, {"action": "set", "parameters": {"field": "user.status", "value": "active"}, "processor": "field_operations_processor"}, {"action": "send", "parameters": {"recipient": "{{user.email}}", "type": "welcome_email"}, "processor": "notification_processor"}], "triggers": [{"command": "user.register", "type": "command", "when": {}}]}, "tool": "logic.create"}, "response": {"data": {"enabled": true, "id": "550e8400-e29b-41d4-a716-446655440002", "name": "User Registration Handler"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "When X then Y automation — prefer over custom event handlers. Save logic_id; logic.dry_run before e…", "kind": "mcp_domain", "logic_atoms": {"LOGIC_DRY_RUN_FIRST": "logic.create / logic.attach_template mutations: logic.dry_run with logic_id before enable or production traffic. Disabled rules still dry-run. A space graph with processors must execute; blocks_executed=0 is no_blocks_executed, not success.", "LOGIC_ID_FROM_RECEIPT": "logic.dry_run needs logic_id from logic.create or logic.attach_template receipt — not a rule spec or template_id alone.", "LOGIC_NO_SECOND_CREATE": "Do not logic.create a second rule — logic.get the id from the first create receipt."}, "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"created_at": {"description": "string - ISO 8601 timestamp of creation", "type": "string"}, "description": {"description": "string - Rule description", "type": "string"}, "enabled": {"description": "bool - Whether rule is enabled", "type": "boolean"}, "id": {"description": "string - Rule UUID (unique identifier for the rule, format: UUID v4)", "type": "string"}, "name": {"description": "string - Rule name as provided", "type": "string"}, "priority": {"description": "int - Rule priority (1-10)", "type": "integer"}, "schedulers": {"description": "array - Array of scheduler configurations", "items": {"type": "string"}, "type": "array"}, "space": {"description": "array - Array of processor blocks", "items": {"type": "string"}, "type": "array"}, "triggers": {"description": "array - Array of trigger configurations", "items": {"type": "string"}, "type": "array"}, "updated_at": {"description": "string - ISO 8601 timestamp of last update", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.attach_template", "logic.list", "logic.dry_run"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "rollback": ["logic.delete", "generation.realign_to_prod"], "safe_action": "logic_create", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create new Logic Engine rule for project.", "title": "Logic Create", "tool_chains": ["scheduled_rewards", "game_setup", "game_setup"], "verification": ["logic.get", "logic.dry_run"], "verify": [{"action": "logic.get", "predicate": "named resource is visible"}, {"action": "logic.dry_run", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "logic_write cap + project membership on tenant PID", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic.get_commands + logic.signals_catalog before triggers/space", "invalid_structure": "logic.get_processors for processor ids — fix graph before retry", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "processor_not_found": "logic.get_processors — specified processor not available", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}}, "when_to_use": "When X then Y automation — prefer over custom event handlers. Save logic_id; logic.dry_run before enable.", "workflow_ladder": ["context.project_id bound — logic.list or prepare logic.create / logic.attach_template", "logic.create or logic.attach_template — save logic_id from the response receipt", "logic.dry_run with logic_id + command_data/mocks — not template_id or inline spec", "logic.update to enable only after dry_run trace is clean", "logic.list_versions → logic.diff_versions before logic.restore_version"], "write_mode": null}, {"action": "logic.update", "ai_tips": "Update an existing logic rule. Pass write_mode for triggers/space/schedulers; prefer path_updates for one node. One sentence in description: replacements + text_field=description (no GET).", "aliases": ["rules.activate_rules", "rules.update_rules"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Sending one trigger without write_mode=merge and expecting siblings to remain (omit is now merge, but be explicit).", "anti_patterns": ["Sending one trigger without write_mode=merge and expecting siblings to remain (omit is now merge, but be explicit).", "Putting bot commands or KB text into logic.space."], "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.update", "mutation_risk": "low", "related_tools": ["logic.get", "logic.create", "logic.delete", "logic.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Update", "when_blocked": {"content_shrink_blocked": "full replace on text_field is much shorter — allow_shrink or search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "logic_write cap + project membership", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "logic_collection_empty_blocked": "pass write_mode or non-empty collection — not wipe", "logic_not_found": "logic.list or logic.get with same project_id before update", "patch_apply_failed": "unified_diff did not apply on text_field — logic.get and retry", "replacement_not_found": "replacements.find is not in text_field (description|name)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "logic.get_commands — supported write_mode for triggers/space", "write_mode_unsupported": "append/prepend are not valid for logic collections"}, "when_to_use": "Update an existing logic rule. Pass write_mode for triggers/space/schedulers; prefer path_updates for one node. One sentence in description: replacements + text_field=description (no GET)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.update", "mutation_risk": "low", "related_tools": ["logic.get", "logic.create", "logic.delete", "logic.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Update", "when_blocked": {"content_shrink_blocked": "full replace on text_field is much shorter — allow_shrink or search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "logic_write cap + project membership", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "logic_collection_empty_blocked": "pass write_mode or non-empty collection — not wipe", "logic_not_found": "logic.list or logic.get with same project_id before update", "patch_apply_failed": "unified_diff did not apply on text_field — logic.get and retry", "replacement_not_found": "replacements.find is not in text_field (description|name)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "logic.get_commands — supported write_mode for triggers/space", "write_mode_unsupported": "append/prepend are not valid for logic collections"}, "when_to_use": "Update an existing logic rule. Pass write_mode for triggers/space/schedulers; prefer path_updates for one node. One sentence in description: replacements + text_field=description (no GET)."}, "collection_key": "uid", "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"content_shrink_blocked": "full replace on text_field is much shorter — allow_shrink or search_replace", "insufficient_permissions": "logic_write cap + project membership", "logic_collection_empty_blocked": "pass write_mode or non-empty collection — not wipe", "logic_not_found": "logic.list or logic.get with same project_id before update", "patch_apply_failed": "unified_diff did not apply on text_field — logic.get and retry", "replacement_not_found": "replacements.find is not in text_field (description|name)", "write_mode_invalid": "logic.get_commands — supported write_mode for triggers/space", "write_mode_unsupported": "append/prepend are not valid for logic collections"}, "examples": [{"description": "Disable a logic rule", "request": {"enabled": false, "logic_id": "uuid"}, "response": {"data": {"logic": {"enabled": false, "id": "uuid"}, "message": "Logic updated successfully", "success": true}, "success": true}}, {"description": "Patch a single space node via PathAtom", "request": {"logic_id": "uuid", "path_updates": {"space{node-1}.label": "Renamed"}}, "response": {"data": {"logic": {"id": "uuid", "name": "Updated Rule"}, "message": "Logic updated successfully", "success": true}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Update an existing logic rule. Pass write_mode for triggers/space/schedulers; prefer path_updates f…", "kind": "mcp_domain", "logic_atoms": {"LOGIC_COLLECTION_EMPTY_BLOCKED": "logic.update with empty triggers/space/schedulers is blocked (logic_collection_empty_blocked) — use write_mode intentionally.", "LOGIC_VERSION_CONFLICT": "logic.restore_version / logic.diff_versions: logic.list_versions first — stale version_id returns not_found; diff before restore."}, "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get", "logic.create", "logic.delete", "logic.dry_run"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "logic_update", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Update existing Logic Engine rule.", "title": "Logic Update", "when_blocked": {"content_shrink_blocked": "full replace on text_field is much shorter — allow_shrink or search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "logic_write cap + project membership", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "logic_collection_empty_blocked": "pass write_mode or non-empty collection — not wipe", "logic_not_found": "logic.list or logic.get with same project_id before update", "patch_apply_failed": "unified_diff did not apply on text_field — logic.get and retry", "replacement_not_found": "replacements.find is not in text_field (description|name)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "logic.get_commands — supported write_mode for triggers/space", "write_mode_unsupported": "append/prepend are not valid for logic collections"}, "when_to_use": "Update an existing logic rule. Pass write_mode for triggers/space/schedulers; prefer path_updates for one node. One sentence in description: replacements + text_field=description (no GET).", "write_mode": ["merge", "patch", "upsert", "replace", "write", "delete"], "write_mode_note": "triggers/space/schedulers are keyed lists: pass write_mode. Prefer path_updates for one node."}, {"action": "logic.delete", "aliases": ["rules.delete_rules"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.delete", "mutation_risk": "low", "related_tools": ["logic.get", "logic.create", "logic.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "logic_write cap + project membership", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id + context.project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "logic_not_found": "logic.list — logic_id must exist before delete", "not_found": "logic.list — logic_id must exist before delete", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove automation by id — irreversible."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.delete", "mutation_risk": "low", "related_tools": ["logic.get", "logic.create", "logic.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "logic_write cap + project membership", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id + context.project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "logic_not_found": "logic.list — logic_id must exist before delete", "not_found": "logic.list — logic_id must exist before delete", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove automation by id — irreversible."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "errors": {"insufficient_permissions": "logic_write cap + project membership", "invalid_parameters": "logic_id + context.project_id required", "logic_not_found": "logic.list — logic_id must exist before delete", "not_found": "logic.list — logic_id must exist before delete"}, "examples": [{"description": "Delete a logic rule", "request": {"logic_id": "uuid"}, "response": {"data": {"deleted": true, "logic_id": "uuid"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Remove automation by id — irreversible.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deleted": {"description": "bool - Whether rule was deleted", "type": "boolean"}, "logic_id": {"description": "string - Deleted rule ID", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get", "logic.create", "logic.list"], "required_cap": "logic_write", "requires_preflight": true, "risk_class": "destructive", "rollback": [], "safe_action": "logic_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete a Logic Engine rule.", "title": "Logic Delete", "verification": ["logic.list"], "verify": [{"action": "logic.list", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "logic_write cap + project membership", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id + context.project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "logic_not_found": "logic.list — logic_id must exist before delete", "not_found": "logic.list — logic_id must exist before delete", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}, "not_found": {"en-US": "Missing id — logic.list / catalog template_id; use logic_id from create/attach", "pt-BR": "Id ausente — logic.list / catalog template_id; use logic_id do create/attach", "ru-RU": "Нет id — logic.list / catalog template_id; logic_id из create/attach"}}, "when_to_use": "Remove automation by id — irreversible.", "write_mode": null}, {"action": "logic.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.get", "related_tools": ["logic.execute", "logic.delete", "logic.get_commands"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "retry once; logic.list if logic_id may be stale", "invalid_parameters": "logic_id + context.project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "logic_not_found": "logic.list — logic_id from create/attach receipt", "not_found": "logic.list — logic_id from create/attach receipt", "project_not_found": "bind context.project_id before logic.get", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load one rule graph by logic_id — after logic.list pick or create/attach receipt."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.get", "related_tools": ["logic.execute", "logic.delete", "logic.get_commands"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "retry once; logic.list if logic_id may be stale", "invalid_parameters": "logic_id + context.project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "logic_not_found": "logic.list — logic_id from create/attach receipt", "not_found": "logic.list — logic_id from create/attach receipt", "project_not_found": "bind context.project_id before logic.get", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load one rule graph by logic_id — after logic.list pick or create/attach receipt."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"internal_error": "retry once; logic.list if logic_id may be stale", "invalid_parameters": "logic_id + context.project_id required", "logic_not_found": "logic.list — logic_id from create/attach receipt", "not_found": "logic.list — logic_id from create/attach receipt", "project_not_found": "bind context.project_id before logic.get"}, "examples": [{"description": "Get logic rule details", "request": {"logic_id": "uuid"}, "response": {"data": {"enabled": true, "id": "uuid", "name": "Daily Reward"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Load one rule graph by logic_id — after logic.list pick or create/attach receipt.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.execute", "logic.delete", "logic.get_commands"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_get", "semantic_input_mode": "inherit_workflow", "summary": "Get detailed information about a Logic Engine rule.", "title": "Logic Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "retry once; logic.list if logic_id may be stale", "invalid_parameters": "logic_id + context.project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "logic_not_found": "logic.list — logic_id from create/attach receipt", "not_found": "logic.list — logic_id from create/attach receipt", "project_not_found": "bind context.project_id before logic.get", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}, "not_found": {"en-US": "Missing id — logic.list / catalog template_id; use logic_id from create/attach", "pt-BR": "Id ausente — logic.list / catalog template_id; use logic_id do create/attach", "ru-RU": "Нет id — logic.list / catalog template_id; logic_id из create/attach"}}, "when_to_use": "Load one rule graph by logic_id — after logic.list pick or create/attach receipt.", "write_mode": null}, {"action": "logic.list", "aliases": ["function.list", "functions.list", "rules.list", "rules.list_rules"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.list", "related_tools": ["logic.get", "logic.create", "logic.dry_run", "logic.execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound — optional filters only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap + project membership", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enumerate rules in project scope — empty list is valid fork head."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.list", "related_tools": ["logic.get", "logic.create", "logic.dry_run", "logic.execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound — optional filters only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap + project membership", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enumerate rules in project scope — empty list is valid fork head."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "context.project_id bound — optional filters only", "unauthorized": "logic_read cap + project membership"}, "examples": [{"description": "List all logic rules", "request": {}, "response": {"data": {"count": 1, "logic": [{"enabled": true, "id": "uuid", "name": "Rule 1"}]}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Enumerate rules in project scope — empty list is valid fork head.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get", "logic.create", "logic.dry_run", "logic.execute"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_list", "semantic_input_mode": "inherit_workflow", "summary": "Page Logic Engine rules for a project (default 100, max 1000).", "title": "Logic List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound — optional filters only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap + project membership", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}}, "when_to_use": "Enumerate rules in project scope — empty list is valid fork head.", "write_mode": null}, {"action": "logic.execute", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.execute", "mutation_risk": "low", "related_tools": ["logic.get", "logic.create", "logic.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Logic Execute", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_failed": "Rule execution failed — logic.get graph before retry", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id + command_data required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "logic_execution_failed": "logic.get_processors — fix graph before execute", "logic_not_found": "logic.list — logic_id from create/attach receipt", "not_found": "logic.get — rule must exist; logic.dry_run before production execute", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run enabled rule on live traffic — logic.dry_run first; not a substitute for dry_run."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.execute", "mutation_risk": "low", "related_tools": ["logic.get", "logic.create", "logic.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Logic Execute", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_failed": "Rule execution failed — logic.get graph before retry", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id + command_data required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "logic_execution_failed": "logic.get_processors — fix graph before execute", "logic_not_found": "logic.list — logic_id from create/attach receipt", "not_found": "logic.get — rule must exist; logic.dry_run before production execute", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run enabled rule on live traffic — logic.dry_run first; not a substitute for dry_run."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"execution_failed": "Rule execution failed — logic.get graph before retry", "invalid_parameters": "logic_id + command_data required", "logic_execution_failed": "logic.get_processors — fix graph before execute", "logic_not_found": "logic.list — logic_id from create/attach receipt", "not_found": "logic.get — rule must exist; logic.dry_run before production execute"}, "examples": [{"description": "Execute a logic rule for testing", "request": {"event_data": {"test": "data"}, "logic_id": "uuid"}, "response": {"data": {"execution_id": "exec-1", "execution_time_ms": 12, "logic_id": "uuid", "message": "Logic executed successfully", "result": {}, "results": [], "success": true}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Run enabled rule on live traffic — logic.dry_run first; not a substitute for dry_run.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"execution_id": {"description": "string", "type": "string"}, "execution_time_ms": {"description": "number", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "logic_id": {"description": "string", "type": "string"}, "message": {"description": "string", "type": "string"}, "result": {"additionalProperties": true, "description": "object", "type": "object"}, "results": {"description": "array", "items": {"type": "string"}, "type": "array"}, "success": {"description": "bool", "type": "boolean"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get", "logic.create", "logic.dry_run"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "logic_execute", "semantic_input_mode": "inherit_workflow", "summary": "Execute a Logic Engine rule immediately.", "title": "Logic Execute", "tool_chains": ["crud_with_logic"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_failed": "Rule execution failed — logic.get graph before retry", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id + command_data required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "logic_execution_failed": "logic.get_processors — fix graph before execute", "logic_not_found": "logic.list — logic_id from create/attach receipt", "not_found": "logic.get — rule must exist; logic.dry_run before production execute", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}, "logic_execution_failed": {"en-US": "logic.get the graph — fix processor ids via logic.get_processors", "pt-BR": "logic.get no grafo — corrija os ids dos processadores via logic.get_processors", "ru-RU": "logic.get граф — исправьте id процессоров через logic.get_processors"}, "not_found": {"en-US": "Missing id — logic.list / catalog template_id; use logic_id from create/attach", "pt-BR": "Id ausente — logic.list / catalog template_id; use logic_id do create/attach", "ru-RU": "Нет id — logic.list / catalog template_id; logic_id из create/attach"}}, "when_to_use": "Run enabled rule on live traffic — logic.dry_run first; not a substitute for dry_run.", "write_mode": null}, {"action": "logic.get_processors", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.get_processors", "related_tools": ["processors.list", "logic.create", "logic.update"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Get Processors", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap before planning processors", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Processor catalog for space graph — before logic.create wiring."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.get_processors", "related_tools": ["processors.list", "logic.create", "logic.update"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Get Processors", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap before planning processors", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Processor catalog for space graph — before logic.create wiring."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "context.project_id bound", "unauthorized": "logic_read cap before planning processors"}, "examples": [{"description": "Get available processors for logic", "request": {}, "response": {"data": {"processors": [{"category": "data_processing", "description": "Mathematical and field operations", "name": "field_operations_processor"}], "total": 10}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Processor catalog for space graph — before logic.create wiring.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["processors.list", "logic.create", "logic.update"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_get_processors", "semantic_input_mode": "inherit_workflow", "summary": "Get list of available processors (same as processors.list but in logic context).", "title": "Logic Get Processors", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap before planning processors", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}}, "when_to_use": "Processor catalog for space graph — before logic.create wiring.", "write_mode": null}, {"action": "logic.get_commands", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.get_commands", "related_tools": ["logic.signals_catalog", "logic.create", "logic.update"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Get Commands", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap — catalog of block commands", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Block command catalog — pair with logic.signals_catalog for triggers."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.get_commands", "related_tools": ["logic.signals_catalog", "logic.create", "logic.update"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Get Commands", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap — catalog of block commands", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Block command catalog — pair with logic.signals_catalog for triggers."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "context.project_id bound", "unauthorized": "logic_read cap — catalog of block commands"}, "examples": [{"description": "Get available commands for triggers", "request": {}, "response": {"data": {"commands": ["check.daily_reward"], "count": 1}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Block command catalog — pair with logic.signals_catalog for triggers.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.signals_catalog", "logic.create", "logic.update"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_get_commands", "semantic_input_mode": "inherit_workflow", "summary": "Get list of available commands for triggers.", "title": "Logic Get Commands", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap — catalog of block commands", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}}, "when_to_use": "Block command catalog — pair with logic.signals_catalog for triggers.", "write_mode": null}, {"action": "logic.flush_batch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.flush_batch", "mutation_risk": "low", "related_tools": ["logic.create", "logic.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Flush Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "retry once; logic.list if batch state unknown", "invalid_parameters": "batch scope + project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "no pending batch — logic.list or prior flush receipt", "project_not_found": "bind context.project_id before logic.flush_batch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Flush coalesced logic batch writes — after mutations in same session."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.flush_batch", "mutation_risk": "low", "related_tools": ["logic.create", "logic.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Flush Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "retry once; logic.list if batch state unknown", "invalid_parameters": "batch scope + project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "no pending batch — logic.list or prior flush receipt", "project_not_found": "bind context.project_id before logic.flush_batch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Flush coalesced logic batch writes — after mutations in same session."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"internal_error": "retry once; logic.list if batch state unknown", "invalid_parameters": "batch scope + project_id required", "not_found": "no pending batch — logic.list or prior flush receipt", "project_not_found": "bind context.project_id before logic.flush_batch"}, "examples": [{"input": {"_project_id": 123}, "output": {"message": "Batch flushed for project 123", "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Flush coalesced logic batch writes — after mutations in same session.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.create", "logic.list"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "logic_flush_batch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Force flush logic batch for a project (saves all accumulated rules immediately)", "title": "Logic Flush Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "retry once; logic.list if batch state unknown", "invalid_parameters": "batch scope + project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "no pending batch — logic.list or prior flush receipt", "project_not_found": "bind context.project_id before logic.flush_batch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}, "not_found": {"en-US": "Missing id — logic.list / catalog template_id; use logic_id from create/attach", "pt-BR": "Id ausente — logic.list / catalog template_id; use logic_id do create/attach", "ru-RU": "Нет id — logic.list / catalog template_id; logic_id из create/attach"}}, "when_to_use": "Flush coalesced logic batch writes — after mutations in same session.", "write_mode": null}, {"action": "logic.dry_run", "aliases": ["rules.test_rules"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not pass a rule spec — logic.dry_run needs logic_id from an existing rule.", "anti_patterns": ["Do not pass a rule spec — logic.dry_run needs logic_id from an existing rule.", "Do not treat dry_run success as go-live — review trace before logic.update enable.", "Do not treat blocks_executed=0 as success when space lists a processor."], "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "effect_override": {"conditional_mutate": "Simulates rule; no durable automation writes.", "kind": "read", "read_only_hint": true}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.dry_run", "related_tools": ["logic.get", "logic.create", "logic.attach_template", "logic.update"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Dry Run", "when_blocked": {"SS1401": "dna.write path not in write_paths — fix export meta or script.put", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Re-upload via script.put", "bytecode_stale": "compiler_version on the stored artifact differs — script.recompile_version or script.put before dry_run", "cap_not_implemented": "P1 VM — dna.*, events.emit (host allowlist), wallet via stackscript.wallet.replay; not http/notify/secrets — script.docs topic=host", "compile_failed": "Ephemeral sources did not compile — see diagnostics", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "db_unavailable": "Retry dry_run after retry_after_ms — same as script.run", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field on input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_write_path_denied": "Same as SS1401", "entry_path_required": "Multi-file files[] needs entry", "expect_value_mismatch": "VM value differed from expect_value — fix script or input", "export_not_found": "Use export_names from script.put receipt", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass input object or positional array — export requires parameters", "input_requires_integer_slots": "input values must be numeric (coerce strings)", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id required — not template_id or inline rule spec", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "logic_execution_failed": "logic.get graph — fix processor ids via logic.get_processors", "no_blocks_executed": "space has processors but none ran — logic.get the graph; dry_run is not a no-op", "no_published_version": "script.publish or put with publish=live", "not_found": "logic.list or logic.get — logic_id from create/attach receipt", "payload_too_large": "files[] exceeds the same byte cap as script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "run_timeout": "VM exceeded run timeout — simplify export or split work", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "script_dry_run_failed": "VM or export error — see error field", "script_id_or_files_required": "Pass script_id or ephemeral files[] with path/content and optional entry", "script_not_found": "script.put first", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_pathological": "Source line count, line length, or comment-padding probe (SS1098) — max 25k lines/file, 8KiB/line; split or trim before script.dry_run", "stackscript_fuel_quota_exceeded": "Upgrade plan or reduce fuel", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "version_not_found": "Check script.versions", "vm_division_by_zero": "Guard divisor in script body before divide/mod", "vm_fuel_exhausted": "Export exceeded per-run fuel limit — simplify body or raise cap", "vm_int_overflow": "int53 overflow — narrow arithmetic in export body", "wallet_user_required": "MCP session user_id required — omit params.user_id", "workflow_scope_leak": "params.user_id must match session user_id"}, "when_to_use": "Simulate an existing rule without side effects. Requires logic_id from create/attach."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "effect_override": {"conditional_mutate": "Simulates rule; no durable automation writes.", "kind": "read", "read_only_hint": true}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.dry_run", "related_tools": ["logic.get", "logic.create", "logic.attach_template", "logic.update"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Dry Run", "when_blocked": {"SS1401": "dna.write path not in write_paths — fix export meta or script.put", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Re-upload via script.put", "bytecode_stale": "compiler_version on the stored artifact differs — script.recompile_version or script.put before dry_run", "cap_not_implemented": "P1 VM — dna.*, events.emit (host allowlist), wallet via stackscript.wallet.replay; not http/notify/secrets — script.docs topic=host", "compile_failed": "Ephemeral sources did not compile — see diagnostics", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "db_unavailable": "Retry dry_run after retry_after_ms — same as script.run", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field on input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_write_path_denied": "Same as SS1401", "entry_path_required": "Multi-file files[] needs entry", "expect_value_mismatch": "VM value differed from expect_value — fix script or input", "export_not_found": "Use export_names from script.put receipt", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass input object or positional array — export requires parameters", "input_requires_integer_slots": "input values must be numeric (coerce strings)", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id required — not template_id or inline rule spec", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "logic_execution_failed": "logic.get graph — fix processor ids via logic.get_processors", "no_blocks_executed": "space has processors but none ran — logic.get the graph; dry_run is not a no-op", "no_published_version": "script.publish or put with publish=live", "not_found": "logic.list or logic.get — logic_id from create/attach receipt", "payload_too_large": "files[] exceeds the same byte cap as script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "run_timeout": "VM exceeded run timeout — simplify export or split work", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "script_dry_run_failed": "VM or export error — see error field", "script_id_or_files_required": "Pass script_id or ephemeral files[] with path/content and optional entry", "script_not_found": "script.put first", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_pathological": "Source line count, line length, or comment-padding probe (SS1098) — max 25k lines/file, 8KiB/line; split or trim before script.dry_run", "stackscript_fuel_quota_exceeded": "Upgrade plan or reduce fuel", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "version_not_found": "Check script.versions", "vm_division_by_zero": "Guard divisor in script body before divide/mod", "vm_fuel_exhausted": "Export exceeded per-run fuel limit — simplify body or raise cap", "vm_int_overflow": "int53 overflow — narrow arithmetic in export body", "wallet_user_required": "MCP session user_id required — omit params.user_id", "workflow_scope_leak": "params.user_id must match session user_id"}, "when_to_use": "Simulate an existing rule without side effects. Requires logic_id from create/attach."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Simulates rule; no durable automation writes.", "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "effect_override": {"conditional_mutate": "Simulates rule; no durable automation writes.", "kind": "read", "read_only_hint": true}, "errors": {"invalid_parameters": "logic_id required — not template_id or inline rule spec", "logic_execution_failed": "logic.get graph — fix processor ids via logic.get_processors", "no_blocks_executed": "space has processors but none ran — logic.get the graph; dry_run is not a no-op", "not_found": "logic.list or logic.get — logic_id from create/attach receipt"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Simulate an existing rule without side effects. Requires logic_id from create/attach.", "kind": "mcp_domain", "language": "typescript", "logic_atoms": {"LOGIC_DRY_RUN_FIRST": "logic.create / logic.attach_template mutations: logic.dry_run with logic_id before enable or production traffic. Disabled rules still dry-run. A space graph with processors must execute; blocks_executed=0 is no_blocks_executed, not success.", "LOGIC_ID_FROM_RECEIPT": "logic.dry_run needs logic_id from logic.create or logic.attach_template receipt — not a rule spec or template_id alone."}, "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get", "logic.create", "logic.attach_template", "logic.update"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_dry_run", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Simulate a logic rule execution without side effects (F2.5).", "title": "Logic Dry Run", "when_blocked": {"SS1401": "dna.write path not in write_paths — fix export meta or script.put", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Re-upload via script.put", "bytecode_stale": "compiler_version on the stored artifact differs — script.recompile_version or script.put before dry_run", "cap_not_implemented": "P1 VM — dna.*, events.emit (host allowlist), wallet via stackscript.wallet.replay; not http/notify/secrets — script.docs topic=host", "compile_failed": "Ephemeral sources did not compile — see diagnostics", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "db_unavailable": "Retry dry_run after retry_after_ms — same as script.run", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field on input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_write_path_denied": "Same as SS1401", "entry_path_required": "Multi-file files[] needs entry", "expect_value_mismatch": "VM value differed from expect_value — fix script or input", "export_not_found": "Use export_names from script.put receipt", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass input object or positional array — export requires parameters", "input_requires_integer_slots": "input values must be numeric (coerce strings)", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id required — not template_id or inline rule spec", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "logic_execution_failed": "logic.get graph — fix processor ids via logic.get_processors", "no_blocks_executed": "space has processors but none ran — logic.get the graph; dry_run is not a no-op", "no_published_version": "script.publish or put with publish=live", "not_found": "logic.list or logic.get — logic_id from create/attach receipt", "payload_too_large": "files[] exceeds the same byte cap as script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "run_timeout": "VM exceeded run timeout — simplify export or split work", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "script_dry_run_failed": "VM or export error — see error field", "script_id_or_files_required": "Pass script_id or ephemeral files[] with path/content and optional entry", "script_not_found": "script.put first", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_pathological": "Source line count, line length, or comment-padding probe (SS1098) — max 25k lines/file, 8KiB/line; split or trim before script.dry_run", "stackscript_fuel_quota_exceeded": "Upgrade plan or reduce fuel", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "version_not_found": "Check script.versions", "vm_division_by_zero": "Guard divisor in script body before divide/mod", "vm_fuel_exhausted": "Export exceeded per-run fuel limit — simplify body or raise cap", "vm_int_overflow": "int53 overflow — narrow arithmetic in export body", "wallet_user_required": "MCP session user_id required — omit params.user_id", "workflow_scope_leak": "params.user_id must match session user_id"}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}, "logic_execution_failed": {"en-US": "logic.get the graph — fix processor ids via logic.get_processors", "pt-BR": "logic.get no grafo — corrija os ids dos processadores via logic.get_processors", "ru-RU": "logic.get граф — исправьте id процессоров через logic.get_processors"}, "no_blocks_executed": {"en-US": "Graph has processors but none ran — logic.get the space; dry_run must execute it", "pt-BR": "O grafo tem processadores, mas nenhum rodou — logic.get no space; dry_run tem que executá-lo", "ru-RU": "В графе есть процессоры, но ни один не выполнился — logic.get space; dry_run обязан его исполнить"}, "not_found": {"en-US": "Missing id — logic.list / catalog template_id; use logic_id from create/attach", "pt-BR": "Id ausente — logic.list / catalog template_id; use logic_id do create/attach", "ru-RU": "Нет id — logic.list / catalog template_id; logic_id из create/attach"}}, "when_to_use": "Simulate an existing rule without side effects. Requires logic_id from create/attach.", "workflow_ladder": ["context.project_id bound — logic.list or prepare logic.create / logic.attach_template", "logic.create or logic.attach_template — save logic_id from the response receipt", "logic.dry_run with logic_id + command_data/mocks — not template_id or inline spec", "logic.update to enable only after dry_run trace is clean", "logic.list_versions → logic.diff_versions before logic.restore_version"], "write_mode": null}, {"action": "logic.list_versions", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.list_versions", "related_tools": ["logic.get", "logic.diff_versions", "logic.restore_version"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic List Versions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id required — not template_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "logic.list or logic.get — logic_id from create/attach receipt", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Version history before logic.restore_version or logic.diff_versions."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.list_versions", "related_tools": ["logic.get", "logic.diff_versions", "logic.restore_version"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic List Versions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id required — not template_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "logic.list or logic.get — logic_id from create/attach receipt", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Version history before logic.restore_version or logic.diff_versions."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "logic_id required — not template_id", "not_found": "logic.list or logic.get — logic_id from create/attach receipt"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Version history before logic.restore_version or logic.diff_versions.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get", "logic.diff_versions", "logic.restore_version"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_list_versions", "semantic_input_mode": "inherit_workflow", "summary": "List historical snapshots stored on a rule (F2.9).", "title": "Logic List Versions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id required — not template_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "logic.list or logic.get — logic_id from create/attach receipt", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}, "not_found": {"en-US": "Missing id — logic.list / catalog template_id; use logic_id from create/attach", "pt-BR": "Id ausente — logic.list / catalog template_id; use logic_id do create/attach", "ru-RU": "Нет id — logic.list / catalog template_id; logic_id из create/attach"}}, "when_to_use": "Version history before logic.restore_version or logic.diff_versions.", "write_mode": null}, {"action": "logic.diff_versions", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.diff_versions", "related_tools": ["logic.list_versions", "logic.restore_version"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Diff Versions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id and from_version/to_version required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "logic.list_versions — pick two version ids from history", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compare two logic versions — logic.list_versions for ids."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.diff_versions", "related_tools": ["logic.list_versions", "logic.restore_version"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Diff Versions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id and from_version/to_version required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "logic.list_versions — pick two version ids from history", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compare two logic versions — logic.list_versions for ids."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "logic_id and from_version/to_version required", "not_found": "logic.list_versions — pick two version ids from history"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Compare two logic versions — logic.list_versions for ids.", "kind": "mcp_domain", "logic_atoms": {"LOGIC_VERSION_CONFLICT": "logic.restore_version / logic.diff_versions: logic.list_versions first — stale version_id returns not_found; diff before restore."}, "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.list_versions", "logic.restore_version"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_diff_versions", "semantic_input_mode": "inherit_workflow", "summary": "Diff two rule versions. Returns delta only. A long old or new value is an envelope preview, not the leaf. Roll back with logic.restore_version.", "title": "Logic Diff Versions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id and from_version/to_version required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "logic.list_versions — pick two version ids from history", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}, "not_found": {"en-US": "Missing id — logic.list / catalog template_id; use logic_id from create/attach", "pt-BR": "Id ausente — logic.list / catalog template_id; use logic_id do create/attach", "ru-RU": "Нет id — logic.list / catalog template_id; logic_id из create/attach"}}, "when_to_use": "Compare two logic versions — logic.list_versions for ids.", "write_mode": null}, {"action": "logic.restore_version", "aliases": ["logic.revert"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.restore_version", "mutation_risk": "low", "related_tools": ["logic.diff_versions", "logic.dry_run", "logic.update"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Restore Version", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id + version_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "logic.list_versions — version_id must exist on logic_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "version_conflict": "logic.diff_versions first — CAS revision mismatch on restore"}, "when_to_use": "Rollback rule body — logic.diff_versions first; expect version conflict CAS."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.restore_version", "mutation_risk": "low", "related_tools": ["logic.diff_versions", "logic.dry_run", "logic.update"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Restore Version", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id + version_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "logic.list_versions — version_id must exist on logic_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "version_conflict": "logic.diff_versions first — CAS revision mismatch on restore"}, "when_to_use": "Rollback rule body — logic.diff_versions first; expect version conflict CAS."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"invalid_parameters": "logic_id + version_id required", "not_found": "logic.list_versions — version_id must exist on logic_id", "version_conflict": "logic.diff_versions first — CAS revision mismatch on restore"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Rollback rule body — logic.diff_versions first; expect version conflict CAS.", "kind": "mcp_domain", "logic_atoms": {"LOGIC_VERSION_CONFLICT": "logic.restore_version / logic.diff_versions: logic.list_versions first — stale version_id returns not_found; diff before restore."}, "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.diff_versions", "logic.dry_run", "logic.update"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "logic_restore_version", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Roll a rule back to a prior snapshot (F2.9).", "title": "Logic Restore Version", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id + version_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "logic.list_versions — version_id must exist on logic_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "version_conflict": "logic.diff_versions first — CAS revision mismatch on restore"}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}, "not_found": {"en-US": "Missing id — logic.list / catalog template_id; use logic_id from create/attach", "pt-BR": "Id ausente — logic.list / catalog template_id; use logic_id do create/attach", "ru-RU": "Нет id — logic.list / catalog template_id; logic_id из create/attach"}}, "when_to_use": "Rollback rule body — logic.diff_versions first; expect version conflict CAS.", "write_mode": null}, {"action": "logic.export_json", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.export_json", "related_tools": ["logic.get", "logic.import_json"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Export Json", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "logic.list or logic.get — export needs logic_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Portable rule export — logic.get for logic_id before export."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.export_json", "related_tools": ["logic.get", "logic.import_json"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Export Json", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "logic.list or logic.get — export needs logic_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Portable rule export — logic.get for logic_id before export."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "logic_id required", "not_found": "logic.list or logic.get — export needs logic_id"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Portable rule export — logic.get for logic_id before export.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get", "logic.import_json"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_export_json", "semantic_input_mode": "inherit_workflow", "summary": "Export a logic rule as JSON for backup / cross-project copy.", "title": "Logic Export Json", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "logic.list or logic.get — export needs logic_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}, "not_found": {"en-US": "Missing id — logic.list / catalog template_id; use logic_id from create/attach", "pt-BR": "Id ausente — logic.list / catalog template_id; use logic_id do create/attach", "ru-RU": "Нет id — logic.list / catalog template_id; logic_id из create/attach"}}, "when_to_use": "Portable rule export — logic.get for logic_id before export.", "write_mode": null}, {"action": "logic.import_json", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.import_json", "mutation_risk": "low", "related_tools": ["logic.dry_run", "logic.list", "logic.export_json"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Import Json", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "rule JSON body + logic_id or create path — logic.dry_run after import", "invalid_structure": "logic.get_commands — processor ids must exist in project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Import rule JSON — logic.dry_run after import before enable."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.import_json", "mutation_risk": "low", "related_tools": ["logic.dry_run", "logic.list", "logic.export_json"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Import Json", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "rule JSON body + logic_id or create path — logic.dry_run after import", "invalid_structure": "logic.get_commands — processor ids must exist in project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Import rule JSON — logic.dry_run after import before enable."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"invalid_parameters": "rule JSON body + logic_id or create path — logic.dry_run after import", "invalid_structure": "logic.get_commands — processor ids must exist in project"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Import rule JSON — logic.dry_run after import before enable.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.dry_run", "logic.list", "logic.export_json"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "logic_import_json", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Import a logic rule from JSON (creates a new rule).", "title": "Logic Import Json", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "rule JSON body + logic_id or create path — logic.dry_run after import", "invalid_structure": "logic.get_commands — processor ids must exist in project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}}, "when_to_use": "Import rule JSON — logic.dry_run after import before enable.", "write_mode": null}, {"action": "logic.install_blueprint", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.install_blueprint", "mutation_risk": "low", "related_tools": ["logic.attach_template", "logic.dry_run", "logic.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Install Blueprint", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "blueprint_id + project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "catalog blueprint id — prefer logic.attach_template when id known", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Catalog blueprint install — prefer logic.attach_template when id known."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.install_blueprint", "mutation_risk": "low", "related_tools": ["logic.attach_template", "logic.dry_run", "logic.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Install Blueprint", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "blueprint_id + project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "catalog blueprint id — prefer logic.attach_template when id known", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Catalog blueprint install — prefer logic.attach_template when id known."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"invalid_parameters": "blueprint_id + project_id required", "not_found": "catalog blueprint id — prefer logic.attach_template when id known"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Catalog blueprint install — prefer logic.attach_template when id known.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.attach_template", "logic.dry_run", "logic.list"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "logic_install_blueprint", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Install a catalog blueprint into the project (alias of attach_template with field_values).", "title": "Logic Install Blueprint", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "blueprint_id + project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "catalog blueprint id — prefer logic.attach_template when id known", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}, "not_found": {"en-US": "Missing id — logic.list / catalog template_id; use logic_id from create/attach", "pt-BR": "Id ausente — logic.list / catalog template_id; use logic_id do create/attach", "ru-RU": "Нет id — logic.list / catalog template_id; logic_id из create/attach"}}, "when_to_use": "Catalog blueprint install — prefer logic.attach_template when id known.", "write_mode": null}, {"action": "logic.attach_template", "aliases": ["logic.templates_catalog"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not hand-copy template blocks when attach_template exists for the catalog id.", "anti_patterns": ["Do not hand-copy template blocks when attach_template exists for the catalog id.", "Do not call logic.dry_run with template_id — use logic_id from attach receipt."], "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.attach_template", "mutation_risk": "low", "related_tools": ["logic.dry_run", "logic.list", "logic.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Attach Template", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "logic.list — reuse logic_id or logic.create with template blocks", "invalid_parameters": "context.project_id bound — template_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "template_id from built-in catalog — verify id before attach_template", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Install a catalog template into the project. Save logic_id; logic.dry_run before enable."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.attach_template", "mutation_risk": "low", "related_tools": ["logic.dry_run", "logic.list", "logic.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Attach Template", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "logic.list — reuse logic_id or logic.create with template blocks", "invalid_parameters": "context.project_id bound — template_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "template_id from built-in catalog — verify id before attach_template", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Install a catalog template into the project. Save logic_id; logic.dry_run before enable."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"internal_error": "logic.list — reuse logic_id or logic.create with template blocks", "invalid_parameters": "context.project_id bound — template_id required", "not_found": "template_id from built-in catalog — verify id before attach_template"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Install a catalog template into the project. Save logic_id; logic.dry_run before enable.", "kind": "mcp_domain", "logic_atoms": {"LOGIC_ATTACH_TEMPLATE_CATALOG": "logic.attach_template: template_id from the built-in catalog — wrong id returns not_found; prefer attach_template over hand-copying blocks.", "LOGIC_DRY_RUN_FIRST": "logic.create / logic.attach_template mutations: logic.dry_run with logic_id before enable or production traffic. Disabled rules still dry-run. A space graph with processors must execute; blocks_executed=0 is no_blocks_executed, not success.", "LOGIC_ID_FROM_RECEIPT": "logic.dry_run needs logic_id from logic.create or logic.attach_template receipt — not a rule spec or template_id alone."}, "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.dry_run", "logic.list", "logic.create"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "logic_attach_template", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Install a template from the built-in catalog into the current project.", "title": "Logic Attach Template", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "logic.list — reuse logic_id or logic.create with template blocks", "invalid_parameters": "context.project_id bound — template_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "template_id from built-in catalog — verify id before attach_template", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}, "not_found": {"en-US": "Missing id — logic.list / catalog template_id; use logic_id from create/attach", "pt-BR": "Id ausente — logic.list / catalog template_id; use logic_id do create/attach", "ru-RU": "Нет id — logic.list / catalog template_id; logic_id из create/attach"}}, "when_to_use": "Install a catalog template into the project. Save logic_id; logic.dry_run before enable.", "workflow_ladder": ["context.project_id bound — logic.list or prepare logic.create / logic.attach_template", "logic.create or logic.attach_template — save logic_id from the response receipt", "logic.dry_run with logic_id + command_data/mocks — not template_id or inline spec", "logic.update to enable only after dry_run trace is clean", "logic.list_versions → logic.diff_versions before logic.restore_version"], "write_mode": null}, {"action": "logic.signals_catalog", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.signals_catalog", "related_tools": ["logic.get_commands", "logic.create", "logic.mcp_actions_catalog"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Signals Catalog", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap before wiring triggers", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List signal names for triggers — before logic.create trigger wiring."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.signals_catalog", "related_tools": ["logic.get_commands", "logic.create", "logic.mcp_actions_catalog"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Signals Catalog", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap before wiring triggers", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List signal names for triggers — before logic.create trigger wiring."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "context.project_id bound", "unauthorized": "logic_read cap before wiring triggers"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "List signal names for triggers — before logic.create trigger wiring.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get_commands", "logic.create", "logic.mcp_actions_catalog"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_signals_catalog", "semantic_input_mode": "inherit_workflow", "summary": "List signal channels the logic engine can subscribe to.", "title": "Logic Signals Catalog", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap before wiring triggers", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}}, "when_to_use": "List signal names for triggers — before logic.create trigger wiring.", "write_mode": null}, {"action": "logic.mcp_actions_catalog", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.mcp_actions_catalog", "related_tools": ["logic.get_processors", "logic.get_commands", "logic.signals_catalog"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Mcp Actions Catalog", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap — processor action catalog", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List processor actions available to logic blocks — read-only planning."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.mcp_actions_catalog", "related_tools": ["logic.get_processors", "logic.get_commands", "logic.signals_catalog"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Mcp Actions Catalog", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap — processor action catalog", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List processor actions available to logic blocks — read-only planning."}, "domain": "logic", "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "context.project_id bound", "unauthorized": "logic_read cap — processor action catalog"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "List processor actions available to logic blocks — read-only planning.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get_processors", "logic.get_commands", "logic.signals_catalog"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_mcp_actions_catalog", "semantic_input_mode": "inherit_workflow", "summary": "List MCP actions addressable from logic rules.", "title": "Logic Mcp Actions Catalog", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap — processor action catalog", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_locales": {"invalid_parameters": {"en-US": "Fix params — logic.get_commands / signals_catalog; logic_id from create/attach", "pt-BR": "Corrija params — logic.get_commands / signals_catalog; logic_id do create/attach", "ru-RU": "Исправьте params — logic.get_commands / signals_catalog; logic_id из create/attach"}}, "when_to_use": "List processor actions available to logic blocks — read-only planning.", "write_mode": null}, {"action": "mentor.journal.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.journal.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Journal List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mentor turn journal — prefer knowledge.journal.list."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.journal.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Journal List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mentor turn journal — prefer knowledge.journal.list."}, "domain": "mentor", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Mentor turn journal — prefer knowledge.journal.list.", "mutation_kind": "none", "plane": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "plane_chooser": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "mentor_journal_list", "semantic_input_mode": "inherit_workflow", "summary": "Mentor turn journal — prefer knowledge.journal.list.", "title": "Mentor Journal List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mentor turn journal — prefer knowledge.journal.list.", "write_mode": null}, {"action": "mentor.eval.run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.eval.run", "related_tools": ["knowledge.eval.run", "knowledge.eval.run_all"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Eval Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run single mentor eval — prefer knowledge.eval.run."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.eval.run", "related_tools": ["knowledge.eval.run", "knowledge.eval.run_all"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Eval Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run single mentor eval — prefer knowledge.eval.run."}, "domain": "mentor", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "instruction_hint": "Run single mentor eval — prefer knowledge.eval.run.", "mutation_kind": "entity", "plane": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "plane_chooser": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "related_tools": ["knowledge.eval.run", "knowledge.eval.run_all"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "mentor_eval_run", "semantic_input_mode": "inherit_workflow", "summary": "Run single mentor eval — prefer knowledge.eval.run.", "title": "Mentor Eval Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run single mentor eval — prefer knowledge.eval.run.", "write_mode": null}, {"action": "mentor.eval.retrieval", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.eval.retrieval", "related_tools": ["knowledge.eval.retrieval", "knowledge.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Eval Retrieval", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Retrieval slice eval before knowledge.eval.run_all."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.eval.retrieval", "related_tools": ["knowledge.eval.retrieval", "knowledge.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Eval Retrieval", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Retrieval slice eval before knowledge.eval.run_all."}, "domain": "mentor", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "instruction_hint": "Retrieval slice eval before knowledge.eval.run_all.", "mutation_kind": "none", "plane": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "plane_chooser": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "related_tools": ["knowledge.eval.retrieval", "knowledge.health"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "mentor_eval_retrieval", "semantic_input_mode": "inherit_workflow", "summary": "Retrieval slice eval before knowledge.eval.run_all.", "title": "Mentor Eval Retrieval", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Retrieval slice eval before knowledge.eval.run_all.", "write_mode": null}, {"action": "mentor.eval.run_all", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.eval.run_all", "related_tools": ["knowledge.eval.run_all", "knowledge.eval.retrieval", "generation.gates"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Eval Run All", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Full eval harness — prefer knowledge.eval.run_all."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.eval.run_all", "related_tools": ["knowledge.eval.run_all", "knowledge.eval.retrieval", "generation.gates"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Eval Run All", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Full eval harness — prefer knowledge.eval.run_all."}, "domain": "mentor", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "instruction_hint": "Full eval harness — prefer knowledge.eval.run_all.", "mutation_kind": "none", "plane": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "plane_chooser": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "related_tools": ["knowledge.eval.run_all", "knowledge.eval.retrieval", "generation.gates"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "mentor_eval_run_all", "semantic_input_mode": "inherit_workflow", "summary": "Full eval harness — prefer knowledge.eval.run_all.", "title": "Mentor Eval Run All", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Full eval harness — prefer knowledge.eval.run_all.", "write_mode": null}, {"action": "mentor.export", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.export", "related_tools": ["knowledge.export", "knowledge.import"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Export", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export mentor config — prefer knowledge.export."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.export", "related_tools": ["knowledge.export", "knowledge.import"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Export", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export mentor config — prefer knowledge.export."}, "domain": "mentor", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Export mentor config — prefer knowledge.export.", "mutation_kind": "none", "plane": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "plane_chooser": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "related_tools": ["knowledge.export", "knowledge.import"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "mentor_export", "semantic_input_mode": "inherit_workflow", "summary": "Export mentor config — prefer knowledge.export.", "title": "Mentor Export", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export mentor config — prefer knowledge.export.", "write_mode": null}, {"action": "mentor.principal_link.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.principal_link.upsert", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Principal Link Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Upsert principal link row after bind_code."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.principal_link.upsert", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Principal Link Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Upsert principal link row after bind_code."}, "domain": "mentor", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Upsert principal link row after bind_code.", "mutation_kind": "entity", "plane": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "plane_chooser": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "mentor_principal_link_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Upsert principal link row after bind_code.", "title": "Mentor Principal Link Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Upsert principal link row after bind_code.", "write_mode": null}, {"action": "mentor.principal_link.bind_code", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.principal_link.bind_code", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Principal Link Bind Code", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bind principal/GetCourse link code to user."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.principal_link.bind_code", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Principal Link Bind Code", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bind principal/GetCourse link code to user."}, "domain": "mentor", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Bind principal/GetCourse link code to user.", "mutation_kind": "none", "plane": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "plane_chooser": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "mentor_principal_link_bind_code", "semantic_input_mode": "inherit_workflow", "summary": "Bind principal/GetCourse link code to user.", "title": "Mentor Principal Link Bind Code", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bind principal/GetCourse link code to user.", "write_mode": null}, {"action": "mentor.kb.ingest", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.kb.ingest", "related_tools": ["knowledge.kb.ingest", "knowledge.health", "knowledge.doctor.run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Kb Ingest", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ingest KB for mentor — prefer knowledge.kb.ingest."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.kb.ingest", "related_tools": ["knowledge.kb.ingest", "knowledge.health", "knowledge.doctor.run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Kb Ingest", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ingest KB for mentor — prefer knowledge.kb.ingest."}, "domain": "mentor", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Ingest KB for mentor — prefer knowledge.kb.ingest.", "mutation_kind": "none", "plane": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "plane_chooser": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "related_tools": ["knowledge.kb.ingest", "knowledge.health", "knowledge.doctor.run"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "mentor_kb_ingest", "semantic_input_mode": "inherit_workflow", "summary": "Ingest KB for mentor — prefer knowledge.kb.ingest.", "title": "Mentor Kb Ingest", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ingest KB for mentor — prefer knowledge.kb.ingest.", "write_mode": null}, {"action": "messaging.send_test_email", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.send_test_email", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Send Test Email", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "operation_failed": "messaging.test_connection then messaging.get_config", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: send test email via messaging plane (admin)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.send_test_email", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Send Test Email", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "operation_failed": "messaging.test_connection then messaging.get_config", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: send test email via messaging plane (admin)."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: send test email via messaging plane (admin).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "messaging_send_test_email", "semantic_input_mode": "inherit_workflow", "summary": "Send ecosystem test email (admin).", "title": "Messaging Send Test Email", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "operation_failed": "messaging.test_connection then messaging.get_config", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: send test email via messaging plane (admin).", "write_mode": null}, {"action": "messaging.get_config", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.get_config", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Get Config", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: read Mail Hub config without secrets."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.get_config", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Get Config", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: read Mail Hub config without secrets."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: read Mail Hub config without secrets.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_get_config", "semantic_input_mode": "inherit_workflow", "summary": "Get sanitized ecosystem messaging config (admin).", "title": "Messaging Get Config", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: read Mail Hub config without secrets.", "write_mode": null}, {"action": "messaging.test_connection", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.test_connection", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Test Connection", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "email_channel_not_configured": "messaging.get_config then messaging.put_config", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: verify Resend/SMTP credentials before send."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.test_connection", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Test Connection", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "email_channel_not_configured": "messaging.get_config then messaging.put_config", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: verify Resend/SMTP credentials before send."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: verify Resend/SMTP credentials before send.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_test_connection", "semantic_input_mode": "inherit_workflow", "summary": "Probe configured email provider (admin).", "title": "Messaging Test Connection", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "email_channel_not_configured": "messaging.get_config then messaging.put_config", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: verify Resend/SMTP credentials before send.", "write_mode": null}, {"action": "messaging.send_email", "aliases": ["messaging.send"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Not notifications.deliver — tenant or bot-channel notices; this is ecosystem Mail Hub admin SMTP.", "anti_patterns": ["Not notifications.deliver — tenant or bot-channel notices; this is ecosystem Mail Hub admin SMTP.", "Not a signed-in user's reply. The bot /reply command and POST /api/mail/reply call send_from_mailbox.", "Do not use this to answer Gmail or Microsoft Mail. That is integrations.mailbox op=send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.send_email", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Send Email", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "email_channel_not_configured": "messaging.get_config then messaging.put_config", "forbidden": "auth.get_profile — ecosystem owner required", "invalid_parameters": "Fix template_name, recipient, or template_data", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: send transactional or custom email from ecosystem Mail Hub provider."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.send_email", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Send Email", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "email_channel_not_configured": "messaging.get_config then messaging.put_config", "forbidden": "auth.get_profile — ecosystem owner required", "invalid_parameters": "Fix template_name, recipient, or template_data", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: send transactional or custom email from ecosystem Mail Hub provider."}, "do_not_use_when": "Project-scoped user email — use notifications.deliver.", "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: send transactional or custom email from ecosystem Mail Hub provider.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "recipe_id": "mcp_notify_channels_v1", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "messaging_send_email", "semantic_input_mode": "inherit_workflow", "summary": "Send email to any address (ecosystem admin). Use template_name + template_data for auth templates.", "title": "Messaging Send Email", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "email_channel_not_configured": "messaging.get_config then messaging.put_config", "forbidden": "auth.get_profile — ecosystem owner required", "invalid_parameters": "Fix template_name, recipient, or template_data", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Project-scoped user email — use notifications.deliver.", "when_to_use": "Ops: send transactional or custom email from ecosystem Mail Hub provider.", "write_mode": null}, {"action": "messaging.get_auth_email_readiness", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.get_auth_email_readiness", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Get Auth Email Readiness", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "domain_error": "messaging.test_connection — fix from_address / domain alignment", "email_channel_not_configured": "messaging.put_config — wire provider first", "forbidden": "auth.get_profile — ecosystem owner required", "from_domain_not_verified": "Verify From domain in Resend or change Mail Hub from_address", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_ready": "messaging.get_config then messaging.test_connection", "provider_key_missing": "messaging.put_config — set provider API key / secret", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "test_connection_failed": "messaging.test_connection — fix provider credentials", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: verify confirm-email and password-reset can send before go-live."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.get_auth_email_readiness", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Get Auth Email Readiness", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "domain_error": "messaging.test_connection — fix from_address / domain alignment", "email_channel_not_configured": "messaging.put_config — wire provider first", "forbidden": "auth.get_profile — ecosystem owner required", "from_domain_not_verified": "Verify From domain in Resend or change Mail Hub from_address", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_ready": "messaging.get_config then messaging.test_connection", "provider_key_missing": "messaging.put_config — set provider API key / secret", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "test_connection_failed": "messaging.test_connection — fix provider credentials", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: verify confirm-email and password-reset can send before go-live."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: verify confirm-email and password-reset can send before go-live.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_get_auth_email_readiness", "semantic_input_mode": "inherit_workflow", "summary": "Probe auth email plane — provider secrets, email_confirmation + password_reset + email_otp templates.", "title": "Messaging Get Auth Email Readiness", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "domain_error": "messaging.test_connection — fix from_address / domain alignment", "email_channel_not_configured": "messaging.put_config — wire provider first", "forbidden": "auth.get_profile — ecosystem owner required", "from_domain_not_verified": "Verify From domain in Resend or change Mail Hub from_address", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_ready": "messaging.get_config then messaging.test_connection", "provider_key_missing": "messaging.put_config — set provider API key / secret", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "test_connection_failed": "messaging.test_connection — fix provider credentials", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: verify confirm-email and password-reset can send before go-live.", "write_mode": null}, {"action": "messaging.put_config", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "intermediate", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.put_config", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Put Config", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix channels/templates payload — messaging.get_config for shape"}, "when_to_use": "Ops: Mail Hub config write via MCP (same as PUT /admin/messaging/config)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.put_config", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Put Config", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix channels/templates payload — messaging.get_config for shape"}, "when_to_use": "Ops: Mail Hub config write via MCP (same as PUT /admin/messaging/config)."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: Mail Hub config write via MCP (same as PUT /admin/messaging/config).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_put_config", "semantic_input_mode": "inherit_workflow", "summary": "Update ecosystem messaging config and provider secrets (admin).", "title": "Messaging Put Config", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix channels/templates payload — messaging.get_config for shape"}, "when_to_use": "Ops: Mail Hub config write via MCP (same as PUT /admin/messaging/config).", "write_mode": null}, {"action": "messaging.setup_info", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "Inbound POST /api/mail/inbound/{provider} is not this tool — wire the provider to that URL.", "503 on inbound means in_flight or notify_failed — safe to retry; dedupe prevents duplicate archive."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.setup_info", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Setup Info", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: Resend webhook URLs and env var checklist."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.setup_info", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Setup Info", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: Resend webhook URLs and env var checklist."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: Resend webhook URLs and env var checklist.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_setup_info", "semantic_input_mode": "inherit_workflow", "summary": "Mail Hub setup checklist, webhook URLs, DNS hints (admin).", "title": "Messaging Setup Info", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: Resend webhook URLs and env var checklist.", "write_mode": null}, {"action": "messaging.ensure_auth_templates", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.ensure_auth_templates", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Ensure Auth Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: seed password-reset and confirm-email templates."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.ensure_auth_templates", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Ensure Auth Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: seed password-reset and confirm-email templates."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: seed password-reset and confirm-email templates.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_ensure_auth_templates", "semantic_input_mode": "inherit_workflow", "summary": "Merge auth email templates into ecosystem notifications config (admin).", "title": "Messaging Ensure Auth Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: seed password-reset and confirm-email templates.", "write_mode": null}, {"action": "messaging.get_delivery_health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.get_delivery_health", "related_tools": ["messaging.list_recent_deliveries", "messaging.list_suppressions", "messaging.get_config", "messaging.test_connection", "channels.delivery_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Get Delivery Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: messaging delivery health snapshot."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.get_delivery_health", "related_tools": ["messaging.list_recent_deliveries", "messaging.list_suppressions", "messaging.get_config", "messaging.test_connection", "channels.delivery_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Get Delivery Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: messaging delivery health snapshot."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: messaging delivery health snapshot.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.list_recent_deliveries", "messaging.list_suppressions", "messaging.get_config", "messaging.test_connection", "channels.delivery_status"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_get_delivery_health", "semantic_input_mode": "inherit_workflow", "summary": "Messaging ops status snapshot (admin).", "title": "Messaging Get Delivery Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: messaging delivery health snapshot.", "write_mode": null}, {"action": "messaging.list_recent_deliveries", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.list_recent_deliveries", "related_tools": ["messaging.get_delivery_health", "messaging.list_suppressions", "notifications.delivery_status", "channels.delivery_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging List Recent Deliveries", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: recent delivery log rows for triage."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.list_recent_deliveries", "related_tools": ["messaging.get_delivery_health", "messaging.list_suppressions", "notifications.delivery_status", "channels.delivery_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging List Recent Deliveries", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: recent delivery log rows for triage."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: recent delivery log rows for triage.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.get_delivery_health", "messaging.list_suppressions", "notifications.delivery_status", "channels.delivery_status"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_list_recent_deliveries", "semantic_input_mode": "inherit_workflow", "summary": "Recent messaging delivery log rows (admin).", "title": "Messaging List Recent Deliveries", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: recent delivery log rows for triage.", "write_mode": null}, {"action": "messaging.list_suppressions", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.list_suppressions", "related_tools": ["messaging.remove_suppression", "messaging.get_delivery_health", "messaging.list_recent_deliveries"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging List Suppressions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: list bounce/complaint suppressions."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.list_suppressions", "related_tools": ["messaging.remove_suppression", "messaging.get_delivery_health", "messaging.list_recent_deliveries"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging List Suppressions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: list bounce/complaint suppressions."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: list bounce/complaint suppressions.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.remove_suppression", "messaging.get_delivery_health", "messaging.list_recent_deliveries"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_list_suppressions", "semantic_input_mode": "inherit_workflow", "summary": "List ecosystem email suppression list (bounces/complaints).", "title": "Messaging List Suppressions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: list bounce/complaint suppressions.", "write_mode": null}, {"action": "messaging.remove_suppression", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.remove_suppression", "mutation_risk": "high", "related_tools": ["messaging.list_suppressions", "messaging.get_delivery_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Remove Suppression", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "invalid_parameters": "Valid email address required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "messaging.list_suppressions — email not on list", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: unblock email after deliverability fix."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.remove_suppression", "mutation_risk": "high", "related_tools": ["messaging.list_suppressions", "messaging.get_delivery_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Remove Suppression", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "invalid_parameters": "Valid email address required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "messaging.list_suppressions — email not on list", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: unblock email after deliverability fix."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: unblock email after deliverability fix.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_tools": ["messaging.list_suppressions", "messaging.get_delivery_health"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "low_write", "safe_action": "messaging_remove_suppression", "semantic_input_mode": "inherit_workflow", "summary": "Remove an email from the ecosystem suppression list (admin).", "title": "Messaging Remove Suppression", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "invalid_parameters": "Valid email address required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "messaging.list_suppressions — email not on list", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: unblock email after deliverability fix.", "write_mode": null}, {"action": "messaging.mailbox.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not pass another user's id. The session user is the only mailbox this reads.", "anti_patterns": ["Do not pass another user's id. The session user is the only mailbox this reads.", "Gmail and Microsoft Mail are integrations.mailbox, not this tool.", "Not notifications.deliver — tenant or bot-channel notices, not @agentstack.tech threads."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.get", "related_tools": ["messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.claim", "messaging.mailbox.settings.patch", "messaging.inbox.reply", "messaging.mail.send", "channels.route", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — session required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.get", "related_tools": ["messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.claim", "messaging.mailbox.settings.patch", "messaging.inbox.reply", "messaging.mail.send", "channels.route", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — session required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "do_not_use_when": "Third-party mailbox — integrations.mailbox.oauth_begin.", "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.claim", "messaging.mailbox.settings.patch", "messaging.inbox.reply", "messaging.mail.send", "channels.route", "notifications.list_prefs"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_mailbox_get", "semantic_input_mode": "inherit_workflow", "summary": "Read the signed-in user's @agentstack.tech address, aliases, and notify toggles. Only the mailbox leaf is read. The rest of the profile stays in Postgres.", "title": "Messaging Mailbox Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — session required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Third-party mailbox — integrations.mailbox.oauth_begin.", "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "messaging.mailbox.settings.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Not notifications.deliver — tenant notices, not mailbox toggles.", "anti_patterns": ["Not notifications.deliver — tenant notices, not mailbox toggles.", "Use messaging.mailbox.agent.set for reply_agent_id, not this tool."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.settings.patch", "related_tools": ["messaging.mailbox.get", "channels.route"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Settings Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "Retry; messaging.mailbox.get for current toggles", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Same leaf as REST mailbox settings — not Mail Hub admin config."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.settings.patch", "related_tools": ["messaging.mailbox.get", "channels.route"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Settings Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "Retry; messaging.mailbox.get for current toggles", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Same leaf as REST mailbox settings — not Mail Hub admin config."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Same leaf as REST mailbox settings — not Mail Hub admin config.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "channels.route"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_mailbox_settings_patch", "semantic_input_mode": "inherit_workflow", "summary": "Patch notify toggles on the signed-in mailbox: forward_to_canonical, notify_in_app, notify_push, notify_bots.", "title": "Messaging Mailbox Settings Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "Retry; messaging.mailbox.get for current toggles", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Same leaf as REST mailbox settings — not Mail Hub admin config.", "write_mode": null}, {"action": "messaging.mailbox.agent.set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not call messaging.send_email for the reply. The agent uses messaging.inbox.reply.", "anti_patterns": ["Do not call messaging.send_email for the reply. The agent uses messaging.inbox.reply.", "An empty agent_id turns the gate off. It does not delete the mailbox.", "Do not wait for a reply from this call. The run starts when a new letter arrives."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.agent.set", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "channels.route", "messaging.inbox.reply", "messaging.mailbox.settings.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Agent Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "invalid_parameters": "agent_id / project_id shape", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "messaging.mailbox.get — retry or clear agent gate", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.agent.set", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "channels.route", "messaging.inbox.reply", "messaging.mailbox.settings.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Agent Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "invalid_parameters": "agent_id / project_id shape", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "messaging.mailbox.get — retry or clear agent gate", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "channels.route", "messaging.inbox.reply", "messaging.mailbox.settings.patch"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_mailbox_agent_set", "semantic_input_mode": "inherit_workflow", "summary": "Save or clear the agent id on the signed-in mailbox. A later letter queues that agent. This call does not start a run.", "title": "Messaging Mailbox Agent Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "invalid_parameters": "agent_id / project_id shape", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "messaging.mailbox.get — retry or clear agent gate", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "messaging.mailbox.claim", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Reserved names such as postmaster are rejected. This does not send a letter.", "anti_patterns": ["Reserved names such as postmaster are rejected. This does not send a letter.", "Not notifications.deliver — tenant or bot-channel notices, not @agentstack.tech threads.", "messaging.send_email — ecosystem admin Mail Hub only."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.claim", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mail.send"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Claim", "when_blocked": {"address_taken": "messaging.mailbox.get — pick another local part or release existing claim", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "invalid_parameters": "local part 2–32 chars, letter start", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.claim", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mail.send"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Claim", "when_blocked": {"address_taken": "messaging.mailbox.get — pick another local part or release existing claim", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "invalid_parameters": "local part 2–32 chars, letter start", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "do_not_use_when": "Send or reply — claim first, then mail.send or inbox.reply.", "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mail.send"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_mailbox_claim", "semantic_input_mode": "inherit_workflow", "summary": "Claim local@agentstack.tech for the signed-in user.", "title": "Messaging Mailbox Claim", "when_blocked": {"address_taken": "messaging.mailbox.get — pick another local part or release existing claim", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "invalid_parameters": "local part 2–32 chars, letter start", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Send or reply — claim first, then mail.send or inbox.reply.", "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "messaging.project_mailbox.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Not the signed-in user's primary_address — use messaging.mailbox.get.", "anti_patterns": ["Not the signed-in user's primary_address — use messaging.mailbox.get.", "integrations.mailbox — Gmail/Microsoft OAuth, not @agentstack.tech project slice."], "capability_descriptor": {"complexity": "intermediate", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.messaging.gen1"], "id": "messaging.project_mailbox.get", "related_tools": ["messaging.project_mailbox.claim", "messaging.mailbox.get"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Messaging Project Mailbox Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "projects.get_users — project_read on workspace", "invalid_project": "Bind context.project_id or pass project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before claim or when routing inbound mail to project recipients."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.messaging.gen1"], "id": "messaging.project_mailbox.get", "related_tools": ["messaging.project_mailbox.claim", "messaging.mailbox.get"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Messaging Project Mailbox Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "projects.get_users — project_read on workspace", "invalid_project": "Bind context.project_id or pass project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before claim or when routing inbound mail to project recipients."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Before claim or when routing inbound mail to project recipients.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.project_mailbox.claim", "messaging.mailbox.get"], "required_cap": "project_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_project_mailbox_get", "semantic_input_mode": "inherit_workflow", "summary": "Read the project's shared @agentstack.tech address from the project 8DNA mailbox leaf. REST parity: GET /api/projects/{project_id}/mail/mailbox.", "title": "Messaging Project Mailbox Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "projects.get_users — project_read on workspace", "invalid_project": "Bind context.project_id or pass project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before claim or when routing inbound mail to project recipients.", "write_mode": null}, {"action": "messaging.project_mailbox.claim", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Not for user primary_address — use messaging.mailbox.claim.", "anti_patterns": ["Not for user primary_address — use messaging.mailbox.claim."], "capability_descriptor": {"complexity": "intermediate", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.messaging.gen1"], "id": "messaging.project_mailbox.claim", "related_tools": ["messaging.project_mailbox.get", "messaging.mailbox.claim", "messaging.inbox.list"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Messaging Project Mailbox Claim", "when_blocked": {"address_taken": "messaging.project_mailbox.get — pick another local or another project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project_admin on context.project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Project admin sets a shared inbound address for the project."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.messaging.gen1"], "id": "messaging.project_mailbox.claim", "related_tools": ["messaging.project_mailbox.get", "messaging.mailbox.claim", "messaging.inbox.list"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Messaging Project Mailbox Claim", "when_blocked": {"address_taken": "messaging.project_mailbox.get — pick another local or another project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project_admin on context.project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Project admin sets a shared inbound address for the project."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Project admin sets a shared inbound address for the project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.project_mailbox.get", "messaging.mailbox.claim", "messaging.inbox.list"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_project_mailbox_claim", "semantic_input_mode": "inherit_workflow", "summary": "Claim local@agentstack.tech on the project slice (8DNA data.mailbox). REST parity: POST /api/projects/{project_id}/mail/mailbox. Requires project_admin; recipients receive fanout copies in their user ", "title": "Messaging Project Mailbox Claim", "when_blocked": {"address_taken": "messaging.project_mailbox.get — pick another local or another project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project_admin on context.project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Project admin sets a shared inbound address for the project.", "write_mode": null}, {"action": "messaging.mailbox.alias.add", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not copy the primary address into aliases.", "anti_patterns": ["Do not copy the primary address into aliases."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.alias.add", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Alias Add", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "messaging.mailbox.get — alias cap or invalid local part", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.alias.add", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Alias Add", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "messaging.mailbox.get — alias cap or invalid local part", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.get"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_mailbox_alias_add", "semantic_input_mode": "inherit_workflow", "summary": "Add one alias on the signed-in mailbox. Cap is 5.", "title": "Messaging Mailbox Alias Add", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "messaging.mailbox.get — alias cap or invalid local part", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "messaging.mailbox.alias.remove", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not remove the primary address. This does not delete the mailbox.", "anti_patterns": ["Do not remove the primary address. This does not delete the mailbox."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.alias.remove", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Alias Remove", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "messaging.mailbox.get — alias not on mailbox", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "Retry; cannot remove primary address", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.alias.remove", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Alias Remove", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "messaging.mailbox.get — alias not on mailbox", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "Retry; cannot remove primary address", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.get"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_mailbox_alias_remove", "semantic_input_mode": "inherit_workflow", "summary": "Remove one alias from the signed-in mailbox.", "title": "Messaging Mailbox Alias Remove", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "messaging.mailbox.get — alias not on mailbox", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "Retry; cannot remove primary address", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "messaging.inbox.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not expect html_body. Open messaging.inbox.get for text.", "anti_patterns": ["Do not expect html_body. Open messaging.inbox.get for text.", "Not the Fabric bell dropdown — notifications.inbox_list for hosted notification cards."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.inbox.list", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.inbox.reply", "notifications.inbox_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Inbox List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "invalid_parameters": "limit must be integer 1–20", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.inbox.list", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.inbox.reply", "notifications.inbox_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Inbox List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "invalid_parameters": "limit must be integer 1–20", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["messaging.inbox.get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.inbox.reply", "notifications.inbox_list"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_inbox_list", "semantic_input_mode": "inherit_workflow", "summary": "List inbox cards for the signed-in user. Bodies are not included.", "title": "Messaging Inbox List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "invalid_parameters": "limit must be integer 1–20", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "messaging.inbox.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not expect html_body. The body is plain text.", "anti_patterns": ["Do not expect html_body. The body is plain text."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.inbox.get", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.inbox.reply"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Inbox Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "messaging.inbox.list — pick a valid thread_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.inbox.get", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.inbox.reply"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Inbox Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "messaging.inbox.list — pick a valid thread_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.inbox.reply"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_inbox_get", "semantic_input_mode": "inherit_workflow", "summary": "Read one thread as text for the signed-in user. messages are the oldest 50.", "title": "Messaging Inbox Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "messaging.inbox.list — pick a valid thread_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "messaging.inbox.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Does not delete the thread or bodies in sqlite.", "anti_patterns": ["Does not delete the thread or bodies in sqlite."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.inbox.patch", "related_tools": ["messaging.inbox.list", "messaging.inbox.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Inbox Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "messaging.inbox.list then messaging.inbox.get", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark threads read without loading bodies."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.inbox.patch", "related_tools": ["messaging.inbox.list", "messaging.inbox.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Inbox Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "messaging.inbox.list then messaging.inbox.get", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark threads read without loading bodies."}, "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Mark threads read without loading bodies.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.inbox.list", "messaging.inbox.get"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_inbox_patch", "semantic_input_mode": "inherit_workflow", "summary": "Mark one inbox thread read or unread for the signed-in user.", "title": "Messaging Inbox Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "messaging.inbox.list then messaging.inbox.get", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark threads read without loading bodies.", "write_mode": null}, {"action": "messaging.inbox.reply", "aliases": ["messaging.reply"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Not messaging.send_email. That admin tool does not use the user's From address.", "anti_patterns": ["Not messaging.send_email. That admin tool does not use the user's From address.", "Do not assume the From address is @agentstack.tech when the latest letter came from a connected mailbox.", "Not notifications.deliver — tenant or bot-channel notices, not @agentstack.tech threads."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.inbox.reply", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.agent.set", "integrations.mailbox", "notifications.deliver", "channels.resolve_routing"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Inbox Reply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing": "messaging.inbox.list — no thread to reply to", "not_found": "messaging.inbox.list then messaging.inbox.get — valid thread_id required", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "Retry; if persistent, messaging.mailbox.get and support channel", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.inbox.reply", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.agent.set", "integrations.mailbox", "notifications.deliver", "channels.resolve_routing"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Inbox Reply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing": "messaging.inbox.list — no thread to reply to", "not_found": "messaging.inbox.list then messaging.inbox.get — valid thread_id required", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "Retry; if persistent, messaging.mailbox.get and support channel", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "do_not_use_when": "Project notice to prefs/bots — notifications.deliver.", "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.agent.set", "integrations.mailbox", "notifications.deliver", "channels.resolve_routing"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_inbox_reply", "semantic_input_mode": "inherit_workflow", "summary": "Reply to the latest noticed letter. A connected Gmail or Microsoft mailbox sends when that letter has a connection id. Otherwise the letter goes out from the signed-in @agentstack.tech address.", "title": "Messaging Inbox Reply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing": "messaging.inbox.list — no thread to reply to", "not_found": "messaging.inbox.list then messaging.inbox.get — valid thread_id required", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "Retry; if persistent, messaging.mailbox.get and support channel", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Project notice to prefs/bots — notifications.deliver.", "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "messaging.mail.send", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not pass From. The server sets primary_address.", "anti_patterns": ["Do not pass From. The server sets primary_address.", "Do not use this for Gmail. That is integrations.mailbox op=send.", "Not notifications.deliver — tenant or bot-channel notices, not @agentstack.tech threads."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mail.send", "related_tools": ["messaging.mailbox.get", "messaging.mailbox.claim", "messaging.inbox.reply"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mail Send", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "User mailbox only — not messaging.send_email admin blast", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "messaging.mailbox.get — claim address before send", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mail.send", "related_tools": ["messaging.mailbox.get", "messaging.mailbox.claim", "messaging.inbox.reply"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mail Send", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "User mailbox only — not messaging.send_email admin blast", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "messaging.mailbox.get — claim address before send", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail."}, "do_not_use_when": "Tenant blast to bot channels — notifications.deliver.", "domain": "messaging", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "messaging.mailbox.claim", "messaging.inbox.reply"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_mail_send", "semantic_input_mode": "inherit_workflow", "summary": "Send one letter from the signed-in @agentstack.tech address.", "title": "Messaging Mail Send", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "User mailbox only — not messaging.send_email admin blast", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "messaging.mailbox.get — claim address before send", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Tenant blast to bot channels — notifications.deliver.", "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "notifications.subscribe_push", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.subscribe_push", "related_tools": ["notifications.send_push", "notifications.list_prefs", "web_push.get_health", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Subscribe Push", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — VAPID hint is per signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "VAPID setup hint; client still calls PushManager.subscribe."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.subscribe_push", "related_tools": ["notifications.send_push", "notifications.list_prefs", "web_push.get_health", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Subscribe Push", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — VAPID hint is per signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "VAPID setup hint; client still calls PushManager.subscribe."}, "domain": "notifications", "domain_title": "Notifications MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "VAPID setup hint; client still calls PushManager.subscribe.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.send_push", "notifications.list_prefs", "web_push.get_health", "notifications.deliver"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "notifications_subscribe_push", "semantic_input_mode": "inherit_workflow", "summary": "Returns VAPID status; browser must still call PushManager.subscribe.", "title": "Notifications Subscribe Push", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — VAPID hint is per signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "VAPID setup hint; client still calls PushManager.subscribe.", "write_mode": null}, {"action": "notifications.send_push", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.send_push", "related_tools": ["notifications.subscribe_push", "notifications.list_prefs", "web_push.get_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Send Push", "when_blocked": {"channel_disabled": "notifications.subscribe_push — VAPID not configured or push prefs off", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "quota": "buffs.get_effective_limits — OS push caps; not notification deliver quota", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enqueue OS web push — prefer over deprecated notifications.send."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.send_push", "related_tools": ["notifications.subscribe_push", "notifications.list_prefs", "web_push.get_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Send Push", "when_blocked": {"channel_disabled": "notifications.subscribe_push — VAPID not configured or push prefs off", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "quota": "buffs.get_effective_limits — OS push caps; not notification deliver quota", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enqueue OS web push — prefer over deprecated notifications.send."}, "domain": "notifications", "domain_title": "Notifications MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Enqueue OS web push — prefer over deprecated notifications.send.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.subscribe_push", "notifications.list_prefs", "web_push.get_health"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "notifications_send_push", "semantic_input_mode": "inherit_workflow", "summary": "Enqueue OS web push for a user (self or admin).", "title": "Notifications Send Push", "when_blocked": {"channel_disabled": "notifications.subscribe_push — VAPID not configured or push prefs off", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "quota": "buffs.get_effective_limits — OS push caps; not notification deliver quota", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enqueue OS web push — prefer over deprecated notifications.send.", "write_mode": null}, {"action": "notifications.deliver", "aliases": ["integrations.notify", "notifications.notify", "notifications.send", "notifications.send_bot", "notifications.send_channel", "notifications.send_message", "notifications.send_notification"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Not a reply on the user's @agentstack.tech thread — messaging.inbox.reply.", "anti_patterns": ["Not a reply on the user's @agentstack.tech thread — messaging.inbox.reply.", "Not outbound personal mail from the claimed address — messaging.mail.send.", "Not claiming an address — messaging.mailbox.claim."], "capability_descriptor": {"complexity": "intermediate", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "notifications.deliver", "related_tools": ["channels.resolve_routing", "notifications.list_prefs", "channels.deliver", "channels.list_identities", "channels.delivery_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Deliver", "when_blocked": {"channel_disabled": "notifications.list_prefs — user turned channel off or Mail Hub email is disabled", "channel_not_linked": "channels.create_bind_link — user must complete Telegram bind or /login in bot; not a batch DAG dependency_error", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dependency_error": "Batch DAG: fix the first failed step_id or poll verification_action — not a Telegram binding bug. Standalone deliver: channels.list_identities + user /login in bot for external_user_id", "digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — deliver to another user_id only as project admin", "handle_required": "This key owns several handles. Pass source_agent_id or start the text with @handle.", "invalid_parameters": "title or message required; channels[] via normalize_deliver_channels — discovery.describe. handle_required when this key owns several handles and neither source_agent_id nor @handle is set. Quote-reply on the sent turn routes to the stamped mailbox. Leading @handle on text stamps author only; @OtherHandle in the body wakes that mailbox webhook. Cross-agent mailbox writes use bots.bus.deliver to_handle.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel_target": "bots.list + user /login in the bot — deliver skips channels without external_user_id", "no_eligible_channels": "notifications.list_prefs + notifications.update_prefs — transport/prefs intersection empty; dry_run:true to preview skip_reasons before send", "operation_failed": "channels.delivery_status with correlation_key — provider rejected; check bot token and channel id", "orchestration_step_violation": "preflight.check then notifications.deliver — or follow packet.next_action / inverse_resume; do not call deliver outside the current workflow step allow-list", "prefs_filter_failed": "notifications.list_prefs — corrupt prefs leaf; list_prefs re-seeds plane or fix JSON via update_prefs", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "quota": "buffs.get_effective_limits — project notice caps before retry; not rag_embed_quota or storage_quota", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "source_agent_id or @handle must be a mailbox bound to this API key", "source_not_enrolled": "channels.enroll_source after channels.list_identities — source not enrolled for user", "template_missing": "projects.config.notifications.templates — pass title/message or notifications.register_category with a matching template name", "unauthorized": "auth.get_profile — signed-in user or service key with notify caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Explicit channel list + title/message. deferred status counts as success (quiet hours / digest). Telegram: channels.list_identities — user must /login in bot. dependency_error in a batch means fix an "}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "notifications.deliver", "related_tools": ["channels.resolve_routing", "notifications.list_prefs", "channels.deliver", "channels.list_identities", "channels.delivery_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Deliver", "when_blocked": {"channel_disabled": "notifications.list_prefs — user turned channel off or Mail Hub email is disabled", "channel_not_linked": "channels.create_bind_link — user must complete Telegram bind or /login in bot; not a batch DAG dependency_error", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dependency_error": "Batch DAG: fix the first failed step_id or poll verification_action — not a Telegram binding bug. Standalone deliver: channels.list_identities + user /login in bot for external_user_id", "digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — deliver to another user_id only as project admin", "handle_required": "This key owns several handles. Pass source_agent_id or start the text with @handle.", "invalid_parameters": "title or message required; channels[] via normalize_deliver_channels — discovery.describe. handle_required when this key owns several handles and neither source_agent_id nor @handle is set. Quote-reply on the sent turn routes to the stamped mailbox. Leading @handle on text stamps author only; @OtherHandle in the body wakes that mailbox webhook. Cross-agent mailbox writes use bots.bus.deliver to_handle.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel_target": "bots.list + user /login in the bot — deliver skips channels without external_user_id", "no_eligible_channels": "notifications.list_prefs + notifications.update_prefs — transport/prefs intersection empty; dry_run:true to preview skip_reasons before send", "operation_failed": "channels.delivery_status with correlation_key — provider rejected; check bot token and channel id", "orchestration_step_violation": "preflight.check then notifications.deliver — or follow packet.next_action / inverse_resume; do not call deliver outside the current workflow step allow-list", "prefs_filter_failed": "notifications.list_prefs — corrupt prefs leaf; list_prefs re-seeds plane or fix JSON via update_prefs", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "quota": "buffs.get_effective_limits — project notice caps before retry; not rag_embed_quota or storage_quota", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "source_agent_id or @handle must be a mailbox bound to this API key", "source_not_enrolled": "channels.enroll_source after channels.list_identities — source not enrolled for user", "template_missing": "projects.config.notifications.templates — pass title/message or notifications.register_category with a matching template name", "unauthorized": "auth.get_profile — signed-in user or service key with notify caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Explicit channel list + title/message. deferred status counts as success (quiet hours / digest). Telegram: channels.list_identities — user must /login in bot. dependency_error in a batch means fix an "}, "do_not_use_when": "Standalone deliver does not emit dependency_error — that code is for batch DAG upstream failures only. Use channel_not_linked / channels.create_bind_link.", "domain": "notifications", "domain_title": "Notifications MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Eligibility dry_run (in_app)", "request": {"category": "security", "channels": ["in_app"], "dry_run": true, "message": "No send — dry_run only.", "title": "Reachability check"}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Explicit channel list + title/message. deferred status counts as success (quiet hours / digest). Te…", "kind": "mcp_domain", "mutation_kind": "entity", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deferred": {"description": "True when queued for quiet hours/digest (still success)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "delivery": {"description": "Per-channel delivery envelope", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "dry_run": {"description": "True when dry_run param — no send, eligibility snapshot only", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "eligible_channels": {"description": "dry_run: channel types that would be attempted", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "error_code": {"description": "Machine code when success false (maps to when_blocked keys)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "hint": {"description": "Recovery hint when no channel available", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "mention_preview": {"description": "dry_run: extra @mention mailboxes that would receive mention_wake", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "recipe_id": {"description": "Suggested integration recipe when blocked", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "recovery": {"description": "Next MCP actions (e.g. channels.create_bind_link) when success is false", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "rendered_text": {"description": "dry_run: channel body after bus signature when source_agent_id set", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "skip_reasons": {"description": "dry_run or failed deliver: per-channel block reasons", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "Delivery orchestration finished", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.resolve_routing", "notifications.list_prefs", "channels.deliver", "channels.list_identities", "channels.delivery_status"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "external_side_effect", "rollback": [], "safe_action": "notifications_deliver", "semantic_input_mode": "inherit_workflow", "summary": "Send one notice on email, in-app, web push, webhook, or a bound bot channel (telegram, max, whatsapp, instagram, slack, discord, sms).", "title": "Notifications Deliver", "verification": ["notifications.delivery_status"], "verify": [{"action": "notifications.delivery_status", "predicate": "named resource is visible"}], "when_blocked": {"channel_disabled": "notifications.list_prefs — user turned channel off or Mail Hub email is disabled", "channel_not_linked": "channels.create_bind_link — user must complete Telegram bind or /login in bot; not a batch DAG dependency_error", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dependency_error": "Batch DAG: fix the first failed step_id or poll verification_action — not a Telegram binding bug. Standalone deliver: channels.list_identities + user /login in bot for external_user_id", "digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — deliver to another user_id only as project admin", "handle_required": "This key owns several handles. Pass source_agent_id or start the text with @handle.", "invalid_parameters": "title or message required; channels[] via normalize_deliver_channels — discovery.describe. handle_required when this key owns several handles and neither source_agent_id nor @handle is set. Quote-reply on the sent turn routes to the stamped mailbox. Leading @handle on text stamps author only; @OtherHandle in the body wakes that mailbox webhook. Cross-agent mailbox writes use bots.bus.deliver to_handle.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel_target": "bots.list + user /login in the bot — deliver skips channels without external_user_id", "no_eligible_channels": "notifications.list_prefs + notifications.update_prefs — transport/prefs intersection empty; dry_run:true to preview skip_reasons before send", "operation_failed": "channels.delivery_status with correlation_key — provider rejected; check bot token and channel id", "orchestration_step_violation": "preflight.check then notifications.deliver — or follow packet.next_action / inverse_resume; do not call deliver outside the current workflow step allow-list", "prefs_filter_failed": "notifications.list_prefs — corrupt prefs leaf; list_prefs re-seeds plane or fix JSON via update_prefs", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "quota": "buffs.get_effective_limits — project notice caps before retry; not rag_embed_quota or storage_quota", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "source_agent_id or @handle must be a mailbox bound to this API key", "source_not_enrolled": "channels.enroll_source after channels.list_identities — source not enrolled for user", "template_missing": "projects.config.notifications.templates — pass title/message or notifications.register_category with a matching template name", "unauthorized": "auth.get_profile — signed-in user or service key with notify caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Standalone deliver does not emit dependency_error — that code is for batch DAG upstream failures only. Use channel_not_linked / channels.create_bind_link.", "when_to_use": "Explicit channel list + title/message. deferred status counts as success (quiet hours / digest). Telegram: channels.list_identities — user must /login in bot. dependency_error in a batch means fix an", "write_mode": null}, {"action": "notifications.cancel_push", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.cancel_push", "related_tools": ["notifications.send_push", "web_push.get_health", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Cancel Push", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "correlation_key required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — cancel push is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cancel pending push by correlation_key prefix."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.cancel_push", "related_tools": ["notifications.send_push", "web_push.get_health", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Cancel Push", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "correlation_key required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — cancel push is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cancel pending push by correlation_key prefix."}, "domain": "notifications", "domain_title": "Notifications MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Cancel pending push by correlation_key prefix.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.send_push", "web_push.get_health", "notifications.deliver"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "notifications_cancel_push", "semantic_input_mode": "inherit_workflow", "summary": "Cancel pending push items by correlation key prefix.", "title": "Notifications Cancel Push", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "correlation_key required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — cancel push is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cancel pending push by correlation_key prefix.", "write_mode": null}, {"action": "notifications.list_prefs", "aliases": ["channels.list_prefs", "notifications.config", "notifications.configure"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.list_prefs", "related_tools": ["notifications.update_prefs", "notifications.register_category"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications List Prefs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — prefs snapshot requires signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read messenger + category×channel matrix before update_prefs."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.list_prefs", "related_tools": ["notifications.update_prefs", "notifications.register_category"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications List Prefs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — prefs snapshot requires signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read messenger + category×channel matrix before update_prefs."}, "domain": "notifications", "domain_title": "Notifications MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Read messenger + delivery matrix", "request": {}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Read messenger + category×channel matrix before update_prefs.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.update_prefs", "notifications.register_category"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "notifications_list_prefs", "semantic_input_mode": "inherit_workflow", "summary": "Messenger prefs plus category×channel matrix and enrolled bot sources.", "title": "Notifications List Prefs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — prefs snapshot requires signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read messenger + category×channel matrix before update_prefs.", "write_mode": null}, {"action": "notifications.update_prefs", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not send a full prefs object to flip one checkbox; that replaces the matrix.", "anti_patterns": ["Do not send a full prefs object to flip one checkbox; that replaces the matrix.", "Do not use this to enroll Telegram. Call channels.enroll_source first.", "Do not enable work_graph when the user only asked for mail."], "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.update_prefs", "mutation_risk": "low", "related_tools": ["notifications.list_prefs", "channels.enroll_source", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Update Prefs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "patch object required — {category, channel, enabled} for one cell", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — prefs patch requires signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "notifications.list_prefs — fix category/channel names or messenger keys"}, "when_to_use": "Patch notification prefs matrix for signed-in user."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.update_prefs", "mutation_risk": "low", "related_tools": ["notifications.list_prefs", "channels.enroll_source", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Update Prefs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "patch object required — {category, channel, enabled} for one cell", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — prefs patch requires signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "notifications.list_prefs — fix category/channel names or messenger keys"}, "when_to_use": "Patch notification prefs matrix for signed-in user."}, "domain": "notifications", "domain_title": "Notifications MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Patch notification prefs matrix for signed-in user.", "kind": "mcp_domain", "mutation_kind": "entity", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.list_prefs", "channels.enroll_source", "notifications.deliver"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "notifications_update_prefs", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch messenger prefs and/or category×channel notification matrix. One channel: patch {category, channel, enabled} calls set_category_channel and does not replace the rest of the matrix. work_graph + ", "title": "Notifications Update Prefs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "patch object required — {category, channel, enabled} for one cell", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — prefs patch requires signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "notifications.list_prefs — fix category/channel names or messenger keys"}, "when_to_use": "Patch notification prefs matrix for signed-in user.", "write_mode": null}, {"action": "notifications.register_category", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.register_category", "related_tools": ["notifications.list_prefs", "notifications.send_push", "notifications.update_prefs", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Register Category", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "id and title required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — category registration is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "messenger_prefs_update rejected — compare notifications.list_prefs shape"}, "when_to_use": "Register push category id before send_push campaigns."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.register_category", "related_tools": ["notifications.list_prefs", "notifications.send_push", "notifications.update_prefs", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Register Category", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "id and title required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — category registration is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "messenger_prefs_update rejected — compare notifications.list_prefs shape"}, "when_to_use": "Register push category id before send_push campaigns."}, "domain": "notifications", "domain_title": "Notifications MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Register push category id before send_push campaigns.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.list_prefs", "notifications.send_push", "notifications.update_prefs", "notifications.deliver"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "notifications_register_category", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Register a logical push category in user messenger prefs (persisted).", "title": "Notifications Register Category", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "id and title required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — category registration is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "messenger_prefs_update rejected — compare notifications.list_prefs shape"}, "when_to_use": "Register push category id before send_push campaigns.", "write_mode": null}, {"action": "notifications.inbox_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Fabric bell inbox — not @agentstack.tech email threads.", "anti_patterns": ["Fabric bell inbox — not @agentstack.tech email threads.", "Use messaging.inbox.list and messaging.inbox.get for the Mail Hub."], "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.inbox_list", "related_tools": ["notifications.mark_read", "messaging.inbox.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Inbox List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id required in params or context", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — inbox list requires signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hosted bell dropdown and settings inbox."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.inbox_list", "related_tools": ["notifications.mark_read", "messaging.inbox.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Inbox List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id required in params or context", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — inbox list requires signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hosted bell dropdown and settings inbox."}, "domain": "notifications", "domain_title": "Notifications MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Hosted bell dropdown and settings inbox.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.mark_read", "messaging.inbox.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "notifications_inbox_list", "semantic_input_mode": "inherit_workflow", "summary": "List Fabric in-app inbox rows for a project (parity with GET /api/notifications/{project_id}).", "title": "Notifications Inbox List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id required in params or context", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — inbox list requires signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hosted bell dropdown and settings inbox.", "write_mode": null}, {"action": "notifications.delete_source", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.delete_source", "related_tools": ["channels.delete_source", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Delete Source", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "source_id required — notifications.list_prefs → prefs.delivery.sources", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — source delete is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Profile unenroll — parity with channels.delete_source."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.delete_source", "related_tools": ["channels.delete_source", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Delete Source", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "source_id required — notifications.list_prefs → prefs.delivery.sources", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — source delete is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Profile unenroll — parity with channels.delete_source."}, "domain": "notifications", "domain_title": "Notifications MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Profile unenroll — parity with channels.delete_source.", "kind": "mcp_domain", "mutation_kind": "entity", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.delete_source", "notifications.list_prefs"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "notifications_delete_source", "semantic_input_mode": "inherit_workflow", "summary": "Remove a notification source by id (parity with DELETE notification-sources).", "title": "Notifications Delete Source", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "source_id required — notifications.list_prefs → prefs.delivery.sources", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — source delete is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Profile unenroll — parity with channels.delete_source.", "write_mode": null}, {"action": "notifications.delivery_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": true, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "notifications.delivery_status", "related_tools": ["channels.delivery_status", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Delivery Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — query another user_id only as admin", "invalid_parameters": "correlation_key required — pass key from notifications.deliver result", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "No receipts yet — deliver first or check correlation_key spelling", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After deliver or test ping — same leaf as REST GET /users/me/delivery-status."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": true, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "notifications.delivery_status", "related_tools": ["channels.delivery_status", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Delivery Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — query another user_id only as admin", "invalid_parameters": "correlation_key required — pass key from notifications.deliver result", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "No receipts yet — deliver first or check correlation_key spelling", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After deliver or test ping — same leaf as REST GET /users/me/delivery-status."}, "domain": "notifications", "domain_title": "Notifications MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "After deliver or test ping — same leaf as REST GET /users/me/delivery-status.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.delivery_status", "notifications.deliver"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "notifications_delivery_status", "semantic_input_mode": "inherit_workflow", "summary": "Delivery receipts for a correlation_key (user DNA ring buffer).", "title": "Notifications Delivery Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — query another user_id only as admin", "invalid_parameters": "correlation_key required — pass key from notifications.deliver result", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "No receipts yet — deliver first or check correlation_key spelling", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After deliver or test ping — same leaf as REST GET /users/me/delivery-status.", "write_mode": null}, {"action": "notifications.job_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "notifications.job_status", "related_tools": ["notifications.delivery_status", "bots.bus.send", "discovery.job_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Job Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "job_id required — use outbound_job_id from bots.bus.send/staff_reply or deliver result", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "job_found=false — wrong id or retention expired; use notifications.delivery_status for correlation_key proof", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll outbound_job_id after deliver or bots.bus.send."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "notifications.job_status", "related_tools": ["notifications.delivery_status", "bots.bus.send", "discovery.job_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Job Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "job_id required — use outbound_job_id from bots.bus.send/staff_reply or deliver result", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "job_found=false — wrong id or retention expired; use notifications.delivery_status for correlation_key proof", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll outbound_job_id after deliver or bots.bus.send."}, "domain": "notifications", "domain_title": "Notifications MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Poll outbound_job_id after deliver or bots.bus.send.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.delivery_status", "bots.bus.send", "discovery.job_status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "notifications_job_status", "semantic_input_mode": "inherit_workflow", "summary": "Status of one outbound or deliver work item by job_id.", "title": "Notifications Job Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "job_id required — use outbound_job_id from bots.bus.send/staff_reply or deliver result", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "job_found=false — wrong id or retention expired; use notifications.delivery_status for correlation_key proof", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll outbound_job_id after deliver or bots.bus.send.", "write_mode": null}, {"action": "notifications.send_with_fallback", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Not a reply on the user's @agentstack.tech thread — messaging.inbox.reply.", "anti_patterns": ["Not a reply on the user's @agentstack.tech thread — messaging.inbox.reply.", "Not outbound personal mail from the claimed address — messaging.mail.send.", "Not ecosystem admin SMTP blast — messaging.send_email."], "capability_descriptor": {"complexity": "intermediate", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "notifications.send_with_fallback", "related_tools": ["notifications.deliver", "channels.resolve_routing", "notifications.delivery_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Send With Fallback", "when_blocked": {"channel_disabled": "notifications.list_prefs — user turned channel off or Mail Hub email is disabled", "channel_not_linked": "channels.create_bind_link — user must complete Telegram bind or /login in bot; not a batch DAG dependency_error", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dependency_error": "Batch DAG: fix the first failed step_id or poll verification_action — not a Telegram binding bug. Standalone deliver: channels.list_identities + user /login in bot for external_user_id", "digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — deliver to another user_id only as project admin", "handle_required": "This key owns several handles. Pass source_agent_id or start the text with @handle.", "invalid_parameters": "title or message required; channels[] via normalize_deliver_channels — discovery.describe. handle_required when this key owns several handles and neither source_agent_id nor @handle is set. Quote-reply on the sent turn routes to the stamped mailbox. Leading @handle on text stamps author only; @OtherHandle in the body wakes that mailbox webhook. Cross-agent mailbox writes use bots.bus.deliver to_handle.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel_target": "bots.list + user /login in the bot — deliver skips channels without external_user_id", "no_eligible_channels": "notifications.list_prefs + notifications.update_prefs — transport/prefs intersection empty; dry_run:true to preview skip_reasons before send", "operation_failed": "channels.delivery_status with correlation_key — provider rejected; check bot token and channel id", "orchestration_step_violation": "preflight.check then notifications.deliver — or follow packet.next_action / inverse_resume; do not call deliver outside the current workflow step allow-list", "prefs_filter_failed": "notifications.list_prefs — corrupt prefs leaf; list_prefs re-seeds plane or fix JSON via update_prefs", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "quota": "buffs.get_effective_limits — project notice caps before retry; not rag_embed_quota or storage_quota", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "source_agent_id or @handle must be a mailbox bound to this API key", "source_not_enrolled": "channels.enroll_source after channels.list_identities — source not enrolled for user", "template_missing": "projects.config.notifications.templates — pass title/message or notifications.register_category with a matching template name", "unauthorized": "auth.get_profile — signed-in user or service key with notify caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "OTP and critical alerts when primary channel may be offline."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "notifications.send_with_fallback", "related_tools": ["notifications.deliver", "channels.resolve_routing", "notifications.delivery_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Send With Fallback", "when_blocked": {"channel_disabled": "notifications.list_prefs — user turned channel off or Mail Hub email is disabled", "channel_not_linked": "channels.create_bind_link — user must complete Telegram bind or /login in bot; not a batch DAG dependency_error", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dependency_error": "Batch DAG: fix the first failed step_id or poll verification_action — not a Telegram binding bug. Standalone deliver: channels.list_identities + user /login in bot for external_user_id", "digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — deliver to another user_id only as project admin", "handle_required": "This key owns several handles. Pass source_agent_id or start the text with @handle.", "invalid_parameters": "title or message required; channels[] via normalize_deliver_channels — discovery.describe. handle_required when this key owns several handles and neither source_agent_id nor @handle is set. Quote-reply on the sent turn routes to the stamped mailbox. Leading @handle on text stamps author only; @OtherHandle in the body wakes that mailbox webhook. Cross-agent mailbox writes use bots.bus.deliver to_handle.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel_target": "bots.list + user /login in the bot — deliver skips channels without external_user_id", "no_eligible_channels": "notifications.list_prefs + notifications.update_prefs — transport/prefs intersection empty; dry_run:true to preview skip_reasons before send", "operation_failed": "channels.delivery_status with correlation_key — provider rejected; check bot token and channel id", "orchestration_step_violation": "preflight.check then notifications.deliver — or follow packet.next_action / inverse_resume; do not call deliver outside the current workflow step allow-list", "prefs_filter_failed": "notifications.list_prefs — corrupt prefs leaf; list_prefs re-seeds plane or fix JSON via update_prefs", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "quota": "buffs.get_effective_limits — project notice caps before retry; not rag_embed_quota or storage_quota", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "source_agent_id or @handle must be a mailbox bound to this API key", "source_not_enrolled": "channels.enroll_source after channels.list_identities — source not enrolled for user", "template_missing": "projects.config.notifications.templates — pass title/message or notifications.register_category with a matching template name", "unauthorized": "auth.get_profile — signed-in user or service key with notify caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "OTP and critical alerts when primary channel may be offline."}, "domain": "notifications", "domain_title": "Notifications MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "OTP and critical alerts when primary channel may be offline.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.deliver", "channels.resolve_routing", "notifications.delivery_status"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "notifications_send_with_fallback", "semantic_input_mode": "inherit_workflow", "summary": "Deliver with category fallback chain (security/auth/billing) and in_app escalation when all channels fail. Prefs are read on the server; the profile is not returned.", "title": "Notifications Send With Fallback", "when_blocked": {"channel_disabled": "notifications.list_prefs — user turned channel off or Mail Hub email is disabled", "channel_not_linked": "channels.create_bind_link — user must complete Telegram bind or /login in bot; not a batch DAG dependency_error", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dependency_error": "Batch DAG: fix the first failed step_id or poll verification_action — not a Telegram binding bug. Standalone deliver: channels.list_identities + user /login in bot for external_user_id", "digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — deliver to another user_id only as project admin", "handle_required": "This key owns several handles. Pass source_agent_id or start the text with @handle.", "invalid_parameters": "title or message required; channels[] via normalize_deliver_channels — discovery.describe. handle_required when this key owns several handles and neither source_agent_id nor @handle is set. Quote-reply on the sent turn routes to the stamped mailbox. Leading @handle on text stamps author only; @OtherHandle in the body wakes that mailbox webhook. Cross-agent mailbox writes use bots.bus.deliver to_handle.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel_target": "bots.list + user /login in the bot — deliver skips channels without external_user_id", "no_eligible_channels": "notifications.list_prefs + notifications.update_prefs — transport/prefs intersection empty; dry_run:true to preview skip_reasons before send", "operation_failed": "channels.delivery_status with correlation_key — provider rejected; check bot token and channel id", "orchestration_step_violation": "preflight.check then notifications.deliver — or follow packet.next_action / inverse_resume; do not call deliver outside the current workflow step allow-list", "prefs_filter_failed": "notifications.list_prefs — corrupt prefs leaf; list_prefs re-seeds plane or fix JSON via update_prefs", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "quota": "buffs.get_effective_limits — project notice caps before retry; not rag_embed_quota or storage_quota", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "source_agent_id or @handle must be a mailbox bound to this API key", "source_not_enrolled": "channels.enroll_source after channels.list_identities — source not enrolled for user", "template_missing": "projects.config.notifications.templates — pass title/message or notifications.register_category with a matching template name", "unauthorized": "auth.get_profile — signed-in user or service key with notify caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "OTP and critical alerts when primary channel may be offline.", "write_mode": null}, {"action": "notifications.mark_read", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.mark_read", "related_tools": ["notifications.inbox_list", "messaging.inbox.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Mark Read", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id and notification_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — mark read is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hosted bell mark-as-read."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.mark_read", "related_tools": ["notifications.inbox_list", "messaging.inbox.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Mark Read", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id and notification_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — mark read is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hosted bell mark-as-read."}, "domain": "notifications", "domain_title": "Notifications MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Hosted bell mark-as-read.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.inbox_list", "messaging.inbox.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "notifications_mark_read", "semantic_input_mode": "inherit_workflow", "summary": "Mark one project inbox notification as read (parity with PATCH …/read).", "title": "Notifications Mark Read", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id and notification_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — mark read is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hosted bell mark-as-read.", "write_mode": null}, {"action": "web_push.get_health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "web_push.get_health", "related_tools": ["notifications.subscribe_push", "notifications.send_push", "notifications.cancel_push", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Web Push Get Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — push health is per signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Per-user Web Push VAPID + delivery readiness."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "web_push.get_health", "related_tools": ["notifications.subscribe_push", "notifications.send_push", "notifications.cancel_push", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Web Push Get Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — push health is per signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Per-user Web Push VAPID + delivery readiness."}, "domain": "web_push", "domain_title": "Notifications MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Per-user Web Push VAPID + delivery readiness.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.subscribe_push", "notifications.send_push", "notifications.cancel_push", "notifications.list_prefs"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "web_push_get_health", "semantic_input_mode": "inherit_workflow", "summary": "Per-user Web Push health (same payload as GET /api/push/health): VAPID, canDeliver, subscription/outbox counts, process-local worker stats.", "title": "Web Push Get Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — push health is per signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Per-user Web Push VAPID + delivery readiness.", "write_mode": null}, {"action": "operators.destructive_consent.begin", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "operators", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.operators.gen1"], "id": "operators.destructive_consent.begin", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Operators Destructive Consent Begin", "when_to_use": "Before projects.delete_project, storage.delete_file, or other destructive MCP."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "operators", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.operators.gen1"], "id": "operators.destructive_consent.begin", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Operators Destructive Consent Begin", "when_to_use": "Before projects.delete_project, storage.delete_file, or other destructive MCP."}, "domain": "operators", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Before projects.delete_project, storage.delete_file, or other destructive MCP.", "mutation_kind": "none", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "operators_destructive_consent_begin", "semantic_input_mode": "inherit_workflow", "summary": "Register a human gate for a destructive MCP step. Pair with bots.bus.ask (gate_id in message). After owner taps Yes, call operators.destructive_consent.grant then re-execute the destructive action wit", "title": "Operators Destructive Consent Begin", "when_to_use": "Before projects.delete_project, storage.delete_file, or other destructive MCP.", "write_mode": null}, {"action": "operators.destructive_consent.grant", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "operators", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.operators.gen1"], "id": "operators.destructive_consent.grant", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Operators Destructive Consent Grant", "when_to_use": "After owner answered Yes on bots.bus.ask for the same gate_id."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "operators", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.operators.gen1"], "id": "operators.destructive_consent.grant", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Operators Destructive Consent Grant", "when_to_use": "After owner answered Yes on bots.bus.ask for the same gate_id."}, "domain": "operators", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "After owner answered Yes on bots.bus.ask for the same gate_id.", "mutation_kind": "entity", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "operators_destructive_consent_grant", "semantic_input_mode": "inherit_workflow", "summary": "Mark owner destructive consent granted after Telegram bus Yes.", "title": "Operators Destructive Consent Grant", "when_to_use": "After owner answered Yes on bots.bus.ask for the same gate_id.", "write_mode": null}, {"action": "organelle.execute", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "organelle", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.fabric.organelle_descriptors.gen1", "shared.organelles.gen1"], "id": "organelle.execute", "mutation_risk": "low", "related_tools": ["storage.list_files", "storage.delete_file", "organelle.storage.meta", "organelle.work_queue.meta"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Execute organelle operation", "when_to_use": "Call a registered organelle op through the single dispatch bridge."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "organelle", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.fabric.organelle_descriptors.gen1", "shared.organelles.gen1"], "id": "organelle.execute", "mutation_risk": "low", "related_tools": ["storage.list_files", "storage.delete_file", "organelle.storage.meta", "organelle.work_queue.meta"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Execute organelle operation", "when_to_use": "Call a registered organelle op through the single dispatch bridge."}, "domain": "organelle", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Call a registered organelle op through the single dispatch bridge.", "mutation_kind": "none", "related_tools": ["storage.list_files", "storage.delete_file", "organelle.storage.meta", "organelle.work_queue.meta"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "organelle_execute", "semantic_input_mode": "inherit_workflow", "summary": "Invoke a registered organelle op via dispatch (ring_pool / cell_store today; storage & work_queue via related tools).", "title": "Execute organelle operation", "when_to_use": "Call a registered organelle op through the single dispatch bridge.", "write_mode": null}, {"action": "permissions.effective", "aliases": ["auth.get_effective_permissions", "capabilities.effective"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "permissions.effective", "related_tools": ["rbac.get_roles", "rbac.check_permission", "buffs.get_effective_limits", "data_access.test_mask", "data_access.check_field"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Permissions Effective", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Bind context.project_id (>0) before permissions.effective.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "l1_denied": "l1.allowed=false — widen key preset (apikeys.create) or OAuth scope; compare l1.missing with credential_plane.granted_service_caps.", "limits_blocked": "buffs limits blocked — see denied_reasons and limits object.", "permission_denied": "L2 blocked — rbac.check_permission(admin) for hosting.deploy_files; stale JWT permissions_bitmap (write without admin) vs owner role — redeploy core bitmap_session_reconcile or reconnect OAuth; if l1.allowed but execute fails, stale session bitmap (deploy rbac_allows DNA fallback).", "rbac_unavailable": "rbac.get_roles failed — retry after membership diagnose.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps (apikeys.create presets) for action= probe missing tokens.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile session_ready — then permissions.effective with project_id.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before destructive mutation or agents.update path_updates — understand caps and writable paths."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "permissions.effective", "related_tools": ["rbac.get_roles", "rbac.check_permission", "buffs.get_effective_limits", "data_access.test_mask", "data_access.check_field"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Permissions Effective", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Bind context.project_id (>0) before permissions.effective.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "l1_denied": "l1.allowed=false — widen key preset (apikeys.create) or OAuth scope; compare l1.missing with credential_plane.granted_service_caps.", "limits_blocked": "buffs limits blocked — see denied_reasons and limits object.", "permission_denied": "L2 blocked — rbac.check_permission(admin) for hosting.deploy_files; stale JWT permissions_bitmap (write without admin) vs owner role — redeploy core bitmap_session_reconcile or reconnect OAuth; if l1.allowed but execute fails, stale session bitmap (deploy rbac_allows DNA fallback).", "rbac_unavailable": "rbac.get_roles failed — retry after membership diagnose.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps (apikeys.create presets) for action= probe missing tokens.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile session_ready — then permissions.effective with project_id.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before destructive mutation or agents.update path_updates — understand caps and writable paths."}, "domain": "permissions", "domain_title": "Permissions MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "examples": [{"name": "Hosting deploy L2 probe (slim files)", "request": {"params": {"action": "hosting.deploy_files", "action_params": {"files": [{"bytes": 4096, "path": "docs/index.html"}], "publish": true}, "project_id": 1444}, "tool": "permissions.effective"}, "response": {"data": {"denied_reasons": [], "l2": {"allowed": true, "error_code": null}}, "success": true}}, {"name": "Caps surface without action probe", "request": {"params": {"project_id": 1444}, "tool": "permissions.effective"}, "response": {"data": {"effective_permissions": ["mcp_read", "project_admin"], "role": "owner"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.permissions.gen1"], "instruction_hint": "Before destructive mutation or agents.update path_updates — understand caps and writable paths.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.permissions", "owner_gene": "core.mcp.permissions.gen1", "plane": "Roles: rbac.get_roles.", "plane_chooser": "Field policy is data_access.set_policy, not a new permission table.", "related_tools": ["rbac.get_roles", "rbac.check_permission", "buffs.get_effective_limits", "data_access.test_mask", "data_access.check_field"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "permissions_effective", "semantic_input_mode": "inherit_workflow", "summary": "Effective permission surface: token caps ∩ RBAC role ∩ buff limits. Optional resource + path_prefixes for Field Access Policy write preflight.", "title": "Permissions Effective", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Bind context.project_id (>0) before permissions.effective.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "l1_denied": "l1.allowed=false — widen key preset (apikeys.create) or OAuth scope; compare l1.missing with credential_plane.granted_service_caps.", "limits_blocked": "buffs limits blocked — see denied_reasons and limits object.", "permission_denied": "L2 blocked — rbac.check_permission(admin) for hosting.deploy_files; stale JWT permissions_bitmap (write without admin) vs owner role — redeploy core bitmap_session_reconcile or reconnect OAuth; if l1.allowed but execute fails, stale session bitmap (deploy rbac_allows DNA fallback).", "rbac_unavailable": "rbac.get_roles failed — retry after membership diagnose.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps (apikeys.create presets) for action= probe missing tokens.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile session_ready — then permissions.effective with project_id.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before destructive mutation or agents.update path_updates — understand caps and writable paths.", "write_mode": null}, {"action": "preflight.check", "ai_tips": "Before generation.promote or bulk tenant mutation. Pass semantic_contract or goal_text to probe effect_policy_allowed. For hosting.deploy_files include action_params.publish (default true) so action_risk reflects production_publish without publish_asked. Read action_risk.dry_run_supported — when true, use preflight.simulate or dry_run on the target action instead of a live mutation. read_only_hint means effect probe is read-class. Tenant knowledge batches: simulate_batch_steps (e.g. knowledge.health → knowledge.config.patch) + execution_intent=direct to preview batch_anchor_would_block before agentstack.execute.", "aliases": ["ai_builder.preflight", "authorization.preflight"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "preflight.check", "recovery_blocks": {"work_next_hydrate_failed": {"next_actions": [{"action": "agents.work_next", "params": {"repair": true}}], "reason": "work_next_hydrate_failed"}, "workflow_receipt_context_missing": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_context_missing"}, "workflow_receipt_unbound": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_unbound"}}, "related_tools": ["generation.supply_status", "rbac.check_permission", "discovery.describe", "discovery.search", "agents.work_next", "shop.enablement.status", "shop.checkout.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Preflight Check", "when_blocked": {"auth_required": "Authenticate before preflight — Connect (G-A174), Device Code, or API key; auth.get_profile for session_ready.", "batch_anchor_would_block": "Mutating batch needs options.execution_intent=direct, goal, focus_node_id, or plan_execute_mode — use simulate_batch_actions + execution_intent on preflight.check.", "batch_semantic_anchor_conflict": "Step NL conflicts with batch semantic_contract — align goal_text or use execution_intent=direct.", "batch_semantic_anchor_required": "This step needs a batch semantic anchor — set execution_intent=direct or workflow anchor.", "batch_semantic_goal_mismatch": "Batch goal does not match routed semantic contract.", "budget_exceeded": "Project or user budget cap — buffs.get_effective_limits before retry.", "capability_denied": "Fabric L2 denied — see l2.deny and widen service caps or role.", "conflicting_semantic_anchor": "Conflicting anchors across batch steps — one goal per batch.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "effect_policy_blocked": "Probed action violates goal effect_constraints (read_only / plan_only / no_release).", "fap_denied": "Field access policy denied — adjust FAP or use a role with write access.", "invalid_parameters": "Bind context.project_id and an authenticated user before preflight.check.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "knowledge_collections_unavailable": "buffs.get_effective_limits — knowledge/RAG quota; upgrade plan or reduce collection size.", "permission_denied": "L2 RBAC — permissions.effective action=<tool> (slim action_params, no file bytes); rbac.check_permission(admin) for hosting.deploy_files. If DNA grants but preflight blocks: stale JWT permissions_bitmap — reconnect OAuth or ops bearer with membership hydrate; core needs bitmap_session_reconcile + hydrate_mcp_execute_principal (Wave 7+).", "preflight_batch_internal_error": "Batch preflight could not run — retry once with preflight.check on the same action. If it persists after a backend-only VPS ship, prod substrate may be skewed (hot-sync manifest missing import mates, e.g. shared/mcp/session_readiness.py): -RebuildBackend -DeployComponent backend or complete mcp.prod_matrix_hot_sync, then retry. Not an auth Connect issue until auth.get_profile fails.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "preflight_check_order": "Place preflight.check before mutating steps in agentstack.execute; or list targets in simulate_batch_steps on preflight.check so inline preflight is not duplicated.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_handoff_required": "Bearer or OAuth session_ready before mutation preflight", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_quota_unavailable": "storage.get_quota — project storage cap; delete blobs or upgrade plan.", "unauthorized": "Operator session required — same recovery as auth_required.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "work_next_hydrate_failed": "Work-graph hydrate failed during preflight — run agents.work_next with repair=true and detail=compact before probing mutating shop batches.", "workflow_receipt_context_missing": "Severity warning on preflight when mutation is still allowed. Ops/hosting batches: set options.execution_intent=direct on agentstack.execute — receipt diagnostics are ignored for gate open. Agent playbook: agents.reconcile_binding repair=true; agents.work_next handoff=true detail=compact before mutating.", "workflow_receipt_unbound": "Workflow receipt not bound to session — agents.reconcile_binding repair=true. Ops direct batches may ignore this warning when can_execute_mutation is true."}, "when_to_use": "Before generation.promote or bulk tenant mutation. Pass semantic_contract or goal_text to probe effect_policy_allowed. For hosting.deploy_files include action_params.publish (default true) so action_r"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "preflight.check", "recovery_blocks": {"work_next_hydrate_failed": {"next_actions": [{"action": "agents.work_next", "params": {"repair": true}}], "reason": "work_next_hydrate_failed"}, "workflow_receipt_context_missing": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_context_missing"}, "workflow_receipt_unbound": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_unbound"}}, "related_tools": ["generation.supply_status", "rbac.check_permission", "discovery.describe", "discovery.search", "agents.work_next", "shop.enablement.status", "shop.checkout.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Preflight Check", "when_blocked": {"auth_required": "Authenticate before preflight — Connect (G-A174), Device Code, or API key; auth.get_profile for session_ready.", "batch_anchor_would_block": "Mutating batch needs options.execution_intent=direct, goal, focus_node_id, or plan_execute_mode — use simulate_batch_actions + execution_intent on preflight.check.", "batch_semantic_anchor_conflict": "Step NL conflicts with batch semantic_contract — align goal_text or use execution_intent=direct.", "batch_semantic_anchor_required": "This step needs a batch semantic anchor — set execution_intent=direct or workflow anchor.", "batch_semantic_goal_mismatch": "Batch goal does not match routed semantic contract.", "budget_exceeded": "Project or user budget cap — buffs.get_effective_limits before retry.", "capability_denied": "Fabric L2 denied — see l2.deny and widen service caps or role.", "conflicting_semantic_anchor": "Conflicting anchors across batch steps — one goal per batch.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "effect_policy_blocked": "Probed action violates goal effect_constraints (read_only / plan_only / no_release).", "fap_denied": "Field access policy denied — adjust FAP or use a role with write access.", "invalid_parameters": "Bind context.project_id and an authenticated user before preflight.check.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "knowledge_collections_unavailable": "buffs.get_effective_limits — knowledge/RAG quota; upgrade plan or reduce collection size.", "permission_denied": "L2 RBAC — permissions.effective action=<tool> (slim action_params, no file bytes); rbac.check_permission(admin) for hosting.deploy_files. If DNA grants but preflight blocks: stale JWT permissions_bitmap — reconnect OAuth or ops bearer with membership hydrate; core needs bitmap_session_reconcile + hydrate_mcp_execute_principal (Wave 7+).", "preflight_batch_internal_error": "Batch preflight could not run — retry once with preflight.check on the same action. If it persists after a backend-only VPS ship, prod substrate may be skewed (hot-sync manifest missing import mates, e.g. shared/mcp/session_readiness.py): -RebuildBackend -DeployComponent backend or complete mcp.prod_matrix_hot_sync, then retry. Not an auth Connect issue until auth.get_profile fails.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "preflight_check_order": "Place preflight.check before mutating steps in agentstack.execute; or list targets in simulate_batch_steps on preflight.check so inline preflight is not duplicated.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_handoff_required": "Bearer or OAuth session_ready before mutation preflight", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_quota_unavailable": "storage.get_quota — project storage cap; delete blobs or upgrade plan.", "unauthorized": "Operator session required — same recovery as auth_required.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "work_next_hydrate_failed": "Work-graph hydrate failed during preflight — run agents.work_next with repair=true and detail=compact before probing mutating shop batches.", "workflow_receipt_context_missing": "Severity warning on preflight when mutation is still allowed. Ops/hosting batches: set options.execution_intent=direct on agentstack.execute — receipt diagnostics are ignored for gate open. Agent playbook: agents.reconcile_binding repair=true; agents.work_next handoff=true detail=compact before mutating.", "workflow_receipt_unbound": "Workflow receipt not bound to session — agents.reconcile_binding repair=true. Ops direct batches may ignore this warning when can_execute_mutation is true."}, "when_to_use": "Before generation.promote or bulk tenant mutation. Pass semantic_contract or goal_text to probe effect_policy_allowed. For hosting.deploy_files include action_params.publish (default true) so action_r"}, "domain": "preflight", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "examples": [{"name": "Hosting deploy risk probe (slim files, publish gate)", "request": {"params": {"action": "hosting.deploy_files", "action_params": {"dry_run": true, "files": [{"bytes": 1200, "path": "docs/index.html"}], "publish": true}, "project_id": 1444}, "tool": "preflight.check"}, "response": {"data": {"effect_policy_allowed": true, "fabric_l2": {"allowed": true}}, "success": true}}, {"name": "Slim semantic_contract effect probe", "request": {"params": {"action": "projects.patch_data", "project_id": 1, "semantic_contract": {"effect_constraints": ["read_only"], "fingerprint": "example-fp-read-only", "primary_intent": "analytics.view"}}, "tool": "preflight.check"}, "response": {"data": {"effect_policy_allowed": false, "semantic_contract": {"fingerprint": "example-fp-read-only"}}, "success": true}}, {"name": "Batch anchor preview (simulate_batch_steps)", "request": {"params": {"execution_intent": "direct", "project_id": 1, "simulate_batch_steps": [{"action": "projects.patch_data", "params": {"path": "config.x", "value": 1}}]}, "tool": "preflight.check"}, "response": {"data": {"batch_anchor_would_block": false}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Before generation.promote or bulk tenant mutation. Pass semantic_contract or goal_text to probe eff…", "mutation_kind": "path", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"action_readiness": {"description": "Fleet + effective permissions for probed action", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "action_risk": {"description": "Risk view when action param set; else {}", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "agents": {"description": "work_next_eligible mirror when action probed", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "allowed": {"description": "Backward-compat mirror of can_execute_mutation", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "auth_jwt_project_id": {"description": "JWT-bound project id or null", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "batch_anchor_would_block": {"description": "True when simulate_batch_* would hit batch_semantic_anchor_required", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "blockers": {"description": "Machine codes — permission_denied, fap_denied, session_handoff_required, …", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "blocking": {"description": "Final blocker list; may add preflight_blocked", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "can_execute_mutation": {"description": "Primary gate — session, RBAC, supply, blockers", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "catalog_etag": {"description": "Discovery catalog fingerprint or null", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "effect": {"description": "read | write — only when action param set", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "effect_policy_allowed": {"description": "False when probed action violates goal effect_constraints (plan_only / no_release / read_only)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "execute_context_project_id": {"description": "MCP batch project id or null", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "failure_kind": {"description": "Stable taxonomy when preflight blocks (e.g. entitlement_denied)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "fap_probe": {"description": "path_updates mask probe rows when provided", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "granted": {"description": "RBAC/FAP grant flag", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "instruction_slice": {"description": "Session field glossary for operators", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "l1": {"description": "Fabric L1 cap probe for action", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "l2": {"description": "Fabric L2 policy probe for action", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "limits": {"description": "buffs.get_effective_limits embed when available", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "next_action": {"description": "Operator hint — code, locale, message", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "paths_probed": {"description": "FAP write paths for action_params — only when action set", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "permission_granted": {"description": "Result of optional permission probe", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "permissions": {"description": "RBAC payload when permission param set; else {}", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Logical project id (preflight scope)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "required_client_action": {"description": "none | apply_bearer", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "semantic_contract": {"description": "Optional goal_contract echo when params carry fingerprinted facets", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "session_ready": {"description": "JWT/context or membership OK for mutate", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "simulate_batch_steps": {"description": "Echo of preview steps with optional preflight_step_error_code per row (anchor gate)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "suggested_fix": {"description": "Operator hint when blocked — e.g. effect_policy_blocked", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "supply_status": {"description": "Generation supply snapshot — same shape as generation.supply_status", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "warnings": {"description": "Non-blocking hints — e.g. auto_generation_mode_off", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "workflow_diagnostics": {"description": "Workflow receipt warnings when goal-bound preflight", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Before go-live: preflight.check, then checklist.get.", "plane_chooser": "Before go-live: preflight.check, then checklist.get.", "related_tools": ["generation.supply_status", "rbac.check_permission", "discovery.describe", "discovery.search", "agents.work_next", "shop.enablement.status", "shop.checkout.create"], "requires_preflight": false, "risk_class": "read", "safe_action": "preflight_check", "semantic_input_mode": "inherit_workflow", "summary": "Tenant mutation preflight — supply, limits, optional RBAC permission. instruction_slice follows the request locale.", "title": "Preflight Check", "when_blocked": {"auth_required": "Authenticate before preflight — Connect (G-A174), Device Code, or API key; auth.get_profile for session_ready.", "batch_anchor_would_block": "Mutating batch needs options.execution_intent=direct, goal, focus_node_id, or plan_execute_mode — use simulate_batch_actions + execution_intent on preflight.check.", "batch_semantic_anchor_conflict": "Step NL conflicts with batch semantic_contract — align goal_text or use execution_intent=direct.", "batch_semantic_anchor_required": "This step needs a batch semantic anchor — set execution_intent=direct or workflow anchor.", "batch_semantic_goal_mismatch": "Batch goal does not match routed semantic contract.", "budget_exceeded": "Project or user budget cap — buffs.get_effective_limits before retry.", "capability_denied": "Fabric L2 denied — see l2.deny and widen service caps or role.", "conflicting_semantic_anchor": "Conflicting anchors across batch steps — one goal per batch.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "effect_policy_blocked": "Probed action violates goal effect_constraints (read_only / plan_only / no_release).", "fap_denied": "Field access policy denied — adjust FAP or use a role with write access.", "invalid_parameters": "Bind context.project_id and an authenticated user before preflight.check.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "knowledge_collections_unavailable": "buffs.get_effective_limits — knowledge/RAG quota; upgrade plan or reduce collection size.", "permission_denied": "L2 RBAC — permissions.effective action=<tool> (slim action_params, no file bytes); rbac.check_permission(admin) for hosting.deploy_files. If DNA grants but preflight blocks: stale JWT permissions_bitmap — reconnect OAuth or ops bearer with membership hydrate; core needs bitmap_session_reconcile + hydrate_mcp_execute_principal (Wave 7+).", "preflight_batch_internal_error": "Batch preflight could not run — retry once with preflight.check on the same action. If it persists after a backend-only VPS ship, prod substrate may be skewed (hot-sync manifest missing import mates, e.g. shared/mcp/session_readiness.py): -RebuildBackend -DeployComponent backend or complete mcp.prod_matrix_hot_sync, then retry. Not an auth Connect issue until auth.get_profile fails.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "preflight_check_order": "Place preflight.check before mutating steps in agentstack.execute; or list targets in simulate_batch_steps on preflight.check so inline preflight is not duplicated.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_handoff_required": "Bearer or OAuth session_ready before mutation preflight", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_quota_unavailable": "storage.get_quota — project storage cap; delete blobs or upgrade plan.", "unauthorized": "Operator session required — same recovery as auth_required.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "work_next_hydrate_failed": "Work-graph hydrate failed during preflight — run agents.work_next with repair=true and detail=compact before probing mutating shop batches.", "workflow_receipt_context_missing": "Severity warning on preflight when mutation is still allowed. Ops/hosting batches: set options.execution_intent=direct on agentstack.execute — receipt diagnostics are ignored for gate open. Agent playbook: agents.reconcile_binding repair=true; agents.work_next handoff=true detail=compact before mutating.", "workflow_receipt_unbound": "Workflow receipt not bound to session — agents.reconcile_binding repair=true. Ops direct batches may ignore this warning when can_execute_mutation is true."}, "when_to_use": "Before generation.promote or bulk tenant mutation. Pass semantic_contract or goal_text to probe effect_policy_allowed. For hosting.deploy_files include action_params.publish (default true) so action_r", "write_mode": null}, {"action": "preflight.simulate", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "preflight.simulate", "related_tools": ["permissions.effective", "preflight.check", "rbac.check_permission"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Preflight Simulate", "when_blocked": {"batch_anchor_would_block": "Mutating batch needs options.execution_intent=direct, goal, focus_node_id, or plan_execute_mode — use simulate_batch_actions + execution_intent on preflight.check.", "batch_semantic_anchor_conflict": "Step NL conflicts with batch semantic_contract — align goal_text or use execution_intent=direct.", "batch_semantic_anchor_required": "This step needs a batch semantic anchor — set execution_intent=direct or workflow anchor.", "budget_exceeded": "Project or user budget cap — buffs.get_effective_limits before retry.", "capability_denied": "Fabric L2 denied — see l2.deny and widen service caps or role.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "effect_policy_blocked": "Probed action violates goal effect_constraints (read_only / plan_only / no_release).", "fap_denied": "Field access policy denied — adjust FAP or use a role with write access.", "invalid_parameters": "project_id and action= required for preflight.simulate.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "L2 RBAC — permissions.effective action=<tool> (slim action_params, no file bytes); rbac.check_permission(admin) for hosting.deploy_files. If DNA grants but preflight blocks: stale JWT permissions_bitmap — reconnect OAuth or ops bearer with membership hydrate; core needs bitmap_session_reconcile + hydrate_mcp_execute_principal (Wave 7+).", "preflight_blocked": "See l2.deny — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_handoff_required": "Set context.project_id or auth.switch_project when required_client_action=apply_bearer — session_ready false.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before wiring automation — test PAT/session permissions without executing the action. Pass action_params.publish for hosting.deploy_files so action_risk matches preflight.check. Prefer simulate when a"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "preflight.simulate", "related_tools": ["permissions.effective", "preflight.check", "rbac.check_permission"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Preflight Simulate", "when_blocked": {"batch_anchor_would_block": "Mutating batch needs options.execution_intent=direct, goal, focus_node_id, or plan_execute_mode — use simulate_batch_actions + execution_intent on preflight.check.", "batch_semantic_anchor_conflict": "Step NL conflicts with batch semantic_contract — align goal_text or use execution_intent=direct.", "batch_semantic_anchor_required": "This step needs a batch semantic anchor — set execution_intent=direct or workflow anchor.", "budget_exceeded": "Project or user budget cap — buffs.get_effective_limits before retry.", "capability_denied": "Fabric L2 denied — see l2.deny and widen service caps or role.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "effect_policy_blocked": "Probed action violates goal effect_constraints (read_only / plan_only / no_release).", "fap_denied": "Field access policy denied — adjust FAP or use a role with write access.", "invalid_parameters": "project_id and action= required for preflight.simulate.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "L2 RBAC — permissions.effective action=<tool> (slim action_params, no file bytes); rbac.check_permission(admin) for hosting.deploy_files. If DNA grants but preflight blocks: stale JWT permissions_bitmap — reconnect OAuth or ops bearer with membership hydrate; core needs bitmap_session_reconcile + hydrate_mcp_execute_principal (Wave 7+).", "preflight_blocked": "See l2.deny — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_handoff_required": "Set context.project_id or auth.switch_project when required_client_action=apply_bearer — session_ready false.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before wiring automation — test PAT/session permissions without executing the action. Pass action_params.publish for hosting.deploy_files so action_risk matches preflight.check. Prefer simulate when a"}, "domain": "preflight", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Dry-run with goal_text + slim contract", "request": {"params": {"action": "generation.promote", "goal_text": "promote sandbox to prod", "project_id": 1, "semantic_contract": {"effect_constraints": ["plan_only"], "fingerprint": "example-fp-simulate"}}, "tool": "preflight.simulate"}, "response": {"data": {"effect_policy_allowed": false, "l2": {"allowed": true}}, "success": true}}, {"name": "Tenant IAP checkout dry-run", "request": {"params": {"action": "shop.checkout.create", "action_params": {"idempotency_key": "iap-sim-1", "project_id": 1444, "return_url": "https://agentstack.tech/s/1444/game", "sku_id": "coin_pack_s"}, "goal_text": "visitor IAP checkout", "project_id": 1444}, "tool": "preflight.simulate"}, "response": {"data": {"can_execute_mutation": false, "l2": {"allowed": true}}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Before wiring automation — test PAT/session permissions without executing the action. Pass action_p…", "mutation_kind": "none", "plane": "Before go-live: preflight.check, then checklist.get.", "plane_chooser": "Before go-live: preflight.check, then checklist.get.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_tools": ["permissions.effective", "preflight.check", "rbac.check_permission"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "read", "safe_action": "preflight_simulate", "semantic_input_mode": "inherit_workflow", "summary": "IAM-style dry-run: would this session be allowed to call MCP action X? Returns L1 caps, L2 RBAC, and optional FAP path probe.", "title": "Preflight Simulate", "when_blocked": {"batch_anchor_would_block": "Mutating batch needs options.execution_intent=direct, goal, focus_node_id, or plan_execute_mode — use simulate_batch_actions + execution_intent on preflight.check.", "batch_semantic_anchor_conflict": "Step NL conflicts with batch semantic_contract — align goal_text or use execution_intent=direct.", "batch_semantic_anchor_required": "This step needs a batch semantic anchor — set execution_intent=direct or workflow anchor.", "budget_exceeded": "Project or user budget cap — buffs.get_effective_limits before retry.", "capability_denied": "Fabric L2 denied — see l2.deny and widen service caps or role.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "effect_policy_blocked": "Probed action violates goal effect_constraints (read_only / plan_only / no_release).", "fap_denied": "Field access policy denied — adjust FAP or use a role with write access.", "invalid_parameters": "project_id and action= required for preflight.simulate.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "L2 RBAC — permissions.effective action=<tool> (slim action_params, no file bytes); rbac.check_permission(admin) for hosting.deploy_files. If DNA grants but preflight blocks: stale JWT permissions_bitmap — reconnect OAuth or ops bearer with membership hydrate; core needs bitmap_session_reconcile + hydrate_mcp_execute_principal (Wave 7+).", "preflight_blocked": "See l2.deny — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_handoff_required": "Set context.project_id or auth.switch_project when required_client_action=apply_bearer — session_ready false.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before wiring automation — test PAT/session permissions without executing the action. Pass action_params.publish for hosting.deploy_files so action_risk matches preflight.check. Prefer simulate when a", "write_mode": null}, {"action": "processors.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "processors", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.processors.gen1"], "id": "processors.list", "related_tools": ["processors.get_metadata", "logic.create", "logic.get_processors"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Processors List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "RBAC denied — check project membership and operator role.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Catalog processors before processors.execute."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "processors", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.processors.gen1"], "id": "processors.list", "related_tools": ["processors.get_metadata", "logic.create", "logic.get_processors"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Processors List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "RBAC denied — check project membership and operator role.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Catalog processors before processors.execute."}, "domain": "processors", "domain_title": "Processors MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"insufficient_permissions": "RBAC denied — check project membership and operator role."}, "examples": [{"description": "Get complete list of all processors with their metadata for use in logic rules", "name": "List all available processors", "request": {"params": {}, "tool": "processors.list"}, "response": {"data": {"processors": [{"ai_instructions": "Use this processor to perform mathematical operations on data fields", "capabilities": ["add", "subtract", "multiply", "divide", "compare", "set"], "category": "data_processing", "description": "Mathematical and field operations processor", "examples": [{"action": "add", "field1": "user.balance", "field2": 100, "result_field": "user.balance"}], "input_schema": {"properties": {"action": {"enum": ["add", "subtract", "multiply", "divide", "compare", "set"], "type": "string"}, "field1": {"type": "string"}, "field2": {"type": "string"}, "result_field": {"type": "string"}}, "required": ["action"], "type": "object"}, "name": "field_operations_processor", "output_schema": {"properties": {"result": {"type": "any"}}, "type": "object"}}, {"capabilities": ["get", "create", "update", "delete"], "category": "dna_operations", "description": "DNA CRUD operations processor", "name": "dna_operations_processor"}], "total": 2}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.processors.gen1"], "instruction_hint": "Catalog processors before processors.execute.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.processors", "owner_gene": "core.mcp.processors.gen1", "plane": "App commands: commands.execute. Processor list: processors.list.", "plane_chooser": "App commands: commands.execute. Processor list: processors.list.", "related_tools": ["processors.get_metadata", "logic.create", "logic.get_processors"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "processors_list", "semantic_input_mode": "inherit_workflow", "summary": "List all available processors with their metadata.", "title": "Processors List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "RBAC denied — check project membership and operator role.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Catalog processors before processors.execute.", "write_mode": null}, {"action": "processors.get_metadata", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "processors", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.processors.gen1"], "id": "processors.get_metadata", "related_tools": ["processors.list", "processors.execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Processors Get Metadata", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "processor_name is required — pass canonical name from processors.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "processor_not_found": "processors.list — copy exact processor name into processor_name.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Schema for one processor before wiring logic."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "processors", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.processors.gen1"], "id": "processors.get_metadata", "related_tools": ["processors.list", "processors.execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Processors Get Metadata", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "processor_name is required — pass canonical name from processors.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "processor_not_found": "processors.list — copy exact processor name into processor_name.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Schema for one processor before wiring logic."}, "domain": "processors", "domain_title": "Processors MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "processor_name is required — pass canonical name from processors.list.", "processor_not_found": "processors.list — copy exact processor name into processor_name."}, "examples": [{"description": "Get processor metadata", "request": {"processor_name": "field_operations_processor"}, "response": {"data": {"description": "Mathematical operations", "name": "field_operations_processor"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.processors.gen1"], "instruction_hint": "Schema for one processor before wiring logic.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.processors", "owner_gene": "core.mcp.processors.gen1", "plane": "App commands: commands.execute. Processor list: processors.list.", "plane_chooser": "App commands: commands.execute. Processor list: processors.list.", "related_tools": ["processors.list", "processors.execute"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "processors_get_metadata", "semantic_input_mode": "inherit_workflow", "summary": "Get detailed metadata for a specific processor.", "title": "Processors Get Metadata", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "processor_name is required — pass canonical name from processors.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "processor_not_found": "processors.list — copy exact processor name into processor_name.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Schema for one processor before wiring logic.", "write_mode": null}, {"action": "processors.execute", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "processors", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.processors.gen1"], "id": "processors.execute", "mutation_risk": "low", "related_tools": ["processors.list", "processors.get_metadata", "logic.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Processors Execute", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_failed": "Inspect processor logs; logic.dry_run for rule-level replay.", "invalid_parameters": "processor_name and action required — match get_metadata input_schema.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "processor_not_found": "processors.list — verify processor_name before execute.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Use this tool to test a processor before using it in logic rules"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "processors", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.processors.gen1"], "id": "processors.execute", "mutation_risk": "low", "related_tools": ["processors.list", "processors.get_metadata", "logic.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Processors Execute", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_failed": "Inspect processor logs; logic.dry_run for rule-level replay.", "invalid_parameters": "processor_name and action required — match get_metadata input_schema.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "processor_not_found": "processors.list — verify processor_name before execute.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Use this tool to test a processor before using it in logic rules"}, "domain": "processors", "domain_title": "Processors MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"execution_failed": "Inspect processor logs; logic.dry_run for rule-level replay.", "invalid_parameters": "processor_name and action required — match get_metadata input_schema.", "processor_not_found": "processors.list — verify processor_name before execute."}, "examples": [{"description": "Execute processor to add two numbers", "name": "Execute field operations processor - add", "request": {"params": {"action": "add", "parameters": {"field1": 10, "field2": 5, "result_field": "sum"}, "processor_name": "field_operations_processor"}, "tool": "processors.execute"}, "response": {"data": {"result": 15, "success": true}, "success": true}}, {"description": "Compare two values using processor", "name": "Execute field operations processor - compare", "request": {"params": {"action": "compare", "parameters": {"field1": "user.balance", "field2": 100, "operator": ">="}, "processor_name": "field_operations_processor"}, "tool": "processors.execute"}, "response": {"data": {"result": true, "success": true}, "success": true}}, {"description": "Execute processor to get entity data", "name": "Execute DNA operations processor", "request": {"params": {"action": "get", "parameters": {"entity": "data_projects_8dna", "filters": {"project_id": 123}}, "processor_name": "dna_operations_processor"}, "tool": "processors.execute"}, "response": {"data": {"result": {"id": 123, "name": "My Project"}, "success": true}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.processors.gen1"], "instruction_hint": "Use this tool to test a processor before using it in logic rules", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.processors", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"execution_time_ms": {"description": "float - Execution time in milliseconds (if available)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "result": {"description": "any - Processor execution result. Type depends on processor and action. For field_operations_processor: number (for math operations) or boolean (for compare). For dna_operations_processor: object (entity data). For notification_processor: object with status", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "bool - Whether execution was successful", "type": "boolean"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.processors.gen1", "plane": "App commands: commands.execute. Processor list: processors.list.", "plane_chooser": "App commands: commands.execute. Processor list: processors.list.", "related_tools": ["processors.list", "processors.get_metadata", "logic.create"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "processors_execute", "semantic_input_mode": "inherit_workflow", "summary": "Execute a processor directly.", "title": "Processors Execute", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_failed": "Inspect processor logs; logic.dry_run for rule-level replay.", "invalid_parameters": "processor_name and action required — match get_metadata input_schema.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "processor_not_found": "processors.list — verify processor_name before execute.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Use this tool to test a processor before using it in logic rules", "write_mode": null}, {"action": "projects.get_projects", "aliases": ["projects.list", "projects.list_projects"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Treating not_modified / HTTP 304 as zero workspaces", "Using page count as ecs_index_total"], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_projects", "related_tools": ["projects.get_project", "auth.get_profile", "projects.membership.repair"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Projects", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to list projects", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "projects_list_timeout": "List exceeded server budget — Retry-After; refresh=true or narrower limit", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_unavailable": "Lag shed / temporary overload — retry with smaller limit or refresh_cache", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "User not authenticated", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Default accessible_only=true and refresh=false — prefer ECS accessible_index (list_meta.read_model=ecs_cards, one DNA leaf). refresh=true or refresh_cache after invite/join lag. accessible_only=false "}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_projects", "related_tools": ["projects.get_project", "auth.get_profile", "projects.membership.repair"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Projects", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to list projects", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "projects_list_timeout": "List exceeded server budget — Retry-After; refresh=true or narrower limit", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_unavailable": "Lag shed / temporary overload — retry with smaller limit or refresh_cache", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "User not authenticated", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Default accessible_only=true and refresh=false — prefer ECS accessible_index (list_meta.read_model=ecs_cards, one DNA leaf). refresh=true or refresh_cache after invite/join lag. accessible_only=false "}, "domain": "projects", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve list of all projects the current user has access to", "name": "Get all accessible projects", "request": {"params": {}, "tool": "projects.get_projects"}, "response": {"data": {"count": 1, "projects": [{"config": {}, "created_at": "2025-01-20T10:00:00Z", "description": "Project description", "id": 123, "is_active": true, "name": "My Project", "updated_at": "2025-01-20T10:00:00Z", "user_id": 1}]}, "success": true}}, {"description": "Find projects by name using partial match", "name": "Search projects by name", "request": {"params": {"name": "My Project"}, "tool": "projects.get_projects"}, "response": {"data": {"count": 1, "projects": [{"description": "Project description", "id": 123, "is_active": true, "name": "My Project"}]}, "success": true}}, {"description": "Find projects by searching in both name and description fields", "name": "Search projects by name or description", "request": {"params": {"search": "test"}, "tool": "projects.get_projects"}, "response": {"data": {"count": 1, "projects": [{"description": "This is a test project", "id": 124, "is_active": true, "name": "Test Project"}]}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Default accessible_only=true and refresh=false — prefer ECS accessible_index (list_meta.read_model=…", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_project", "auth.get_profile", "projects.membership.repair"], "required_cap": "mcp_read", "requires_preflight": false, "returns_hint": "projection=summary keeps caller_role/access_tier; total_projects follows ecs_index_total when read_model=ecs_cards; count is page size only.", "risk_class": "read", "safe_action": "projects_get_projects", "semantic_input_mode": "inherit_workflow", "summary": "List workspaces for the signed-in user (summary or full projection, filters, pagination). See when_to_use and list_meta.read_model (ecs_cards, accessible_ids, membership_scan).", "title": "List Projects", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to list projects", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "projects_list_timeout": "List exceeded server budget — Retry-After; refresh=true or narrower limit", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_unavailable": "Lag shed / temporary overload — retry with smaller limit or refresh_cache", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "User not authenticated", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Default accessible_only=true and refresh=false — prefer ECS accessible_index (list_meta.read_model=ecs_cards, one DNA leaf). refresh=true or refresh_cache after invite/join lag. accessible_only=false", "write_mode": null}, {"action": "projects.get_project", "aliases": ["projects.get"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_project", "related_tools": ["projects.get_data", "projects.get_users", "projects.get_stats"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Project", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to access project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project with specified ID not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load project metadata + ids for scoped actions."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_project", "related_tools": ["projects.get_data", "projects.get_users", "projects.get_stats"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Project", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to access project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project with specified ID not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load project metadata + ids for scoped actions."}, "domain": "projects", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Get basic project information", "request": {"project_id": 123}, "response": {"data": {"id": 123, "is_active": true, "name": "My Project"}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Load project metadata + ids for scoped actions.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"config": {"description": "Config leaf or outline from the JSON view. shape says which.", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "counts": {"description": "Nested asset counts when present", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "description": {"description": "Project description", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "id": {"description": "Project ID", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "is_active": {"description": "Whether project is active", "type": "boolean"}, "name": {"description": "Project name", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Logical project id", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "projection": {"description": "summary or full", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "role": {"description": "Caller role in project", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "status": {"description": "Lifecycle status string", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_data", "projects.get_users", "projects.get_stats"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_get_project", "semantic_input_mode": "inherit_workflow", "summary": "Get one project.", "title": "Projects Get Project", "tool_chains": ["rbac_manage_members"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to access project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project with specified ID not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load project metadata + ids for scoped actions.", "write_mode": null}, {"action": "projects.create_project", "aliases": ["projects.create"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["params.project_id or params.id on create", "Using MCP batch context sentinels 999_999_999 as create targets"], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.create_project", "mutation_risk": "low", "related_tools": ["projects.add_user", "apikeys.create", "projects.get_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Create Project", "when_blocked": {"client_supplied_project_id_forbidden": "Remove project_id/id from params — only name, description, settings; allocator is pop_project_id / blanks pool", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "Project creation failed", "idempotency_conflict": "Reuse the same name/body as first call or issue a new idempotency_key", "insufficient_permissions": "Insufficient permissions to create project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "name_required": "Project name is required", "personal_project_cap": "buffs.get_effective_limits + archive or upgrade plan", "reserved_project_id_refused": "python -m scripts.heal_project_id_numbering --report --fix-cursor", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Server allocates project_id via blanks/pop_project_id — never pass params.project_id. Batch context sentinels (999_999_999 / 987_654_321) are read-scope only, not create targets. Tenant ids live in [1"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.create_project", "mutation_risk": "low", "related_tools": ["projects.add_user", "apikeys.create", "projects.get_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Create Project", "when_blocked": {"client_supplied_project_id_forbidden": "Remove project_id/id from params — only name, description, settings; allocator is pop_project_id / blanks pool", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "Project creation failed", "idempotency_conflict": "Reuse the same name/body as first call or issue a new idempotency_key", "insufficient_permissions": "Insufficient permissions to create project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "name_required": "Project name is required", "personal_project_cap": "buffs.get_effective_limits + archive or upgrade plan", "reserved_project_id_refused": "python -m scripts.heal_project_id_numbering --report --fix-cursor", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Server allocates project_id via blanks/pop_project_id — never pass params.project_id. Batch context sentinels (999_999_999 / 987_654_321) are read-scope only, not create targets. Tenant ids live in [1"}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Create a new project with minimal required information", "name": "Create a simple project", "request": {"params": {"description": "Project description", "name": "My New Project"}, "tool": "projects.create_project"}, "response": {"data": {"message": "Project created successfully", "project": {"description": "Project description", "id": 123, "is_active": true, "name": "My New Project"}, "projects": [{"description": "Project description", "id": 123, "is_active": true, "name": "My New Project"}], "success": true}, "success": true}}, {"description": "Create a project with custom settings and configuration", "name": "Create project with settings", "request": {"params": {"description": "Project description", "name": "My New Project", "preset_id": "empty", "settings": {"language": "en", "theme": "dark", "timezone": "UTC"}}, "tool": "projects.create_project"}, "response": {"data": {"message": "Project created successfully", "project": {"description": "Project description", "id": 124, "name": "My New Project"}, "projects": [{"id": 124, "name": "My New Project"}], "success": true}, "success": true}}, {"description": "Replay with same idempotency_key returns the first project", "name": "Idempotent create", "request": {"params": {"idempotency_key": "create-my-workspace-v1", "name": "Stable Name"}, "tool": "projects.create_project"}, "response": {"data": {"project": {"id": 123, "name": "Stable Name"}, "project_id": 123, "success": true}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Server allocates project_id via blanks/pop_project_id — never pass params.project_id. Batch context…", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.add_user", "apikeys.create", "projects.get_project"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "projects_create_project", "semantic_input_mode": "inherit_workflow", "summary": "Create a new project.", "title": "Projects Create Project", "tool_chains": ["multi_tenant_onboarding"], "when_blocked": {"client_supplied_project_id_forbidden": "Remove project_id/id from params — only name, description, settings; allocator is pop_project_id / blanks pool", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "Project creation failed", "idempotency_conflict": "Reuse the same name/body as first call or issue a new idempotency_key", "insufficient_permissions": "Insufficient permissions to create project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "name_required": "Project name is required", "personal_project_cap": "buffs.get_effective_limits + archive or upgrade plan", "reserved_project_id_refused": "python -m scripts.heal_project_id_numbering --report --fix-cursor", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Server allocates project_id via blanks/pop_project_id — never pass params.project_id. Batch context sentinels (999_999_999 / 987_654_321) are read-scope only, not create targets. Tenant ids live in [1", "write_mode": null}, {"action": "projects.create_project_anonymous", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["params.project_id or params.id on create", "Using MCP batch context sentinels 999_999_999 as create targets"], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.create_project_anonymous", "mutation_risk": "low", "related_tools": ["projects.get_project", "apikeys.create", "auth.get_profile", "auth.email_otp.send", "auth.email_otp.login"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Create Project Anonymous", "when_blocked": {"client_supplied_project_id_forbidden": "Anonymous create never accepts logical project_id — server assigns after provision", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "Project creation failed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "name_required": "Project name is required", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Greenfield without login — requires options.bootstrap_ack=true on execute. Save user_api_key once. Convert: purpose=convert OTP with same key, then auth.email_otp.login."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.create_project_anonymous", "mutation_risk": "low", "related_tools": ["projects.get_project", "apikeys.create", "auth.get_profile", "auth.email_otp.send", "auth.email_otp.login"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Create Project Anonymous", "when_blocked": {"client_supplied_project_id_forbidden": "Anonymous create never accepts logical project_id — server assigns after provision", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "Project creation failed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "name_required": "Project name is required", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Greenfield without login — requires options.bootstrap_ack=true on execute. Save user_api_key once. Convert: purpose=convert OTP with same key, then auth.email_otp.login."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Anonymous project with one-time credentials at top level and neutral bootstrap metadata.", "request": {"name": "AI Generated Project"}, "response": {"data": {"bootstrap": {"documentation": "/mcp/ai_prompt#anonymous-bootstrap", "one_time_credentials": true, "preferred_auth": {"field": "user_api_key", "header": "X-API-Key"}}, "project": {"id": 123, "name": "AI Generated Project"}, "project_api_key": "anon_ask_xxx...", "project_id": 123, "session_token": "xxx...", "user_api_key": "anon_ask_xxx...", "user_id": 456}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Greenfield without login — requires options.bootstrap_ack=true on execute. Save user_api_key once. …", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_project", "apikeys.create", "auth.get_profile", "auth.email_otp.send", "auth.email_otp.login"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "projects_create_project_anonymous", "semantic_input_mode": "inherit_workflow", "summary": "Anonymous bootstrap: one-time anon_ask_* key + project_id. Upgrade: auth.email_otp.send purpose=convert with same X-API-Key — no convert tool.", "title": "Projects Create Project Anonymous", "tool_chains": ["user_with_trial", "game_setup", "project_bootstrap"], "when_blocked": {"client_supplied_project_id_forbidden": "Anonymous create never accepts logical project_id — server assigns after provision", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "Project creation failed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "name_required": "Project name is required", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Greenfield without login — requires options.bootstrap_ack=true on execute. Save user_api_key once. Convert: purpose=convert OTP with same key, then auth.email_otp.login.", "write_mode": null}, {"action": "projects.get_data", "aliases": ["dna.data.get", "kv.get", "projects.get_settings", "storage.kv.get"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_data", "related_tools": ["projects.patch_data", "projects.get_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Data", "visitor_callable": true, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "fap_denied": "config.api_keys is restricted — use apikeys.list or admin manage_api_keys; never read key_hash via get_data", "hosted_shared_data_denied": "Hosted players must pass path under config.hosted_mcp.shared_data_prefixes — tenant operator: projects.patch_data config.hosted_mcp → generation.promote", "insufficient_permissions": "Not a project member or DNA read denied", "invalid_parameters": "project_id, path/pagination, or view params invalid", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Start with an outline, then one path or a page. key_after and key_limit page object keys. item_offset pages arrays. offset and max_chars window a string. detail=full raises the byte ceiling. paths kee"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_data", "related_tools": ["projects.patch_data", "projects.get_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Data", "visitor_callable": true, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "fap_denied": "config.api_keys is restricted — use apikeys.list or admin manage_api_keys; never read key_hash via get_data", "hosted_shared_data_denied": "Hosted players must pass path under config.hosted_mcp.shared_data_prefixes — tenant operator: projects.patch_data config.hosted_mcp → generation.promote", "insufficient_permissions": "Not a project member or DNA read denied", "invalid_parameters": "project_id, path/pagination, or view params invalid", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Start with an outline, then one path or a page. key_after and key_limit page object keys. item_offset pages arrays. offset and max_chars window a string. detail=full raises the byte ceiling. paths kee"}, "domain": "projects", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Start with an outline, then one path or a page. key_after and key_limit page object keys. item_offs…", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.patch_data", "projects.get_project"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_get_data", "semantic_input_mode": "inherit_workflow", "summary": "Read project.data without pulling a fat leaf. A path under the byte budget returns that value. A thicker node returns an outline, a key page, an item page, or a text window. detail=full asks for the b", "title": "Projects Get Data", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "fap_denied": "config.api_keys is restricted — use apikeys.list or admin manage_api_keys; never read key_hash via get_data", "hosted_shared_data_denied": "Hosted players must pass path under config.hosted_mcp.shared_data_prefixes — tenant operator: projects.patch_data config.hosted_mcp → generation.promote", "insufficient_permissions": "Not a project member or DNA read denied", "invalid_parameters": "project_id, path/pagination, or view params invalid", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Start with an outline, then one path or a page. key_after and key_limit page object keys. item_offset pages arrays. offset and max_chars window a string. detail=full raises the byte ceiling. paths kee", "write_mode": null}, {"action": "projects.get_my_data", "aliases": ["profile.data.get", "users.me.data", "users.me.get"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_my_data", "related_tools": ["projects.patch_my_data", "projects.get_data"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get My Data", "visitor_callable": true, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Not a project member or DNA read denied", "invalid_parameters": "project_id, path/pagination, or view params invalid", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_required": "MCP OAuth or auth.get_profile required — user_id missing from session", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Private member state (hosted games: games.save via /s/{pid}/mcp). Start with outline, then one path. Shared lobby/config → projects.get_data."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_my_data", "related_tools": ["projects.patch_my_data", "projects.get_data"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get My Data", "visitor_callable": true, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Not a project member or DNA read denied", "invalid_parameters": "project_id, path/pagination, or view params invalid", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_required": "MCP OAuth or auth.get_profile required — user_id missing from session", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Private member state (hosted games: games.save via /s/{pid}/mcp). Start with outline, then one path. Shared lobby/config → projects.get_data."}, "domain": "projects", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Private member state (hosted games: games.save via /s/{pid}/mcp). Start with outline, then one path…", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.patch_my_data", "projects.get_data"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_get_my_data", "semantic_input_mode": "inherit_workflow", "summary": "Read the signed-in member's project data (REST GET /projects/{id}/users/me/data). A path under the byte budget returns that leaf. A thicker node returns an outline or a page. Omit path for top-level n", "title": "Projects Get My Data", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Not a project member or DNA read denied", "invalid_parameters": "project_id, path/pagination, or view params invalid", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_required": "MCP OAuth or auth.get_profile required — user_id missing from session", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Private member state (hosted games: games.save via /s/{pid}/mcp). Start with outline, then one path. Shared lobby/config → projects.get_data.", "write_mode": null}, {"action": "projects.patch_my_data", "ai_tips": "Private member leaf: one path or patches[] (≤16, sequential). ops and expected_sha256 apply to one path. dry_run returns previous_sha256. Shared project.data → projects.patch_data.", "aliases": ["profile.data.set", "users.me.patch"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Patching shared project.data or site HTML — use projects.patch_data or hosting.", "anti_patterns": ["Patching shared project.data or site HTML — use projects.patch_data or hosting.", "Sending a truncated json_view window as value without allow_shrink or search_replace."], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.patch_my_data", "mutation_risk": "low", "related_tools": ["projects.get_my_data", "projects.patch_data"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Patch My Data", "visitor_callable": true, "when_blocked": {"ambiguous_anchor": "Narrow find, set count on the replacement pair, or use projects.get_my_data json_view", "anchor_not_found": "Confirm where/find against projects.get_my_data at the same path", "auth_required": "Hosted member write requires authenticated session — mint hosted cookie or auth.get_profile", "content_shrink_blocked": "projects.get_my_data json_view — search_replace, ops, or allow_shrink=true", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "empty_path": "path must be a non-empty dotted key", "hosted_shared_data_denied": "Shared match journal → projects.patch_data under configured shared_data_prefixes", "index_out_of_range": "List index or move target is out of range", "insufficient_permissions": "project_admin cap or member write — RBAC / buffs.get_effective_limits", "invalid_parameters": "project_id, path, or write_mode invalid", "jsonb_set_scalar_blocked": "Path targets a scalar leaf — cannot SET an object there; use a deeper dotted path or projects.get_data json_view to inspect shape before patch_data.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "leaf_path_invalid": "Bracket paths do not support ops batch", "not_a_member": "projects.join or invite flow before patch_my_data", "patch_apply_failed": "GET leaf text; retry unified_diff or strict_diff on ops", "patch_too_large": "Smaller unified_diff or search_replace ops", "plan_graph_coarse_ecosystem_patch_refused": "Coarse ecosystem/orchestrator merge with task_list forbidden — patch leaf ecosystem.orchestrator.task_list or use agents.plan_patch / plan_heal_leaf", "plan_graph_ops_refused": "Plan graph DNA leaves require agents.plan_patch — not projects.patch_data ops[]", "plan_ops_text_mode": "Text op needs replacements, find/replace, or unified_diff", "replacement_not_found": "Confirm find at path via projects.get_my_data", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "shallow_leaf_replace_blocked": "Deeper dotted path or merge — projects.get_my_data data.keys_lost", "stackscript_plane_routed": "Match runtime DNA → script.run on public_run export, not patch_my_data", "text_anchor_miss": "Fuzzy anchor did not match; narrow find", "text_revision_conflict": "projects.get_my_data for leaf_sha256, then retry ops with expected_sha256", "too_many_paths": "At most 16 leaves; ops and expected_sha256 apply to one path only", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "Read shape hint — narrow path or fix bracket-path refusal", "write_mode_invalid": "Use replace | merge | append | prepend per leaf shape", "write_mode_unsupported": "Dict leaves need merge fragment, not append — projects.get_my_data json_view"}, "when_to_use": "Private member leaf (hosted games.save): one path or patches[] (≤16). Shared lobby → projects.patch_data."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.patch_my_data", "mutation_risk": "low", "related_tools": ["projects.get_my_data", "projects.patch_data"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Patch My Data", "visitor_callable": true, "when_blocked": {"ambiguous_anchor": "Narrow find, set count on the replacement pair, or use projects.get_my_data json_view", "anchor_not_found": "Confirm where/find against projects.get_my_data at the same path", "auth_required": "Hosted member write requires authenticated session — mint hosted cookie or auth.get_profile", "content_shrink_blocked": "projects.get_my_data json_view — search_replace, ops, or allow_shrink=true", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "empty_path": "path must be a non-empty dotted key", "hosted_shared_data_denied": "Shared match journal → projects.patch_data under configured shared_data_prefixes", "index_out_of_range": "List index or move target is out of range", "insufficient_permissions": "project_admin cap or member write — RBAC / buffs.get_effective_limits", "invalid_parameters": "project_id, path, or write_mode invalid", "jsonb_set_scalar_blocked": "Path targets a scalar leaf — cannot SET an object there; use a deeper dotted path or projects.get_data json_view to inspect shape before patch_data.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "leaf_path_invalid": "Bracket paths do not support ops batch", "not_a_member": "projects.join or invite flow before patch_my_data", "patch_apply_failed": "GET leaf text; retry unified_diff or strict_diff on ops", "patch_too_large": "Smaller unified_diff or search_replace ops", "plan_graph_coarse_ecosystem_patch_refused": "Coarse ecosystem/orchestrator merge with task_list forbidden — patch leaf ecosystem.orchestrator.task_list or use agents.plan_patch / plan_heal_leaf", "plan_graph_ops_refused": "Plan graph DNA leaves require agents.plan_patch — not projects.patch_data ops[]", "plan_ops_text_mode": "Text op needs replacements, find/replace, or unified_diff", "replacement_not_found": "Confirm find at path via projects.get_my_data", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "shallow_leaf_replace_blocked": "Deeper dotted path or merge — projects.get_my_data data.keys_lost", "stackscript_plane_routed": "Match runtime DNA → script.run on public_run export, not patch_my_data", "text_anchor_miss": "Fuzzy anchor did not match; narrow find", "text_revision_conflict": "projects.get_my_data for leaf_sha256, then retry ops with expected_sha256", "too_many_paths": "At most 16 leaves; ops and expected_sha256 apply to one path only", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "Read shape hint — narrow path or fix bracket-path refusal", "write_mode_invalid": "Use replace | merge | append | prepend per leaf shape", "write_mode_unsupported": "Dict leaves need merge fragment, not append — projects.get_my_data json_view"}, "when_to_use": "Private member leaf (hosted games.save): one path or patches[] (≤16). Shared lobby → projects.patch_data."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Private member leaf (hosted games.save): one path or patches[] (≤16). Shared lobby → projects.patch…", "mutation_kind": "path", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_my_data", "projects.patch_data"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "projects_patch_my_data", "semantic_input_mode": "inherit_workflow", "summary": "Leaf write on the signed-in member's project data (REST PATCH /projects/{id}/users/me/data). write_mode replace sets the path; merge overlays an object. String leaves: value={replacements} or unified_", "title": "Projects Patch My Data", "when_blocked": {"ambiguous_anchor": "Narrow find, set count on the replacement pair, or use projects.get_my_data json_view", "anchor_not_found": "Confirm where/find against projects.get_my_data at the same path", "auth_required": "Hosted member write requires authenticated session — mint hosted cookie or auth.get_profile", "content_shrink_blocked": "projects.get_my_data json_view — search_replace, ops, or allow_shrink=true", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "empty_path": "path must be a non-empty dotted key", "hosted_shared_data_denied": "Shared match journal → projects.patch_data under configured shared_data_prefixes", "index_out_of_range": "List index or move target is out of range", "insufficient_permissions": "project_admin cap or member write — RBAC / buffs.get_effective_limits", "invalid_parameters": "project_id, path, or write_mode invalid", "jsonb_set_scalar_blocked": "Path targets a scalar leaf — cannot SET an object there; use a deeper dotted path or projects.get_data json_view to inspect shape before patch_data.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "leaf_path_invalid": "Bracket paths do not support ops batch", "not_a_member": "projects.join or invite flow before patch_my_data", "patch_apply_failed": "GET leaf text; retry unified_diff or strict_diff on ops", "patch_too_large": "Smaller unified_diff or search_replace ops", "plan_graph_coarse_ecosystem_patch_refused": "Coarse ecosystem/orchestrator merge with task_list forbidden — patch leaf ecosystem.orchestrator.task_list or use agents.plan_patch / plan_heal_leaf", "plan_graph_ops_refused": "Plan graph DNA leaves require agents.plan_patch — not projects.patch_data ops[]", "plan_ops_text_mode": "Text op needs replacements, find/replace, or unified_diff", "replacement_not_found": "Confirm find at path via projects.get_my_data", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "shallow_leaf_replace_blocked": "Deeper dotted path or merge — projects.get_my_data data.keys_lost", "stackscript_plane_routed": "Match runtime DNA → script.run on public_run export, not patch_my_data", "text_anchor_miss": "Fuzzy anchor did not match; narrow find", "text_revision_conflict": "projects.get_my_data for leaf_sha256, then retry ops with expected_sha256", "too_many_paths": "At most 16 leaves; ops and expected_sha256 apply to one path only", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "Read shape hint — narrow path or fix bracket-path refusal", "write_mode_invalid": "Use replace | merge | append | prepend per leaf shape", "write_mode_unsupported": "Dict leaves need merge fragment, not append — projects.get_my_data json_view"}, "when_to_use": "Private member leaf (hosted games.save): one path or patches[] (≤16). Shared lobby → projects.patch_data.", "write_mode": ["replace", "write", "set", "put", "merge", "patch", "delete", "search_replace", "fuzzy_replace", "unified_diff", "append", "prepend"], "write_mode_note": "Member-private leaf SET/merge/delete. Same string editor, ops batch, and dry_run as projects.patch_data (read ladder: projects.get_my_data)."}, {"action": "projects.patch_data", "ai_tips": "Write up to 16 nested leaves (patches[]), or bare path + value; ops batch (≤16) applies to exactly one dot path (not with multi-leaf patches). Default write_mode is replace at the path leaf — appending to a string leaf requires write_mode append or prepend (replace wipes the whole string). Partial dict overlays need write_mode merge (or deeper path). Omitted write_mode on dict leaves may infer merge when both sides are non-empty objects. Use expected_sha256 from dry_run for CAS; same MCP batch may use expected_sha256=from_batch_preview on commit after a dry_run step. patches[] plain replace SET (2+ dot paths, prod slice) uses one atomic txn; other batches are sequential with partial commit on fail-fast. Bracket", "aliases": ["dna.data.set", "projects.update_settings"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Putting bot_spec.commands or knowledge markdown into projects.update_project data.", "anti_patterns": ["Putting bot_spec.commands or knowledge markdown into projects.update_project data.", "Loading the whole project.data blob to change one key.", "Patching config.knowledge.* — use knowledge.config.patch or knowledge.phenotype.upsert."], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.patch_data", "mutation_risk": "low", "related_tools": ["projects.get_data", "projects.get_project", "script.put", "script.docs", "knowledge.config.patch", "knowledge.phenotype.upsert"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Projects Patch Data", "visitor_callable": true, "when_blocked": {"ambiguous_anchor": "Narrow find, set count on the replacement pair, or use projects.get_data json_view", "anchor_not_found": "Confirm where/find against projects.get_data at the same path", "auth_required": "Hosted journal write needs signed-in player — bootstrapHostedPlayerSession", "content_shrink_blocked": "projects.get_data json_view — search_replace, ops, or allow_shrink=true", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "empty_path": "path must be a non-empty dotted key", "generation_fork_required": "generation.fork or omit env_uuid when auto_generation_mode auto-forks", "hosted_shared_data_denied": "Path outside shared_data_prefixes — tenant sets config.hosted_mcp via promote; or use script.run public_run for runtime match leaves", "index_out_of_range": "List index or move target is out of range", "invalid_parameters": "path, ops shape, or write_mode invalid", "jsonb_set_scalar_blocked": "Path targets a scalar leaf — cannot SET an object there; use a deeper dotted path or projects.get_data json_view to inspect shape before patch_data.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "leaf_path_invalid": "ops need a dot path; bracket SET is ok without ops — projects.get_data json_view", "not_a_member": "Grant project write role for multiplayer journal or use script.run Lane B", "patch_apply_failed": "GET leaf text; retry unified_diff or strict_diff on ops", "patch_too_large": "Smaller unified_diff or search_replace ops", "plan_graph_coarse_ecosystem_patch_refused": "Use path ecosystem.orchestrator.task_list with merge/replace, or agents.plan_patch", "plan_graph_ops_refused": "Use agents.plan_patch for task_list / agents.plan.* leaves", "plan_ops_text_mode": "Text op needs replacements, find/replace, or unified_diff", "replacement_not_found": "Confirm find at path via projects.get_data", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "shallow_leaf_replace_blocked": "Partial dict at a shallow path would drop sibling keys — use write_mode=merge, a deeper dotted path, or ops[]; read data.keys_lost on the error envelope", "stackscript_plane_routed": "ecosystem.scripts.* is StackScript plane — script.put → script.test → script.dry_run → script.publish; not projects.patch_data", "text_anchor_miss": "Fuzzy anchor did not match; narrow find or use json_view", "text_revision_conflict": "projects.get_data or dry_run preview previous_sha256, then commit with expected_sha256", "too_many_paths": "ops apply to one path only — use patches[] for multi-leaf SET without ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "Read shape hint — narrow path or fix bracket-path refusal", "write_mode_invalid": "Unknown write_mode", "write_mode_unsupported": "merge requires an object at the path; append/prepend only on list or string leaves — for dict leaves (e.g. stream_relay room settings) use write_mode=merge with a fragment, not append; shallow paths use deeper dotted keys or ops[]"}, "when_to_use": "Write up to 16 nested leaves (patches[]), or bare path + value; ops batch (≤16) applies to exactly one dot path (not with multi-leaf patches). Default write_mode is replace at the path leaf — appendin"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.patch_data", "mutation_risk": "low", "related_tools": ["projects.get_data", "projects.get_project", "script.put", "script.docs", "knowledge.config.patch", "knowledge.phenotype.upsert"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Projects Patch Data", "visitor_callable": true, "when_blocked": {"ambiguous_anchor": "Narrow find, set count on the replacement pair, or use projects.get_data json_view", "anchor_not_found": "Confirm where/find against projects.get_data at the same path", "auth_required": "Hosted journal write needs signed-in player — bootstrapHostedPlayerSession", "content_shrink_blocked": "projects.get_data json_view — search_replace, ops, or allow_shrink=true", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "empty_path": "path must be a non-empty dotted key", "generation_fork_required": "generation.fork or omit env_uuid when auto_generation_mode auto-forks", "hosted_shared_data_denied": "Path outside shared_data_prefixes — tenant sets config.hosted_mcp via promote; or use script.run public_run for runtime match leaves", "index_out_of_range": "List index or move target is out of range", "invalid_parameters": "path, ops shape, or write_mode invalid", "jsonb_set_scalar_blocked": "Path targets a scalar leaf — cannot SET an object there; use a deeper dotted path or projects.get_data json_view to inspect shape before patch_data.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "leaf_path_invalid": "ops need a dot path; bracket SET is ok without ops — projects.get_data json_view", "not_a_member": "Grant project write role for multiplayer journal or use script.run Lane B", "patch_apply_failed": "GET leaf text; retry unified_diff or strict_diff on ops", "patch_too_large": "Smaller unified_diff or search_replace ops", "plan_graph_coarse_ecosystem_patch_refused": "Use path ecosystem.orchestrator.task_list with merge/replace, or agents.plan_patch", "plan_graph_ops_refused": "Use agents.plan_patch for task_list / agents.plan.* leaves", "plan_ops_text_mode": "Text op needs replacements, find/replace, or unified_diff", "replacement_not_found": "Confirm find at path via projects.get_data", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "shallow_leaf_replace_blocked": "Partial dict at a shallow path would drop sibling keys — use write_mode=merge, a deeper dotted path, or ops[]; read data.keys_lost on the error envelope", "stackscript_plane_routed": "ecosystem.scripts.* is StackScript plane — script.put → script.test → script.dry_run → script.publish; not projects.patch_data", "text_anchor_miss": "Fuzzy anchor did not match; narrow find or use json_view", "text_revision_conflict": "projects.get_data or dry_run preview previous_sha256, then commit with expected_sha256", "too_many_paths": "ops apply to one path only — use patches[] for multi-leaf SET without ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "Read shape hint — narrow path or fix bracket-path refusal", "write_mode_invalid": "Unknown write_mode", "write_mode_unsupported": "merge requires an object at the path; append/prepend only on list or string leaves — for dict leaves (e.g. stream_relay room settings) use write_mode=merge with a fragment, not append; shallow paths use deeper dotted keys or ops[]"}, "when_to_use": "Write up to 16 nested leaves (patches[]), or bare path + value; ops batch (≤16) applies to exactly one dot path (not with multi-leaf patches). Default write_mode is replace at the path leaf — appendin"}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Single leaf replace on project.data (bind context.project_id)", "name": "Replace config leaf", "request": {"path": "config.theme", "value": "dark", "write_mode": "replace"}}], "execution_class": "cheap", "instruction_hint": "Write up to 16 nested leaves (patches[]), or bare path + value; ops batch (≤16) applies to exactly …", "mutation_kind": "path", "onboarding_tier": "bootstrap", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"dry_run": {"description": "true when preview only (ops or leaf write_mode)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "leaf_sha256": {"description": "Digest of leaf after preview or write", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "next_actions": {"description": "When dry_run: suggested projects.patch_data commit with expected_sha256", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "path": {"description": "Written path", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "previous_sha256": {"description": "Digest of leaf before preview (use as expected_sha256 on commit)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Project ID", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "Write accepted", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "write": {"description": "Mode diagnostic (merge/replace/delete/ops)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "writes": {"description": "When patches[] has 2+ leaves: per-leaf results (sequential; partial commit on fail-fast)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_data", "projects.get_project", "script.put", "script.docs", "knowledge.config.patch", "knowledge.phenotype.upsert"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["generation.realign_to_prod"], "safe_action": "projects_patch_data", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Leaf SET on project.data (REST PATCH /projects/{id}/data). write_mode=replace sets the path; merge overlays an object; delete removes it. Or ops (≤16) on one path: merge, search_replace, insert_before", "title": "Projects Patch Data", "tool_chains": ["crud_with_logic"], "verification": ["projects.get_data"], "verify": [{"action": "projects.get_data", "predicate": "named resource is visible"}], "when_blocked": {"ambiguous_anchor": "Narrow find, set count on the replacement pair, or use projects.get_data json_view", "anchor_not_found": "Confirm where/find against projects.get_data at the same path", "auth_required": "Hosted journal write needs signed-in player — bootstrapHostedPlayerSession", "content_shrink_blocked": "projects.get_data json_view — search_replace, ops, or allow_shrink=true", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "empty_path": "path must be a non-empty dotted key", "generation_fork_required": "generation.fork or omit env_uuid when auto_generation_mode auto-forks", "hosted_shared_data_denied": "Path outside shared_data_prefixes — tenant sets config.hosted_mcp via promote; or use script.run public_run for runtime match leaves", "index_out_of_range": "List index or move target is out of range", "invalid_parameters": "path, ops shape, or write_mode invalid", "jsonb_set_scalar_blocked": "Path targets a scalar leaf — cannot SET an object there; use a deeper dotted path or projects.get_data json_view to inspect shape before patch_data.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "leaf_path_invalid": "ops need a dot path; bracket SET is ok without ops — projects.get_data json_view", "not_a_member": "Grant project write role for multiplayer journal or use script.run Lane B", "patch_apply_failed": "GET leaf text; retry unified_diff or strict_diff on ops", "patch_too_large": "Smaller unified_diff or search_replace ops", "plan_graph_coarse_ecosystem_patch_refused": "Use path ecosystem.orchestrator.task_list with merge/replace, or agents.plan_patch", "plan_graph_ops_refused": "Use agents.plan_patch for task_list / agents.plan.* leaves", "plan_ops_text_mode": "Text op needs replacements, find/replace, or unified_diff", "replacement_not_found": "Confirm find at path via projects.get_data", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "shallow_leaf_replace_blocked": "Partial dict at a shallow path would drop sibling keys — use write_mode=merge, a deeper dotted path, or ops[]; read data.keys_lost on the error envelope", "stackscript_plane_routed": "ecosystem.scripts.* is StackScript plane — script.put → script.test → script.dry_run → script.publish; not projects.patch_data", "text_anchor_miss": "Fuzzy anchor did not match; narrow find or use json_view", "text_revision_conflict": "projects.get_data or dry_run preview previous_sha256, then commit with expected_sha256", "too_many_paths": "ops apply to one path only — use patches[] for multi-leaf SET without ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "Read shape hint — narrow path or fix bracket-path refusal", "write_mode_invalid": "Unknown write_mode", "write_mode_unsupported": "merge requires an object at the path; append/prepend only on list or string leaves — for dict leaves (e.g. stream_relay room settings) use write_mode=merge with a fragment, not append; shallow paths use deeper dotted keys or ops[]"}, "when_to_use": "Write up to 16 nested leaves (patches[]), or bare path + value; ops batch (≤16) applies to exactly one dot path (not with multi-leaf patches). Default write_mode is replace at the path leaf — appendin", "write_mode": ["replace", "write", "set", "put", "merge", "patch", "delete", "search_replace", "fuzzy_replace", "unified_diff", "append", "prepend"], "write_mode_note": "Leaf path SET (REST PATCH /projects/{id}/data). write_mode=replace sets the path; merge overlays an object; delete removes it. String leaves: search_replace / unified_diff or ops batch on one path. patches[]: sequential leaves; 2+ plain replace SET may use one atomic txn. ops and dry_run apply to one path only."}, {"action": "projects.get_notify_policy", "aliases": ["projects.notify_policy"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1", "core.messaging.channel_plane.gen1"], "id": "projects.get_notify_policy", "related_tools": ["projects.put_notify_policy", "channels.resolve_routing"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Notify Policy", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before put_notify_policy or generation.diff — inspect mandatory categories and bot allowlist."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1", "core.messaging.channel_plane.gen1"], "id": "projects.get_notify_policy", "related_tools": ["projects.put_notify_policy", "channels.resolve_routing"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Notify Policy", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before put_notify_policy or generation.diff — inspect mandatory categories and bot allowlist."}, "domain": "projects", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Before put_notify_policy or generation.diff — inspect mandatory categories and bot allowlist.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.put_notify_policy", "channels.resolve_routing"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_get_notify_policy", "semantic_input_mode": "inherit_workflow", "summary": "Read project.data.notify_policy (channel plane tenant defaults).", "title": "Projects Get Notify Policy", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before put_notify_policy or generation.diff — inspect mandatory categories and bot allowlist.", "write_mode": null}, {"action": "projects.put_notify_policy", "ai_tips": "Tenant notify policy edits in safe generation cycle → diff → gates → promote.", "aliases": ["projects.configure_notifications"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1", "core.messaging.channel_plane.gen1"], "id": "projects.put_notify_policy", "mutation_risk": "low", "related_tools": ["projects.get_notify_policy", "generation.diff_vs_prod", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Put Notify Policy", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_fork_required": "generation.fork or omit env_uuid when auto_generation_mode auto-forks", "invalid_parameters": "patch object is required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Tenant notify policy edits in safe generation cycle → diff → gates → promote."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1", "core.messaging.channel_plane.gen1"], "id": "projects.put_notify_policy", "mutation_risk": "low", "related_tools": ["projects.get_notify_policy", "generation.diff_vs_prod", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Put Notify Policy", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_fork_required": "generation.fork or omit env_uuid when auto_generation_mode auto-forks", "invalid_parameters": "patch object is required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Tenant notify policy edits in safe generation cycle → diff → gates → promote."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Tenant notify policy edits in safe generation cycle → diff → gates → promote.", "mutation_kind": "path", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_notify_policy", "generation.diff_vs_prod", "generation.promote"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "projects_put_notify_policy", "semantic_input_mode": "inherit_workflow", "summary": "Merge patch into project.data.notify_policy. Paid tenants with auto_generation_mode require env_uuid (sandbox anchor).", "title": "Projects Put Notify Policy", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_fork_required": "generation.fork or omit env_uuid when auto_generation_mode auto-forks", "invalid_parameters": "patch object is required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Tenant notify policy edits in safe generation cycle → diff → gates → promote.", "write_mode": null}, {"action": "projects.update_project", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Putting bot_spec.commands or knowledge markdown into data.", "anti_patterns": ["Putting bot_spec.commands or knowledge markdown into data.", "Using this instead of projects.patch_data for one nested key."], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.update_project", "mutation_risk": "low", "related_tools": ["projects.get_project", "projects.create_project", "projects.patch_data"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Update Project", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to update project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update project name/description/is_active. Nested JSON leaves → projects.patch_data."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.update_project", "mutation_risk": "low", "related_tools": ["projects.get_project", "projects.create_project", "projects.patch_data"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Update Project", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to update project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update project name/description/is_active. Nested JSON leaves → projects.patch_data."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Update project name", "request": {"name": "Updated Name", "project_id": 123}, "response": {"data": {"id": 123, "name": "Updated Name"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Update project name/description/is_active. Nested JSON leaves → projects.patch_data.", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_project", "projects.create_project", "projects.patch_data"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "projects_update_project", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Update an existing project.", "title": "Projects Update Project", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to update project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update project name/description/is_active. Nested JSON leaves → projects.patch_data.", "write_mode": null}, {"action": "projects.delete_project", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.delete_project", "mutation_risk": "high", "related_tools": ["projects.get_project", "projects.create_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Delete Project", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to delete project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Irreversible workspace delete — confirm id twice."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.delete_project", "mutation_risk": "high", "related_tools": ["projects.get_project", "projects.create_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Delete Project", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to delete project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Irreversible workspace delete — confirm id twice."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "examples": [{"description": "Delete a project", "request": {"project_id": 123}, "response": {"data": {"deleted": true, "project_id": 123}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Irreversible workspace delete — confirm id twice.", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_project", "projects.create_project"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "projects_delete_project", "semantic_input_mode": "inherit_workflow", "summary": "Delete a project (PSDP).", "title": "Projects Delete Project", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to delete project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Irreversible workspace delete — confirm id twice.", "write_mode": null}, {"action": "projects.get_deletion_inventory", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_deletion_inventory", "related_tools": ["projects.delete_project", "projects.schedule_deletion"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Deletion Inventory", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project owner only — use a project_id you own (projects.get_projects) before PSDP inventory", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate via Connect or auth.get_profile first", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "PSDP pre-delete inventory — project owner only. Call only for context.project_id you own (verify via projects.get_projects caller_role=owner). Do not sweep every project_id from a list probe; use reci"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_deletion_inventory", "related_tools": ["projects.delete_project", "projects.schedule_deletion"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Deletion Inventory", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project owner only — use a project_id you own (projects.get_projects) before PSDP inventory", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate via Connect or auth.get_profile first", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "PSDP pre-delete inventory — project owner only. Call only for context.project_id you own (verify via projects.get_projects caller_role=owner). Do not sweep every project_id from a list probe; use reci"}, "domain": "projects", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "PSDP pre-delete inventory — project owner only. Call only for context.project_id you own (verify vi…", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.delete_project", "projects.schedule_deletion"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_get_deletion_inventory", "semantic_input_mode": "inherit_workflow", "summary": "Pre-delete inventory: blockers, warnings, and execution_token for safe delete.", "title": "Projects Get Deletion Inventory", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project owner only — use a project_id you own (projects.get_projects) before PSDP inventory", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate via Connect or auth.get_profile first", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "PSDP pre-delete inventory — project owner only. Call only for context.project_id you own (verify via projects.get_projects caller_role=owner). Do not sweep every project_id from a list probe; use reci", "write_mode": null}, {"action": "projects.schedule_deletion", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.schedule_deletion", "related_tools": ["projects.get_deletion_inventory", "projects.execute_deletion"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Schedule Deletion", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After get_deletion_inventory with execution_token — grace-period PSDP schedule."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.schedule_deletion", "related_tools": ["projects.get_deletion_inventory", "projects.execute_deletion"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Schedule Deletion", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After get_deletion_inventory with execution_token — grace-period PSDP schedule."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "After get_deletion_inventory with execution_token — grace-period PSDP schedule.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_deletion_inventory", "projects.execute_deletion"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "projects_schedule_deletion", "semantic_input_mode": "inherit_workflow", "summary": "Schedule project deletion after inventory + execution token.", "title": "Projects Schedule Deletion", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After get_deletion_inventory with execution_token — grace-period PSDP schedule.", "write_mode": null}, {"action": "projects.execute_deletion", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.execute_deletion", "related_tools": ["projects.get_deletion_inventory", "projects.schedule_deletion"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Execute Deletion", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After schedule_deletion or inventory token — hard delete when blockers are zero."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.execute_deletion", "related_tools": ["projects.get_deletion_inventory", "projects.schedule_deletion"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Execute Deletion", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After schedule_deletion or inventory token — hard delete when blockers are zero."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "After schedule_deletion or inventory token — hard delete when blockers are zero.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_deletion_inventory", "projects.schedule_deletion"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "projects_execute_deletion", "semantic_input_mode": "inherit_workflow", "summary": "Execute scheduled or immediate deletion with execution token.", "title": "Projects Execute Deletion", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After schedule_deletion or inventory token — hard delete when blockers are zero.", "write_mode": null}, {"action": "projects.get_stats", "aliases": ["analytics.get", "projects.get_activity"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_stats", "related_tools": ["projects.get_project", "projects.get_users"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Stats", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to view stats", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Member count and project status. API-call and storage counters are not on this card."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_stats", "related_tools": ["projects.get_project", "projects.get_users"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Stats", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to view stats", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Member count and project status. API-call and storage counters are not on this card."}, "domain": "projects", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Signed-in member count and status", "request": {"project_id": 123}, "response": {"data": {"project_id": 123, "status": "active", "timestamp": "2026-10-08T12:00:00+00:00", "users_count": 5}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Member count and project status. API-call and storage counters are not on this card.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_project", "projects.get_users"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_get_stats", "semantic_input_mode": "inherit_workflow", "summary": "Get project statistics.", "title": "Projects Get Stats", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to view stats", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Member count and project status. API-call and storage counters are not on this card.", "write_mode": null}, {"action": "projects.get_users", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_users", "related_tools": ["projects.get_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Users", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to view users", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Membership source of truth. If auth.get_profile mutation_allowed is true, do not call auth.switch_project. projects.get_projects is not membership."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_users", "related_tools": ["projects.get_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Users", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to view users", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Membership source of truth. If auth.get_profile mutation_allowed is true, do not call auth.switch_project. projects.get_projects is not membership."}, "domain": "projects", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Get project users", "request": {"project_id": 123}, "response": {"data": {"count": 1, "project_id": 123, "users": [{"created_at": "2025-01-20T10:00:00Z", "display_name": "Ada", "email": "user@example.com", "is_active": true, "last_login": null, "role": "admin", "user_id": 1, "username": "ada"}]}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Membership source of truth. If auth.get_profile mutation_allowed is true, do not call auth.switch_p…", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_project"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_get_users", "semantic_input_mode": "inherit_workflow", "summary": "Get list of users in a project.", "title": "Projects Get Users", "tool_chains": ["apply_custom_buff_to_user", "rbac_manage_members"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to view users", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Membership source of truth. If auth.get_profile mutation_allowed is true, do not call auth.switch_project. projects.get_projects is not membership.", "write_mode": null}, {"action": "projects.join", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.join", "related_tools": ["agents.work_next", "agents.graph_health", "agents.plan_get", "projects.membership.repair", "buffs.get_effective_limits", "auth.switch_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Join", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "email_verification_required": "Verify email before joining", "invalid_parameters": "project_id required on projects.join", "join_not_allowed": "config.membership.join_policy is not open — use projects.add_user / invite flow", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "member_cap_reached": "Hub member cap reached — buffs.get_effective_limits on project entity", "project_not_found": "Confirm project_id via projects.get_projects", "rate_limited": "Too many join attempts — honor Retry-After then retry projects.join", "rbac_assign_failed": "Membership row rolled back — projects.membership.repair then auth.switch_project", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Session user required — auth.login or operator Connect", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Self-join when config.membership.join_policy is open. Idempotent for members. Then agents.work_next with home=project_self on the same project_id."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.join", "related_tools": ["agents.work_next", "agents.graph_health", "agents.plan_get", "projects.membership.repair", "buffs.get_effective_limits", "auth.switch_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Join", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "email_verification_required": "Verify email before joining", "invalid_parameters": "project_id required on projects.join", "join_not_allowed": "config.membership.join_policy is not open — use projects.add_user / invite flow", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "member_cap_reached": "Hub member cap reached — buffs.get_effective_limits on project entity", "project_not_found": "Confirm project_id via projects.get_projects", "rate_limited": "Too many join attempts — honor Retry-After then retry projects.join", "rbac_assign_failed": "Membership row rolled back — projects.membership.repair then auth.switch_project", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Session user required — auth.login or operator Connect", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Self-join when config.membership.join_policy is open. Idempotent for members. Then agents.work_next with home=project_self on the same project_id."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Open hub join — recipe mcp_community_hub_v1 (graph_health, heal if spill) then agents.work_next home=project_self or mcp_work_loop_v1", "request": {"project_id": 123}, "response": {"data": {"project_id": 123, "role": "member", "status": "joined", "user_id": 42, "work_graph_path": "/user/projects/123/work-graph?home=project_self"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Self-join when config.membership.join_policy is open. Idempotent for members. Then agents.work_next…", "mutation_kind": "none", "next_recipes": ["mcp_community_hub_v1", "mcp_work_loop_v1"], "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["agents.work_next", "agents.graph_health", "agents.plan_get", "projects.membership.repair", "buffs.get_effective_limits", "auth.switch_project"], "required_cap": "mcp_write", "requires_preflight": false, "returns_hint": "data.status joined|already_member, role, project_id, user_id, work_graph_path — then recipe mcp_community_hub_v1 spine: auth.switch_project, agents.graph_health, agents.plan_heal_leaf when spill_incomplete, agents.work_next home=project_self.", "risk_class": "low_write", "safe_action": "projects_join", "semantic_input_mode": "inherit_workflow", "summary": "Join an open community project as the authenticated session user.", "title": "Projects Join", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "email_verification_required": "Verify email before joining", "invalid_parameters": "project_id required on projects.join", "join_not_allowed": "config.membership.join_policy is not open — use projects.add_user / invite flow", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "member_cap_reached": "Hub member cap reached — buffs.get_effective_limits on project entity", "project_not_found": "Confirm project_id via projects.get_projects", "rate_limited": "Too many join attempts — honor Retry-After then retry projects.join", "rbac_assign_failed": "Membership row rolled back — projects.membership.repair then auth.switch_project", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Session user required — auth.login or operator Connect", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Self-join when config.membership.join_policy is open. Idempotent for members. Then agents.work_next with home=project_self on the same project_id.", "write_mode": null}, {"action": "projects.leave", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.leave", "related_tools": ["projects.get_projects", "projects.join"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Leave", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "owner_cannot_leave": "Transfer ownership before leaving", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Self-remove membership. Billing owner cannot leave — transfer ownership first."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.leave", "related_tools": ["projects.get_projects", "projects.join"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Leave", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "owner_cannot_leave": "Transfer ownership before leaving", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Self-remove membership. Billing owner cannot leave — transfer ownership first."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Self-remove membership; billing owner must transfer ownership first", "request": {"project_id": 123}, "response": {"data": {"project_id": 123, "status": "left", "user_id": 42}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Self-remove membership. Billing owner cannot leave — transfer ownership first.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_projects", "projects.join"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "projects_leave", "semantic_input_mode": "inherit_workflow", "summary": "Leave a project as the authenticated session user (self-remove membership).", "title": "Projects Leave", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "owner_cannot_leave": "Transfer ownership before leaving", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Self-remove membership. Billing owner cannot leave — transfer ownership first.", "write_mode": null}, {"action": "projects.add_user", "aliases": ["projects.attach_to_user"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.add_user", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Add User", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dry_run_not_supported": "This action has no dry_run. Omit the key; the call writes membership.", "insufficient_permissions": "Owner/manage_users required, or Launch+ project plan (user_management) when caller is not ecosystem. Personal Premium/VIP does not unlock team management. Operators: context.project_id=1.", "invalid_parameters": "user_id is required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "member_cap_reached": "Project member cap or billing user limit reached — buffs.get_effective_limits", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "The key cannot manage members of this project.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_already_in_project": "User already in project"}, "when_to_use": "Membership write. dry_run is rejected (dry_run_not_supported). Attach a user by user_id. Ecosystem operators use context.project_id=1 and params.project_id for the tenant. Resolve id via social.users."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.add_user", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Add User", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dry_run_not_supported": "This action has no dry_run. Omit the key; the call writes membership.", "insufficient_permissions": "Owner/manage_users required, or Launch+ project plan (user_management) when caller is not ecosystem. Personal Premium/VIP does not unlock team management. Operators: context.project_id=1.", "invalid_parameters": "user_id is required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "member_cap_reached": "Project member cap or billing user limit reached — buffs.get_effective_limits", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "The key cannot manage members of this project.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_already_in_project": "User already in project"}, "when_to_use": "Membership write. dry_run is rejected (dry_run_not_supported). Attach a user by user_id. Ecosystem operators use context.project_id=1 and params.project_id for the tenant. Resolve id via social.users."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Membership write. dry_run is rejected (dry_run_not_supported). Attach a user by user_id. Ecosystem …", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "Confirmation", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "user": {"description": "Membership row", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["projects.remove_user"], "safe_action": "projects_add_user", "semantic_input_mode": "inherit_workflow", "summary": "Add a user to a project (requires manage_users or owner on that project).", "title": "Projects Add User", "verification": ["projects.get_users", "rbac.check_permission"], "verify": [{"action": "projects.get_users", "predicate": "named resource is visible"}, {"action": "rbac.check_permission", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dry_run_not_supported": "This action has no dry_run. Omit the key; the call writes membership.", "insufficient_permissions": "Owner/manage_users required, or Launch+ project plan (user_management) when caller is not ecosystem. Personal Premium/VIP does not unlock team management. Operators: context.project_id=1.", "invalid_parameters": "user_id is required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "member_cap_reached": "Project member cap or billing user limit reached — buffs.get_effective_limits", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "The key cannot manage members of this project.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_already_in_project": "User already in project"}, "when_to_use": "Membership write. dry_run is rejected (dry_run_not_supported). Attach a user by user_id. Ecosystem operators use context.project_id=1 and params.project_id for the tenant. Resolve id via social.users.", "write_mode": null}, {"action": "projects.update_user_role", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.update_user_role", "mutation_risk": "low", "related_tools": ["projects.get_users", "projects.add_user", "projects.remove_user"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Update User Role", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Only owner or manage_users — projects.get_users then retry", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_in_project": "projects.add_user first, then projects.update_user_role"}, "when_to_use": "Change member/admin role — not owner transfer; requires manage_users or owner."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.update_user_role", "mutation_risk": "low", "related_tools": ["projects.get_users", "projects.add_user", "projects.remove_user"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Update User Role", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Only owner or manage_users — projects.get_users then retry", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_in_project": "projects.add_user first, then projects.update_user_role"}, "when_to_use": "Change member/admin role — not owner transfer; requires manage_users or owner."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Change member/admin role — not owner transfer; requires manage_users or owner.", "mutation_kind": "entity", "next_actions": ["rbac.get_roles", "projects.get_users"], "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_users", "projects.add_user", "projects.remove_user"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "access_control", "safe_action": "projects_update_user_role", "semantic_input_mode": "inherit_workflow", "summary": "Update a user's role in a project (requires manage_users or owner; cannot assign owner via this tool).", "title": "Projects Update User Role", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Only owner or manage_users — projects.get_users then retry", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_in_project": "projects.add_user first, then projects.update_user_role"}, "when_to_use": "Change member/admin role — not owner transfer; requires manage_users or owner.", "write_mode": null}, {"action": "projects.remove_user", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.remove_user", "mutation_risk": "high", "related_tools": ["projects.get_users", "projects.add_user"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Remove User", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Only project owner or ecosystem can remove users", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_in_project": "User not found in project"}, "when_to_use": "Remove inactive or departed members — requires manage_users or owner."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.remove_user", "mutation_risk": "high", "related_tools": ["projects.get_users", "projects.add_user"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Remove User", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Only project owner or ecosystem can remove users", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_in_project": "User not found in project"}, "when_to_use": "Remove inactive or departed members — requires manage_users or owner."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Remove inactive or departed members — requires manage_users or owner.", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_users", "projects.add_user"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "projects_remove_user", "semantic_input_mode": "inherit_workflow", "summary": "Remove a user from a project (requires manage_users or owner on that project).", "title": "Projects Remove User", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Only project owner or ecosystem can remove users", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_in_project": "User not found in project"}, "when_to_use": "Remove inactive or departed members — requires manage_users or owner.", "write_mode": null}, {"action": "projects.orchestrator.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.orchestrator.get", "related_tools": ["projects.orchestrator.patch", "agents.plan_get", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Orchestrator Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read orchestrator binding (agent_uuid, persona, memory) — not the plan graph. Use agents.plan_get for task_list. home scopes env_uuid fail-closed only."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.orchestrator.get", "related_tools": ["projects.orchestrator.patch", "agents.plan_get", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Orchestrator Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read orchestrator binding (agent_uuid, persona, memory) — not the plan graph. Use agents.plan_get for task_list. home scopes env_uuid fail-closed only."}, "domain": "projects", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read orchestrator binding (agent_uuid, persona, memory) — not the plan graph. Use agents.plan_get f…", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Then mcp_orch_faq_desk, mcp_orch_support_desk, or mcp_orch_api_desk. One channel owner.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.orchestrator.patch", "agents.plan_get", "agents.work_next"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_orchestrator_get", "semantic_input_mode": "inherit_workflow", "summary": "Get project_orchestrator 8DNA leaf config.", "title": "Projects Orchestrator Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read orchestrator binding (agent_uuid, persona, memory) — not the plan graph. Use agents.plan_get for task_list. home scopes env_uuid fail-closed only.", "write_mode": null}, {"action": "projects.orchestrator.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.orchestrator.patch", "mutation_risk": "low", "related_tools": ["projects.orchestrator.get", "agents.plan_patch", "agents.reconcile_binding"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Orchestrator Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "project_id and patch object required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestrator_provision_requires_prod": "First projects.orchestrator.patch on prod (omit env_uuid), then generation.fork and sandbox-only overlays — tenant business assistant recipe step 4.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch orchestrator config (persona, memory_profile, operator desk). Provision runs on prod only (not when env_uuid set on patch). Tenant business assistant recipe step 4: prod patch on head (omit env_"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.orchestrator.patch", "mutation_risk": "low", "related_tools": ["projects.orchestrator.get", "agents.plan_patch", "agents.reconcile_binding"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Orchestrator Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "project_id and patch object required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestrator_provision_requires_prod": "First projects.orchestrator.patch on prod (omit env_uuid), then generation.fork and sandbox-only overlays — tenant business assistant recipe step 4.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch orchestrator config (persona, memory_profile, operator desk). Provision runs on prod only (not when env_uuid set on patch). Tenant business assistant recipe step 4: prod patch on head (omit env_"}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Patch orchestrator config (persona, memory_profile, operator desk). Provision runs on prod only (no…", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Then mcp_orch_faq_desk, mcp_orch_support_desk, or mcp_orch_api_desk. One channel owner.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.orchestrator.get", "agents.plan_patch", "agents.reconcile_binding"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "projects_orchestrator_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch project_orchestrator leaf (dna_set_project_data_path).", "title": "Projects Orchestrator Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "project_id and patch object required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestrator_provision_requires_prod": "First projects.orchestrator.patch on prod (omit env_uuid), then generation.fork and sandbox-only overlays — tenant business assistant recipe step 4.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch orchestrator config (persona, memory_profile, operator desk). Provision runs on prod only (not when env_uuid set on patch). Tenant business assistant recipe step 4: prod patch on head (omit env_", "write_mode": null}, {"action": "projects.orchestrator.export_pack", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.orchestrator.export_pack", "related_tools": ["projects.orchestrator.import_from_asset", "projects.orchestrator.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Orchestrator Export Pack", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "session user_id required for personal home export", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export marketplace orchestrator pack from project or personal plan leaf. Import back via projects.orchestrator.import_from_asset on home=project only."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.orchestrator.export_pack", "related_tools": ["projects.orchestrator.import_from_asset", "projects.orchestrator.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Orchestrator Export Pack", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "session user_id required for personal home export", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export marketplace orchestrator pack from project or personal plan leaf. Import back via projects.orchestrator.import_from_asset on home=project only."}, "domain": "projects", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Export marketplace orchestrator pack from project or personal plan leaf. Import back via projects.o…", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Then mcp_orch_faq_desk, mcp_orch_support_desk, or mcp_orch_api_desk. One channel owner.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.orchestrator.import_from_asset", "projects.orchestrator.get"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_orchestrator_export_pack", "semantic_input_mode": "inherit_workflow", "summary": "Export portable ProjectOrchestratorPack JSON.", "title": "Projects Orchestrator Export Pack", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "session user_id required for personal home export", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export marketplace orchestrator pack from project or personal plan leaf. Import back via projects.orchestrator.import_from_asset on home=project only.", "write_mode": null}, {"action": "projects.orchestrator.import_from_asset", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.orchestrator.import_from_asset", "mutation_risk": "low", "related_tools": ["projects.orchestrator.export_pack", "projects.orchestrator.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Orchestrator Import From Asset", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "import_pack_personal_home_unsupported": "Orchestrator pack import applies to project plan slice only — switch to home=project", "invalid_parameters": "project_id required; pack or asset required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Import orchestrator marketplace pack onto project plan slice. Personal home (self|project_self) is unsupported — use project home."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.orchestrator.import_from_asset", "mutation_risk": "low", "related_tools": ["projects.orchestrator.export_pack", "projects.orchestrator.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Orchestrator Import From Asset", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "import_pack_personal_home_unsupported": "Orchestrator pack import applies to project plan slice only — switch to home=project", "invalid_parameters": "project_id required; pack or asset required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Import orchestrator marketplace pack onto project plan slice. Personal home (self|project_self) is unsupported — use project home."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Import orchestrator marketplace pack onto project plan slice. Personal home (self|project_self) is …", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Then mcp_orch_faq_desk, mcp_orch_support_desk, or mcp_orch_api_desk. One channel owner.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.orchestrator.export_pack", "projects.orchestrator.patch"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "projects_orchestrator_import_from_asset", "semantic_input_mode": "inherit_workflow", "summary": "Fulfill orchestrator pack from commerce asset or raw pack dict.", "title": "Projects Orchestrator Import From Asset", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "import_pack_personal_home_unsupported": "Orchestrator pack import applies to project plan slice only — switch to home=project", "invalid_parameters": "project_id required; pack or asset required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Import orchestrator marketplace pack onto project plan slice. Personal home (self|project_self) is unsupported — use project home.", "write_mode": null}, {"action": "projects.limits.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.limits.get", "related_tools": ["buffs.get_effective_limits", "bots.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Limits Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Cannot read project limits for this workspace", "invalid_parameters": "project_id or workspace_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before fleet/commerce mutations — merged project-plane limits (entity_kind=project). Response: data.effective_limits.limits/features, not nested limits.data. Ecosystem pid=1 uses project plane, not pe"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.limits.get", "related_tools": ["buffs.get_effective_limits", "bots.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Limits Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Cannot read project limits for this workspace", "invalid_parameters": "project_id or workspace_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before fleet/commerce mutations — merged project-plane limits (entity_kind=project). Response: data.effective_limits.limits/features, not nested limits.data. Ecosystem pid=1 uses project plane, not pe"}, "domain": "projects", "effect": {"execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "heavy", "instruction_hint": "Before fleet/commerce mutations — merged project-plane limits (entity_kind=project). Response: data…", "mutation_kind": "none", "next_actions": ["buffs.list_active_buffs entity_kind=project", "buffs.grant_subscription plane=project for operator tier supply"], "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["buffs.get_effective_limits", "bots.list"], "required_cap": "mcp_read", "requires_preflight": false, "returns_hint": "effective_limits.limits + contributing_buffs; limits_source_ok=false when buff merge failed; bot gate uses fleet ecs_health.bots_index_count (falls back to list when index cold).", "risk_class": "read", "safe_action": "projects_limits_get", "semantic_input_mode": "inherit_workflow", "summary": "Project effective limits — buffs + bot create gate metadata.", "title": "Projects Limits Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Cannot read project limits for this workspace", "invalid_parameters": "project_id or workspace_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before fleet/commerce mutations — merged project-plane limits (entity_kind=project). Response: data.effective_limits.limits/features, not nested limits.data. Ecosystem pid=1 uses project plane, not pe", "write_mode": null}, {"action": "projects.readiness.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.readiness.get", "related_tools": ["projects.get_project", "generation.supply_status", "knowledge.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Readiness Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Cannot read readiness for this workspace", "invalid_parameters": "project_id or workspace_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before onboarding flows — without full projects.get payload. Single call: inline supply_status + knowledge_health (skim); not nested generation.supply_status / knowledge.health executes. Set include_a"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.readiness.get", "related_tools": ["projects.get_project", "generation.supply_status", "knowledge.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Readiness Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Cannot read readiness for this workspace", "invalid_parameters": "project_id or workspace_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before onboarding flows — without full projects.get payload. Single call: inline supply_status + knowledge_health (skim); not nested generation.supply_status / knowledge.health executes. Set include_a"}, "domain": "projects", "effect": {"execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "heavy", "instruction_hint": "Before onboarding flows — without full projects.get payload. Single call: inline supply_status + kn…", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_project", "generation.supply_status", "knowledge.health"], "required_cap": "mcp_read", "requires_preflight": false, "returns_hint": "Direct supply gate + knowledge skim (no nested MCP); set include_asset_counts=true only for commerce cardinality.", "risk_class": "read", "safe_action": "projects_readiness_get", "semantic_input_mode": "inherit_workflow", "summary": "Lightweight project readiness — supply + knowledge health skim.", "title": "Projects Readiness Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Cannot read readiness for this workspace", "invalid_parameters": "project_id or workspace_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before onboarding flows — without full projects.get payload. Single call: inline supply_status + knowledge_health (skim); not nested generation.supply_status / knowledge.health executes. Set include_a", "write_mode": null}, {"action": "projects.cancel_deletion", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.safe_deletion.gen1"], "id": "projects.cancel_deletion", "mutation_risk": "low", "related_tools": ["projects.schedule_deletion", "projects.deletion_status", "projects.get_deletion_inventory"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Cancel Deletion", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After schedule_deletion when the operator aborts the grace period."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.safe_deletion.gen1"], "id": "projects.cancel_deletion", "mutation_risk": "low", "related_tools": ["projects.schedule_deletion", "projects.deletion_status", "projects.get_deletion_inventory"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Cancel Deletion", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After schedule_deletion when the operator aborts the grace period."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "After schedule_deletion when the operator aborts the grace period.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.schedule_deletion", "projects.deletion_status", "projects.get_deletion_inventory"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "projects_cancel_deletion", "semantic_input_mode": "inherit_workflow", "summary": "Cancel a scheduled project deletion (PSDP cancel twin).", "title": "Projects Cancel Deletion", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After schedule_deletion when the operator aborts the grace period.", "write_mode": null}, {"action": "projects.deletion_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.safe_deletion.gen1"], "id": "projects.deletion_status", "related_tools": ["projects.cancel_deletion", "projects.get_deletion_inventory"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Deletion Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll grace-period deletion state without opening the SPA wizard."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.safe_deletion.gen1"], "id": "projects.deletion_status", "related_tools": ["projects.cancel_deletion", "projects.get_deletion_inventory"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Deletion Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll grace-period deletion state without opening the SPA wizard."}, "domain": "projects", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Poll grace-period deletion state without opening the SPA wizard.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.cancel_deletion", "projects.get_deletion_inventory"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_deletion_status", "semantic_input_mode": "inherit_workflow", "summary": "Read PSDP deletion status for a project.", "title": "Projects Deletion Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll grace-period deletion state without opening the SPA wizard.", "write_mode": null}, {"action": "projects.archive", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.safe_deletion.gen1"], "id": "projects.archive", "mutation_risk": "high", "related_tools": ["projects.get_deletion_inventory", "projects.delete_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Archive", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Retire a project without hard delete when archive is preferred."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.safe_deletion.gen1"], "id": "projects.archive", "mutation_risk": "high", "related_tools": ["projects.get_deletion_inventory", "projects.delete_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Archive", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Retire a project without hard delete when archive is preferred."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Retire a project without hard delete when archive is preferred.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_deletion_inventory", "projects.delete_project"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "projects_archive", "semantic_input_mode": "inherit_workflow", "summary": "Archive a project (ledger-safe archive twin of POST /archive).", "title": "Projects Archive", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Retire a project without hard delete when archive is preferred.", "write_mode": null}, {"action": "projects.catalog_summaries", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.catalog_summaries.gen1"], "id": "projects.catalog_summaries", "related_tools": ["projects.get_projects", "projects.readiness.get", "projects.get_stats"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Catalog Summaries", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Agent/operator hub parity with GET /projects/catalog-summaries — never N+1 projects.get."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.catalog_summaries.gen1"], "id": "projects.catalog_summaries", "related_tools": ["projects.get_projects", "projects.readiness.get", "projects.get_stats"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Catalog Summaries", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Agent/operator hub parity with GET /projects/catalog-summaries — never N+1 projects.get."}, "domain": "projects", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Agent/operator hub parity with GET /projects/catalog-summaries — never N+1 projects.get.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_projects", "projects.readiness.get", "projects.get_stats"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_catalog_summaries", "semantic_input_mode": "inherit_workflow", "summary": "Batch light KPI rows for project catalog tiles (ids max 40).", "title": "Projects Catalog Summaries", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Agent/operator hub parity with GET /projects/catalog-summaries — never N+1 projects.get.", "write_mode": null}, {"action": "projects.import_by_key", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.import_by_key", "mutation_risk": "high", "related_tools": ["projects.get_projects", "apikeys.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Import By Key", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator workspace import — treat api_key as secret; prefer SPA import dialog for humans."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.import_by_key", "mutation_risk": "high", "related_tools": ["projects.get_projects", "apikeys.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Import By Key", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator workspace import — treat api_key as secret; prefer SPA import dialog for humans."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Operator workspace import — treat api_key as secret; prefer SPA import dialog for humans.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_projects", "apikeys.create"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "projects_import_by_key", "semantic_input_mode": "inherit_workflow", "summary": "Import accessible projects using a user API key (operator-sensitive).", "title": "Projects Import By Key", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator workspace import — treat api_key as secret; prefer SPA import dialog for humans.", "write_mode": null}, {"action": "projects.membership.repair", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.member_ops.gen1"], "id": "projects.membership.repair", "mutation_risk": "low", "related_tools": ["projects.get_users", "projects.add_user", "projects.join"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Membership Repair", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin required on context.project_id", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_implemented": "repair_project_membership endpoint missing on this build", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile / Connect first", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "When get_users / list lag after invite — heal accessible_ids without a second membership store."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.member_ops.gen1"], "id": "projects.membership.repair", "mutation_risk": "low", "related_tools": ["projects.get_users", "projects.add_user", "projects.join"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Membership Repair", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin required on context.project_id", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_implemented": "repair_project_membership endpoint missing on this build", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile / Connect first", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "When get_users / list lag after invite — heal accessible_ids without a second membership store."}, "domain": "projects", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "After projects.join rbac_assign_failed — heal accessible_ids before work_next", "request": {"project_id": 123}, "response": {"data": {"membership_verified": true, "owner_user_id": 1, "project_id": 123, "success": true}, "success": true}}], "execution_class": "cheap", "instruction_hint": "When get_users / list lag after invite — heal accessible_ids without a second membership store.", "mutation_kind": "none", "next_actions": ["auth.switch_project when mutation_allowed false", "projects.get_users refresh"], "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_users", "projects.add_user", "projects.join"], "required_cap": "project_admin", "requires_preflight": false, "returns_hint": "membership_verified true when owner/member rows and accessible_ids healed.", "risk_class": "low_write", "safe_action": "projects_membership_repair", "semantic_input_mode": "inherit_workflow", "summary": "Repair project membership / accessible_ids lag for the caller.", "title": "Projects Membership Repair", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin required on context.project_id", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_implemented": "repair_project_membership endpoint missing on this build", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile / Connect first", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "When get_users / list lag after invite — heal accessible_ids without a second membership store.", "write_mode": null}, {"action": "projects.presets.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.presets.list", "related_tools": ["projects.create_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Presets List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before create_project when offering template gallery."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.presets.list", "related_tools": ["projects.create_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Presets List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before create_project when offering template gallery."}, "domain": "projects", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Before create_project when offering template gallery.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.create_project"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_presets_list", "semantic_input_mode": "inherit_workflow", "summary": "List project create presets / templates.", "title": "Projects Presets List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before create_project when offering template gallery.", "write_mode": null}, {"action": "rag.health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.health", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "RAG persistence mode and collection stats for the current project scope."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.health", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "RAG persistence mode and collection stats for the current project scope."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "RAG persistence mode and collection stats for the current project scope.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_health", "semantic_input_mode": "inherit_workflow", "summary": "RAG persistence mode and collection stats for the current project scope.", "title": "Rag Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "RAG persistence mode and collection stats for the current project scope.", "write_mode": null}, {"action": "rag.ingest_job_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.ingest_job_status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Ingest Job Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll async batch ingest job status (work_queue rag_ingest)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.ingest_job_status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Ingest Job Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll async batch ingest job status (work_queue rag_ingest)."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Poll async batch ingest job status (work_queue rag_ingest).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_ingest_job_status", "semantic_input_mode": "inherit_workflow", "summary": "Poll async batch ingest job status (work_queue rag_ingest).", "title": "Rag Ingest Job Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll async batch ingest job status (work_queue rag_ingest).", "write_mode": null}, {"action": "rag.ingest_job_cancel", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.ingest_job_cancel", "related_tools": ["rag.ingest_job_status", "rag.document_add_batch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Ingest Job Cancel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Abort a long-running ingest before it completes."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.ingest_job_cancel", "related_tools": ["rag.ingest_job_status", "rag.document_add_batch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Ingest Job Cancel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Abort a long-running ingest before it completes."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Abort a long-running ingest before it completes.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.ingest_job_status", "rag.document_add_batch"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "rag_ingest_job_cancel", "semantic_input_mode": "inherit_workflow", "summary": "Cancel a queued or in-flight rag_ingest job (idempotent).", "title": "Rag Ingest Job Cancel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Abort a long-running ingest before it completes.", "write_mode": null}, {"action": "rag.collection_create", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.collection_create", "mutation_risk": "low", "related_tools": ["rag.document_add", "rag.search", "rag.collection_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Collection Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Enable RAG on project plan before collection_create", "invalid_parameters": "name required; scope must be project or user", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "knowledge_collections_unavailable": "rag.collection_list — archive or upgrade tier", "rag_embed_quota": "buffs.get_effective_limits — pause create until quota resets", "rag_service_unavailable": "RAG engine not configured on this deployment", "rag_tier_limit": "Collection cap reached — archive or upgrade", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before adding documents. Create one collection per topic before rag.document_add."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.collection_create", "mutation_risk": "low", "related_tools": ["rag.document_add", "rag.search", "rag.collection_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Collection Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Enable RAG on project plan before collection_create", "invalid_parameters": "name required; scope must be project or user", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "knowledge_collections_unavailable": "rag.collection_list — archive or upgrade tier", "rag_embed_quota": "buffs.get_effective_limits — pause create until quota resets", "rag_service_unavailable": "RAG engine not configured on this deployment", "rag_tier_limit": "Collection cap reached — archive or upgrade", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before adding documents. Create one collection per topic before rag.document_add."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Create a support knowledge base", "params": {"description": "Customer support articles", "name": "support-kb"}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Before adding documents. Create one collection per topic before rag.document_add.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"accepted": {"description": "True when mutation is queued but not yet committed", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "changed": {"description": "False when idempotent replay (delete already in progress)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "collection": {"description": "Masked collection object when ready", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "collection_id": {"description": "UUID of the collection", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "committed": {"description": "True when resource reached settled read model", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "error_code": {"description": "Machine-readable error when success=false", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "name": {"description": "Collection name", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Owner project ID", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "retry_after_ms": {"description": "Suggested poll delay in milliseconds", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "retryable": {"description": "Whether client should poll verification_action", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "state": {"description": "Lifecycle: creating | ready | deleting | deleted | failed", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "Alias of committed (v13 mutation receipt)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "verification_action": {"description": "MCP action to confirm state (rag.collection_get)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.document_add", "rag.search", "rag.collection_list"], "required_cap": "rag.write", "requires_preflight": false, "risk_class": "low_write", "rollback": ["rag.collection_delete"], "safe_action": "rag_collection_create", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a new RAG knowledge base collection for the current project.", "title": "Rag Collection Create", "tool_chains": ["project_bootstrap", "rag_knowledge_base", "rag_knowledge_base"], "verification": ["rag.collection_get"], "verify": [{"action": "rag.collection_get", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Enable RAG on project plan before collection_create", "invalid_parameters": "name required; scope must be project or user", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "knowledge_collections_unavailable": "rag.collection_list — archive or upgrade tier", "rag_embed_quota": "buffs.get_effective_limits — pause create until quota resets", "rag_service_unavailable": "RAG engine not configured on this deployment", "rag_tier_limit": "Collection cap reached — archive or upgrade", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before adding documents. Create one collection per topic before rag.document_add.", "write_mode": null}, {"action": "rag.collection_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.collection_get", "related_tools": ["rag.collection_list", "rag.collection_create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Collection Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify collection exists after rag.collection_create before ingest."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.collection_get", "related_tools": ["rag.collection_list", "rag.collection_create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Collection Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify collection exists after rag.collection_create before ingest."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Verify collection exists after rag.collection_create before ingest.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.collection_list", "rag.collection_create"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_collection_get", "semantic_input_mode": "inherit_workflow", "summary": "Get one RAG collection by id (verify-after-write read model).", "title": "Rag Collection Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify collection exists after rag.collection_create before ingest.", "write_mode": null}, {"action": "rag.collection_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.collection_list", "related_tools": ["rag.collection_create", "rag.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Collection List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover collections before search or ingest."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.collection_list", "related_tools": ["rag.collection_create", "rag.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Collection List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover collections before search or ingest."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Discover collections before search or ingest.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.collection_create", "rag.search"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_collection_list", "semantic_input_mode": "inherit_workflow", "summary": "List all RAG collections for the current project.", "title": "Rag Collection List", "tool_chains": ["rag_knowledge_base"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover collections before search or ingest.", "write_mode": null}, {"action": "rag.collection_delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not delete collections with important data unless explicitly requested", "anti_patterns": ["Do not delete collections with important data unless explicitly requested"], "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.collection_delete", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Collection Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drop collection and all docs — irreversible."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.collection_delete", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Collection Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drop collection and all docs — irreversible."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Drop collection and all docs — irreversible.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"accepted": {"description": "True when mutation is queued but not yet committed", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "changed": {"description": "False when idempotent replay (delete already in progress)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "collection_id": {"description": "UUID of the collection", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "committed": {"description": "True when resource reached settled read model", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "deleted": {"description": "True when collection is gone or delete accepted", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "error_code": {"description": "Machine-readable error when success=false", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "retry_after_ms": {"description": "Suggested poll delay in milliseconds", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "retryable": {"description": "Whether client should poll verification_action", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "state": {"description": "Lifecycle: creating | ready | deleting | deleted | failed", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "success": {"description": "Alias of committed (v13 mutation receipt)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "verification_action": {"description": "MCP action to confirm state (rag.collection_get)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.write", "requires_preflight": true, "risk_class": "destructive", "rollback": [], "safe_action": "rag_collection_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete a RAG collection and all its documents. This is irreversible.", "title": "Rag Collection Delete", "verification": ["rag.collection_list", "knowledge.health"], "verify": [{"action": "rag.collection_list", "predicate": "named resource is visible"}, {"action": "knowledge.health", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drop collection and all docs — irreversible.", "write_mode": null}, {"action": "rag.document_add", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.document_add", "mutation_risk": "low", "related_tools": ["rag.search", "rag.collection_list", "rag.document_delete"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rag Document Add", "when_blocked": {"collection_not_found": "rag.collection_create with stable collection_id first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "content and collection_id are required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "rag.collection_create then rag.collection_get before document_add", "permission_denied": "RBAC or collection access denied for this project", "rag_embed_quota": "buffs.get_effective_limits before retrying ingest", "rag_embed_rate_limit": "HTTP 429 — stop ingest loop; knowledge.doctor.run", "rag_service_unavailable": "RAG engine not configured on this deployment", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Index text into a collection — prefer over raw storage for semantic search."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.document_add", "mutation_risk": "low", "related_tools": ["rag.search", "rag.collection_list", "rag.document_delete"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rag Document Add", "when_blocked": {"collection_not_found": "rag.collection_create with stable collection_id first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "content and collection_id are required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "rag.collection_create then rag.collection_get before document_add", "permission_denied": "RBAC or collection access denied for this project", "rag_embed_quota": "buffs.get_effective_limits before retrying ingest", "rag_embed_rate_limit": "HTTP 429 — stop ingest loop; knowledge.doctor.run", "rag_service_unavailable": "RAG engine not configured on this deployment", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Index text into a collection — prefer over raw storage for semantic search."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Add a support article", "params": {"collection_id": "coll-uuid", "content": "How to reset your password...", "metadata": {"tags": ["password", "account"], "type": "support"}}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Index text into a collection — prefer over raw storage for semantic search.", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["rag.ingest_job_status"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"chunks_added": {"description": "Number of new chunks indexed", "type": "integer"}, "chunks_skipped": {"description": "Unchanged chunks skipped", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "source_doc_id": {"description": "Source document identifier used", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.search", "rag.collection_list", "rag.document_delete"], "required_cap": "rag.write", "requires_preflight": false, "risk_class": "low_write", "rollback": ["rag.document_delete"], "safe_action": "rag_document_add", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Add a text document to a RAG collection.", "title": "Rag Document Add", "tool_chains": ["rag_knowledge_base"], "verification": ["rag.search", "rag.collection_list"], "verify": [{"action": "rag.search", "predicate": "named resource is visible"}, {"action": "rag.collection_list", "predicate": "named resource is visible"}], "when_blocked": {"collection_not_found": "rag.collection_create with stable collection_id first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "content and collection_id are required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "rag.collection_create then rag.collection_get before document_add", "permission_denied": "RBAC or collection access denied for this project", "rag_embed_quota": "buffs.get_effective_limits before retrying ingest", "rag_embed_rate_limit": "HTTP 429 — stop ingest loop; knowledge.doctor.run", "rag_service_unavailable": "RAG engine not configured on this deployment", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Index text into a collection — prefer over raw storage for semantic search.", "write_mode": null}, {"action": "rag.document_add_batch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.document_add_batch", "related_tools": ["rag.collection_get", "rag.ingest_job_status", "rag.search", "knowledge.kb.ingest"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Document Add Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk mentor KB ingest after collection_create."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.document_add_batch", "related_tools": ["rag.collection_get", "rag.ingest_job_status", "rag.search", "knowledge.kb.ingest"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Document Add Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk mentor KB ingest after collection_create."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Bulk mentor KB ingest after collection_create.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.collection_get", "rag.ingest_job_status", "rag.search", "knowledge.kb.ingest"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "rag_document_add_batch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Add multiple documents to a RAG collection in one call.", "title": "Rag Document Add Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk mentor KB ingest after collection_create.", "write_mode": null}, {"action": "rag.document_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.document_list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Document List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List document chunks in a collection (default 50, max 1000, same as REST). vector_compressed is omitted. A long text is an envelope preview, not the chunk."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.document_list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Document List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List document chunks in a collection (default 50, max 1000, same as REST). vector_compressed is omitted. A long text is an envelope preview, not the chunk."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "List document chunks in a collection (default 50, max 1000, same as REST). vector_compressed is omi…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_document_list", "semantic_input_mode": "inherit_workflow", "summary": "List document chunks in a collection (default 50, max 1000, same as REST). vector_compressed is omitted. A long text is an envelope preview, not the chunk.", "title": "Rag Document List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List document chunks in a collection (default 50, max 1000, same as REST). vector_compressed is omitted. A long text is an envelope preview, not the chunk.", "write_mode": null}, {"action": "rag.document_delete", "aliases": ["knowledge.document.delete"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.document_delete", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Document Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove one document from a collection."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.document_delete", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Document Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove one document from a collection."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Remove one document from a collection.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.write", "requires_preflight": true, "risk_class": "destructive", "safe_action": "rag_document_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Remove a document (all its chunks) from a collection by source_doc_id.", "title": "Rag Document Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove one document from a collection.", "write_mode": null}, {"action": "rag.ingest_from_storage", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.ingest_from_storage", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Ingest From Storage", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ingest text extracted from a Storage file into a RAG collection."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.ingest_from_storage", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Ingest From Storage", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ingest text extracted from a Storage file into a RAG collection."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Ingest text extracted from a Storage file into a RAG collection.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "rag_ingest_from_storage", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Ingest text extracted from a Storage file into a RAG collection.", "title": "Rag Ingest From Storage", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ingest text extracted from a Storage file into a RAG collection.", "write_mode": null}, {"action": "rag.export", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.export", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Export", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export accessible collection chunks (default 5000), access-tier filtered. A long text is an envelope preview, not the chunk."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.export", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Export", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export accessible collection chunks (default 5000), access-tier filtered. A long text is an envelope preview, not the chunk."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Export accessible collection chunks (default 5000), access-tier filtered. A long text is an envelop…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_export", "semantic_input_mode": "inherit_workflow", "summary": "Export accessible collection chunks (default 5000), access-tier filtered. A long text is an envelope preview, not the chunk.", "title": "Rag Export", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export accessible collection chunks (default 5000), access-tier filtered. A long text is an envelope preview, not the chunk.", "write_mode": null}, {"action": "rag.warm", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.warm", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Warm", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pre-load collection vectors into process L1 before search traffic."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.warm", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Warm", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pre-load collection vectors into process L1 before search traffic."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Pre-load collection vectors into process L1 before search traffic.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_warm", "semantic_input_mode": "inherit_workflow", "summary": "Pre-load collection vectors into process L1 before search traffic.", "title": "Rag Warm", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pre-load collection vectors into process L1 before search traffic.", "write_mode": null}, {"action": "rag.search", "aliases": ["knowledge.search"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.search", "related_tools": ["rag.collection_list", "rag.document_add", "rag.memory_search"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rag Search", "when_blocked": {"collection_not_found": "rag.collection_create or knowledge.kb.ingest first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "RAG not on plan — discovery.describe rag.search effect", "forbidden": "RBAC or collection access denied for this project", "invalid_parameters": "collection_id and query required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rag_tier_limit": "Upgrade tier or reduce top_k; buffs.get_effective_limits", "rag_unavailable": "RAG engine not configured on this deployment", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hybrid semantic + BM25 search — ground agent answers in project docs."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.search", "related_tools": ["rag.collection_list", "rag.document_add", "rag.memory_search"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rag Search", "when_blocked": {"collection_not_found": "rag.collection_create or knowledge.kb.ingest first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "RAG not on plan — discovery.describe rag.search effect", "forbidden": "RBAC or collection access denied for this project", "invalid_parameters": "collection_id and query required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rag_tier_limit": "Upgrade tier or reduce top_k; buffs.get_effective_limits", "rag_unavailable": "RAG engine not configured on this deployment", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hybrid semantic + BM25 search — ground agent answers in project docs."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Search project knowledge_kb by stable id", "params": {"collection_id": "knowledge_kb", "hybrid": true, "query": "how do I get a refund?", "top_k": 3}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Hybrid semantic + BM25 search — ground agent answers in project docs.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"collection_id": {"description": "Collection that was searched", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "query": {"description": "The original query", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "results": {"description": "Array of {doc_id, text, score, metadata, source_doc_id, chunk_index}", "items": {"type": "string"}, "type": "array"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.collection_list", "rag.document_add", "rag.memory_search"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_search", "semantic_input_mode": "inherit_workflow", "summary": "Semantic search over a RAG collection.", "title": "Rag Search", "tool_chains": ["rag_knowledge_base"], "when_blocked": {"collection_not_found": "rag.collection_create or knowledge.kb.ingest first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "RAG not on plan — discovery.describe rag.search effect", "forbidden": "RBAC or collection access denied for this project", "invalid_parameters": "collection_id and query required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rag_tier_limit": "Upgrade tier or reduce top_k; buffs.get_effective_limits", "rag_unavailable": "RAG engine not configured on this deployment", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hybrid semantic + BM25 search — ground agent answers in project docs.", "write_mode": null}, {"action": "rag.memory_add", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.memory_add", "mutation_risk": "low", "related_tools": ["rag.memory_search", "rag.memory_get", "rag.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Memory Add", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rag_tier_limit": "Memory quota — rag.memory_list then prune stale rows", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Store conversation turn in scoped agent memory (TurboQuant)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.memory_add", "mutation_risk": "low", "related_tools": ["rag.memory_search", "rag.memory_get", "rag.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Memory Add", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rag_tier_limit": "Memory quota — rag.memory_list then prune stale rows", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Store conversation turn in scoped agent memory (TurboQuant)."}, "do_not_use_when": "Project documents belong in knowledge.kb.ingest, not agent memory.", "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Store user message", "params": {"content": "How do I add payments?", "role": "user", "session_id": "sess-123"}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Store conversation turn in scoped agent memory (TurboQuant).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.memory_search", "rag.memory_get", "rag.search"], "required_cap": "rag.write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "rag_memory_add", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Store a conversation turn in AI memory.", "title": "Rag Memory Add", "tool_chains": ["rag_knowledge_base"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rag_tier_limit": "Memory quota — rag.memory_list then prune stale rows", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Project documents belong in knowledge.kb.ingest, not agent memory.", "when_to_use": "Store conversation turn in scoped agent memory (TurboQuant).", "write_mode": null}, {"action": "rag.memory_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.memory_get", "related_tools": ["rag.memory_add", "rag.memory_search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Memory Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Recent memory turns for the active session."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.memory_get", "related_tools": ["rag.memory_add", "rag.memory_search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Memory Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Recent memory turns for the active session."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Recent memory turns for the active session.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.memory_add", "rag.memory_search"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_memory_get", "semantic_input_mode": "inherit_workflow", "summary": "Get the most recent conversation turns from memory (chronological order).", "title": "Rag Memory Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Recent memory turns for the active session.", "write_mode": null}, {"action": "rag.memory_search", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.memory_search", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Memory Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Semantic recall over past turns — combine with rag.search for KB."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.memory_search", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Memory Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Semantic recall over past turns — combine with rag.search for KB."}, "domain": "rag", "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Find past discussion about payments", "params": {"query": "payment integration", "session_id": "sess-123", "top_k": 3}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Semantic recall over past turns — combine with rag.search for KB.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_memory_search", "semantic_input_mode": "inherit_workflow", "summary": "Semantically search past conversation turns.", "title": "Rag Memory Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Semantic recall over past turns — combine with rag.search for KB.", "write_mode": null}, {"action": "rbac.get_roles", "aliases": ["rbac.list_permissions"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "rbac.get_roles", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rbac Get Roles", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List project roles before assign_role or revoke_role."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "rbac.get_roles", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rbac Get Roles", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List project roles before assign_role or revoke_role."}, "domain": "rbac", "domain_title": "Rbac MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rbac.gen1"], "instruction_hint": "List project roles before assign_role or revoke_role.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rbac", "owner_gene": "core.mcp.rbac.gen1", "plane": "Roles: rbac.get_roles.", "plane_chooser": "Field policy is data_access.set_policy, not a new permission table.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "rbac_get_roles", "semantic_input_mode": "inherit_workflow", "summary": "Get list of roles for a project (system + custom). Returns id, name, permissions_bitmap, permissions, is_system.", "title": "Rbac Get Roles", "tool_chains": ["rbac_manage_members"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List project roles before assign_role or revoke_role.", "write_mode": null}, {"action": "rbac.assign_role", "aliases": ["auth.assign_role"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "rbac.assign_role", "related_tools": ["rbac.get_roles", "rbac.revoke_role", "projects.get_users"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rbac Assign Role", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Caller needs project_admin — auth.get_profile for caps", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "owner_assign_denied": "Owner role is immutable — use project transfer flows, not rbac.assign_role", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_in_project": "User not in project"}, "when_to_use": "Grant role to member — cannot assign owner via this tool."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "rbac.assign_role", "related_tools": ["rbac.get_roles", "rbac.revoke_role", "projects.get_users"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rbac Assign Role", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Caller needs project_admin — auth.get_profile for caps", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "owner_assign_denied": "Owner role is immutable — use project transfer flows, not rbac.assign_role", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_in_project": "User not in project"}, "when_to_use": "Grant role to member — cannot assign owner via this tool."}, "domain": "rbac", "domain_title": "Rbac MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.rbac.gen1"], "instruction_hint": "Grant role to member — cannot assign owner via this tool.", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["rbac.get_roles", "projects.get_users"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.rbac", "owner_gene": "core.mcp.rbac.gen1", "plane": "Roles: rbac.get_roles.", "plane_chooser": "Field policy is data_access.set_policy, not a new permission table.", "related_tools": ["rbac.get_roles", "rbac.revoke_role", "projects.get_users"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "access_control", "safe_action": "rbac_assign_role", "semantic_input_mode": "inherit_workflow", "summary": "Assign a role to a user in a project. Requires manage_users or owner. Cannot assign owner via this tool.", "title": "Rbac Assign Role", "tool_chains": ["crud_with_logic", "content_access_control", "multi_tenant_onboarding"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Caller needs project_admin — auth.get_profile for caps", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "owner_assign_denied": "Owner role is immutable — use project transfer flows, not rbac.assign_role", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_in_project": "User not in project"}, "when_to_use": "Grant role to member — cannot assign owner via this tool.", "write_mode": null}, {"action": "rbac.revoke_role", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "rbac.revoke_role", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rbac Revoke Role", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin required — rbac.get_roles to confirm target role", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke role; user falls back to viewer."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "rbac.revoke_role", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rbac Revoke Role", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin required — rbac.get_roles to confirm target role", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke role; user falls back to viewer."}, "domain": "rbac", "domain_title": "Rbac MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.rbac.gen1"], "instruction_hint": "Revoke role; user falls back to viewer.", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["rbac.get_roles", "projects.get_users"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.rbac", "owner_gene": "core.mcp.rbac.gen1", "plane": "Roles: rbac.get_roles.", "plane_chooser": "Field policy is data_access.set_policy, not a new permission table.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "rbac_revoke_role", "semantic_input_mode": "inherit_workflow", "summary": "Revoke a role from a user in a project. User will get default viewer role. Requires manage_users or owner. Cannot revoke owner.", "title": "Rbac Revoke Role", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin required — rbac.get_roles to confirm target role", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke role; user falls back to viewer.", "write_mode": null}, {"action": "rbac.check_permission", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Field-level policy is data_access.set_policy — not rbac.check_permission on every leaf read.", "Do not scatter permission tables in app code — use FAP + rbac at boundaries."], "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "rbac.check_permission", "related_tools": ["rbac.get_roles", "rbac.assign_role", "data_access.set_policy"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rbac Check Permission", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Membership or role insufficient — permissions.effective action=<tool> for L1+L2 stack.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile before rbac.check_permission.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Gate UI or server branch — prefer over scattering role checks."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "rbac.check_permission", "related_tools": ["rbac.get_roles", "rbac.assign_role", "data_access.set_policy"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rbac Check Permission", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Membership or role insufficient — permissions.effective action=<tool> for L1+L2 stack.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile before rbac.check_permission.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Gate UI or server branch — prefer over scattering role checks."}, "domain": "rbac", "domain_title": "Rbac MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rbac.gen1"], "instruction_hint": "Gate UI or server branch — prefer over scattering role checks.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rbac", "owner_gene": "core.mcp.rbac.gen1", "plane": "Roles: rbac.get_roles.", "plane_chooser": "Field policy is data_access.set_policy, not a new permission table.", "related_tools": ["rbac.get_roles", "rbac.assign_role", "data_access.set_policy"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "rbac_check_permission", "semantic_input_mode": "inherit_workflow", "summary": "Check if a user has a permission in a project. If user_id is omitted, checks current user.", "title": "Rbac Check Permission", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Membership or role insufficient — permissions.effective action=<tool> for L1+L2 stack.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile before rbac.check_permission.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Gate UI or server branch — prefer over scattering role checks.", "write_mode": null}, {"action": "rooms.quick_match", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "intermediate", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.quick_match", "related_tools": ["rooms.poll_events", "rooms.match_status", "stream.relay.ws_ticket", "rooms.leave", "script.run"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rooms Quick Match", "visitor_callable": true, "when_blocked": {"batch_semantic_anchor_required": "options.execution_intent=direct or use /s/{pid}/mcp hosted ingress", "hosted_app_required": "POST /api/hosted-apps/{pid}/session then /s/{pid}/mcp", "hosted_cookie_missing": "Same as hosted_app_required — mint cookie", "invalid_parameters": "project_id, script_id, authenticated user_id", "join_failed": "Retry idempotency_key or rooms.match_status", "match_full": "re-queue with new idempotency_key", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match", "match_provisioning": "Lobby still starting — retry in ~200ms with same idempotency_key", "not_seated": "rooms.leave then quick_match with new idempotency_key", "room_create_failed": "Check script_id + hosted_mcp config", "room_table_full": "Leave stale match or wait GC — rooms.leave", "service_cap_denied": "POST /api/hosted-apps/{pid}/session — hosted cookie + shell_read caps", "unauthorized": "auth.get_profile or hosted session"}, "when_to_use": "One-click find-or-create seat (idempotency_key). Then rooms.poll_events; optional stream.relay.ws_ticket for THERMO realtime."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.quick_match", "related_tools": ["rooms.poll_events", "rooms.match_status", "stream.relay.ws_ticket", "rooms.leave", "script.run"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rooms Quick Match", "visitor_callable": true, "when_blocked": {"batch_semantic_anchor_required": "options.execution_intent=direct or use /s/{pid}/mcp hosted ingress", "hosted_app_required": "POST /api/hosted-apps/{pid}/session then /s/{pid}/mcp", "hosted_cookie_missing": "Same as hosted_app_required — mint cookie", "invalid_parameters": "project_id, script_id, authenticated user_id", "join_failed": "Retry idempotency_key or rooms.match_status", "match_full": "re-queue with new idempotency_key", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match", "match_provisioning": "Lobby still starting — retry in ~200ms with same idempotency_key", "not_seated": "rooms.leave then quick_match with new idempotency_key", "room_create_failed": "Check script_id + hosted_mcp config", "room_table_full": "Leave stale match or wait GC — rooms.leave", "service_cap_denied": "POST /api/hosted-apps/{pid}/session — hosted cookie + shell_read caps", "unauthorized": "auth.get_profile or hosted session"}, "when_to_use": "One-click find-or-create seat (idempotency_key). Then rooms.poll_events; optional stream.relay.ws_ticket for THERMO realtime."}, "do_not_use_when": "Not for Nahual-style DNA coop (`nhl.s*.open` without qm:) — use script.run only. Not for persisted relay rooms — use stream.relay.create_room first. Not on operator MCP without hosted session for /s/{pid}/ players.", "domain": "rooms", "domain_title": "Rooms MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"batch_semantic_anchor_required": "Set options.execution_intent=direct or use /s/{pid}/mcp — not raw operator batch without anchor. → next: preflight.check", "hosted_app_required": "Player path: mint hosted session cookie, then rooms.* on /s/{pid}/mcp. → next: discovery.describe", "hosted_cookie_missing": "POST /api/hosted-apps/{pid}/session on /s/{pid}/ then call hosted MCP ingress. → next: discovery.describe", "invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "join_failed": "Runtime room join failed — rooms.leave then rooms.quick_match with new idempotency_key. → next: rooms.quick_match", "match_full": "No open seats — new quick_match or wait bot_fill / poll_events. → next: rooms.poll_events", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match", "match_provisioning": "Lobby room is still being created — retry quick_match or join_by_code in ~200ms (same idempotency_key). → next: rooms.quick_match", "not_seated": "quick_match returned a match without a seat — rooms.leave then quick_match with a new idempotency_key. → next: rooms.quick_match", "room_create_failed": "Could not allocate relay room — retry or lower concurrent matches. → next: rooms.quick_match", "room_table_full": "In-process room table full — rooms.leave stale matches, then rooms.quick_match. → next: rooms.leave", "service_cap_denied": "Hosted MCP needs session cookie (POST /api/hosted-apps/{pid}/session) — not API key alone on /s/{pid}/mcp. → next: auth.get_profile", "unauthorized": "MCP context missing user_id — auth.get_profile or hosted session. → next: auth.get_profile"}, "examples": [{"action": "rooms.quick_match", "params": {"bot_fill_after_ms": 15000, "idempotency_key": "click-abc", "mode": "1v1", "project_id": 2052, "script_id": "wt-match"}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.rooms.gen1", "core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "One-click find-or-create seat (idempotency_key). Then rooms.poll_events; optional stream.relay.ws_t…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rooms", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bot_filled": {"description": "boolean", "type": "boolean"}, "fill_with_bot": {"description": "boolean", "type": "boolean"}, "invite_link": {"description": "string", "type": "string"}, "match_id": {"description": "string", "type": "string"}, "ok": {"description": "boolean", "type": "boolean"}, "poll_hints": {"additionalProperties": true, "description": "object", "type": "object"}, "room_id": {"description": "string", "type": "string"}, "seat": {"description": "int", "type": "integer"}, "status": {"description": "waiting|started", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.rooms.gen1", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["rooms.poll_events", "rooms.match_status", "stream.relay.ws_ticket", "rooms.leave", "script.run"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "read", "safe_action": "rooms_quick_match", "semantic_input_mode": "inherit_workflow", "summary": "Atomic find-or-create match seat for hosted games (1v1/2v2/ffa4). Idempotent via idempotency_key. Bot-fill after bot_fill_after_ms or fill_with_bot.", "title": "Rooms Quick Match", "when_blocked": {"batch_semantic_anchor_required": "options.execution_intent=direct or use /s/{pid}/mcp hosted ingress", "hosted_app_required": "POST /api/hosted-apps/{pid}/session then /s/{pid}/mcp", "hosted_cookie_missing": "Same as hosted_app_required — mint cookie", "invalid_parameters": "project_id, script_id, authenticated user_id", "join_failed": "Retry idempotency_key or rooms.match_status", "match_full": "re-queue with new idempotency_key", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match", "match_provisioning": "Lobby still starting — retry in ~200ms with same idempotency_key", "not_seated": "rooms.leave then quick_match with new idempotency_key", "room_create_failed": "Check script_id + hosted_mcp config", "room_table_full": "Leave stale match or wait GC — rooms.leave", "service_cap_denied": "POST /api/hosted-apps/{pid}/session — hosted cookie + shell_read caps", "unauthorized": "auth.get_profile or hosted session"}, "when_not_to_use": "Not for Nahual-style DNA coop (`nhl.s*.open` without qm:) — use script.run only. Not for persisted relay rooms — use stream.relay.create_room first. Not on operator MCP without hosted session for /s/{pid}/ players.", "when_to_use": "One-click find-or-create seat (idempotency_key). Then rooms.poll_events; optional stream.relay.ws_ticket for THERMO realtime.", "write_mode": null}, {"action": "rooms.leave", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "simple", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.leave", "related_tools": ["rooms.quick_match"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rooms Leave", "visitor_callable": true, "when_blocked": {"invalid_parameters": "match_id or room_id", "match_not_found": "rooms.quick_match"}, "when_to_use": "Free a seat; empty matches close (TTL GC)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.leave", "related_tools": ["rooms.quick_match"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rooms Leave", "visitor_callable": true, "when_blocked": {"invalid_parameters": "match_id or room_id", "match_not_found": "rooms.quick_match"}, "when_to_use": "Free a seat; empty matches close (TTL GC)."}, "do_not_use_when": "Not for DNA-only coop — no QM seat to release.", "domain": "rooms", "domain_title": "Rooms MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rooms.gen1", "core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Free a seat; empty matches close (TTL GC).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rooms", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"closed": {"description": "boolean", "type": "boolean"}, "left": {"description": "boolean", "type": "boolean"}, "ok": {"description": "boolean", "type": "boolean"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.rooms.gen1", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["rooms.quick_match"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "read", "safe_action": "rooms_leave", "semantic_input_mode": "inherit_workflow", "summary": "Leave a quick-match seat; empty matches close (TTL GC also applies).", "title": "Rooms Leave", "when_blocked": {"invalid_parameters": "match_id or room_id", "match_not_found": "rooms.quick_match"}, "when_not_to_use": "Not for DNA-only coop — no QM seat to release.", "when_to_use": "Free a seat; empty matches close (TTL GC).", "write_mode": null}, {"action": "rooms.poll_events", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "simple", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.poll_events", "related_tools": ["rooms.quick_match", "rooms.match_status", "stream.relay.ws_ticket"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rooms Poll Events", "visitor_callable": true, "when_blocked": {"invalid_parameters": "match_id or room_id + user_id", "match_not_found": "rooms.quick_match", "not_a_participant": "rooms.quick_match first"}, "when_to_use": "Long-poll match events (player_seated/bot_seated/started). WS fallback plane."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.poll_events", "related_tools": ["rooms.quick_match", "rooms.match_status", "stream.relay.ws_ticket"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rooms Poll Events", "visitor_callable": true, "when_blocked": {"invalid_parameters": "match_id or room_id + user_id", "match_not_found": "rooms.quick_match", "not_a_participant": "rooms.quick_match first"}, "when_to_use": "Long-poll match events (player_seated/bot_seated/started). WS fallback plane."}, "do_not_use_when": "Not without match_id from quick_match or join_by_code.", "domain": "rooms", "domain_title": "Rooms MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match", "not_a_participant": "Only seated players may poll or open ws_ticket — rooms.quick_match first. → next: rooms.quick_match"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rooms.gen1", "core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Long-poll match events (player_seated/bot_seated/started). WS fallback plane.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rooms", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"events": {"description": "array", "items": {"type": "string"}, "type": "array"}, "has_more": {"description": "boolean", "type": "boolean"}, "match_id": {"description": "string", "type": "string"}, "match_status": {"description": "waiting|started", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "next_after_ts": {"description": "number", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "ok": {"description": "boolean", "type": "boolean"}, "suggested_poll_ms": {"description": "int", "type": "integer"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.rooms.gen1", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["rooms.quick_match", "rooms.match_status", "stream.relay.ws_ticket"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "rooms_poll_events", "semantic_input_mode": "inherit_workflow", "summary": "Poll match events (player_seated, bot_seated, started, player_left). Also soft-triggers bot fill when bot_fill_after_ms elapsed. WS fallback plane.", "title": "Rooms Poll Events", "when_blocked": {"invalid_parameters": "match_id or room_id + user_id", "match_not_found": "rooms.quick_match", "not_a_participant": "rooms.quick_match first"}, "when_not_to_use": "Not without match_id from quick_match or join_by_code.", "when_to_use": "Long-poll match events (player_seated/bot_seated/started). WS fallback plane.", "write_mode": null}, {"action": "rooms.match_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "simple", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.match_status", "related_tools": ["rooms.quick_match", "rooms.poll_events"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rooms Match Status", "visitor_callable": true, "when_blocked": {"invalid_parameters": "match_id", "match_not_found": "rooms.quick_match", "not_a_participant": "rooms.quick_match"}, "when_to_use": "Read seat/status by match_id without mutating."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.match_status", "related_tools": ["rooms.quick_match", "rooms.poll_events"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rooms Match Status", "visitor_callable": true, "when_blocked": {"invalid_parameters": "match_id", "match_not_found": "rooms.quick_match", "not_a_participant": "rooms.quick_match"}, "when_to_use": "Read seat/status by match_id without mutating."}, "do_not_use_when": "Read-only — use rooms.poll_events when you need events.", "domain": "rooms", "domain_title": "Rooms MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match", "not_a_participant": "Only seated players may poll or open ws_ticket — rooms.quick_match first. → next: rooms.quick_match"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rooms.gen1", "core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Read seat/status by match_id without mutating.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rooms", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"exists": {"description": "boolean", "type": "boolean"}, "match_id": {"description": "string", "type": "string"}, "ok": {"description": "boolean", "type": "boolean"}, "seats_taken": {"description": "int", "type": "integer"}, "status": {"description": "string", "type": "string"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "owner_gene": "core.mcp.rooms.gen1", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["rooms.quick_match", "rooms.poll_events"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "rooms_match_status", "semantic_input_mode": "inherit_workflow", "summary": "Read quick-match status by match_id.", "title": "Rooms Match Status", "when_blocked": {"invalid_parameters": "match_id", "match_not_found": "rooms.quick_match", "not_a_participant": "rooms.quick_match"}, "when_not_to_use": "Read-only — use rooms.poll_events when you need events.", "when_to_use": "Read seat/status by match_id without mutating.", "write_mode": null}, {"action": "rooms.create", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "intermediate", "domain": "games", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.create", "related_tools": ["rooms.join_by_code", "rooms.list_open", "rooms.poll_events"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rooms Create", "visitor_callable": true, "when_blocked": {"auth_required_to_host": "auth.login — guests use quick_match or join_by_code", "invalid_parameters": "script_id + authenticated user_id", "room_create_failed": "Retry script_id + relay capacity", "room_table_full": "rooms.leave stale matches", "service_cap_denied": "Mint POST /api/hosted-apps/{pid}/session — hosted cookie + hosted_shell_read caps"}, "when_to_use": "Signed-in host creates a lobby with invite_code; pair with list_open or private code share."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "games", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.create", "related_tools": ["rooms.join_by_code", "rooms.list_open", "rooms.poll_events"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rooms Create", "visitor_callable": true, "when_blocked": {"auth_required_to_host": "auth.login — guests use quick_match or join_by_code", "invalid_parameters": "script_id + authenticated user_id", "room_create_failed": "Retry script_id + relay capacity", "room_table_full": "rooms.leave stale matches", "service_cap_denied": "Mint POST /api/hosted-apps/{pid}/session — hosted cookie + hosted_shell_read caps"}, "when_to_use": "Signed-in host creates a lobby with invite_code; pair with list_open or private code share."}, "do_not_use_when": "Not for one-click open pool — use rooms.quick_match. Guests cannot host.", "domain": "rooms", "domain_title": "Rooms MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required_to_host": "Custom lobby host requires sign-in — guests use rooms.quick_match or join_by_code. → next: auth.login", "invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "room_create_failed": "Could not allocate relay room — retry or lower concurrent matches. → next: rooms.quick_match", "room_table_full": "In-process room table full — rooms.leave stale matches, then rooms.quick_match. → next: rooms.leave", "service_cap_denied": "Hosted MCP needs session cookie (POST /api/hosted-apps/{pid}/session) — not API key alone on /s/{pid}/mcp. → next: auth.get_profile"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rooms.gen1", "core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Signed-in host creates a lobby with invite_code; pair with list_open or private code share.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rooms", "owner_gene": "core.mcp.rooms.gen1", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["rooms.join_by_code", "rooms.list_open", "rooms.poll_events"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "rooms_create", "semantic_input_mode": "inherit_workflow", "summary": "Create a custom lobby (host seat). Signed-in players only — guests use quick_match or join_by_code.", "title": "Rooms Create", "when_blocked": {"auth_required_to_host": "auth.login — guests use quick_match or join_by_code", "invalid_parameters": "script_id + authenticated user_id", "room_create_failed": "Retry script_id + relay capacity", "room_table_full": "rooms.leave stale matches", "service_cap_denied": "Mint POST /api/hosted-apps/{pid}/session — hosted cookie + hosted_shell_read caps"}, "when_not_to_use": "Not for one-click open pool — use rooms.quick_match. Guests cannot host.", "when_to_use": "Signed-in host creates a lobby with invite_code; pair with list_open or private code share.", "write_mode": null}, {"action": "rooms.list_open", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "simple", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.list_open", "related_tools": ["rooms.join_by_code", "rooms.quick_match"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rooms List Open", "visitor_callable": true, "when_blocked": {"invalid_parameters": "project_id"}, "when_to_use": "Browse public waiting lobbies before join_by_code or quick_match."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.list_open", "related_tools": ["rooms.join_by_code", "rooms.quick_match"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rooms List Open", "visitor_callable": true, "when_blocked": {"invalid_parameters": "project_id"}, "when_to_use": "Browse public waiting lobbies before join_by_code or quick_match."}, "do_not_use_when": "Not for anonymous quick pool — use rooms.quick_match.", "domain": "rooms", "domain_title": "Rooms MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rooms.gen1", "core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Browse public waiting lobbies before join_by_code or quick_match.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rooms", "owner_gene": "core.mcp.rooms.gen1", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["rooms.join_by_code", "rooms.quick_match"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "rooms_list_open", "semantic_input_mode": "inherit_workflow", "summary": "List public waiting lobbies (no private invite-only rooms).", "title": "Rooms List Open", "when_blocked": {"invalid_parameters": "project_id"}, "when_not_to_use": "Not for anonymous quick pool — use rooms.quick_match.", "when_to_use": "Browse public waiting lobbies before join_by_code or quick_match.", "write_mode": null}, {"action": "rooms.join_by_code", "aliases": ["room.join", "rooms.join"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "simple", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.join_by_code", "related_tools": ["rooms.create", "rooms.poll_events", "stream.relay.ws_ticket"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rooms Join By Code", "visitor_callable": true, "when_blocked": {"invalid_parameters": "invite_code + user_id", "invite_not_found": "rooms.list_open or ask host", "join_failed": "rooms.leave then retry", "match_full": "rooms.quick_match", "match_provisioning": "Lobby still starting — retry join_by_code in ~200ms"}, "when_to_use": "Guest joins host lobby using invite_code from rooms.create."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.join_by_code", "related_tools": ["rooms.create", "rooms.poll_events", "stream.relay.ws_ticket"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rooms Join By Code", "visitor_callable": true, "when_blocked": {"invalid_parameters": "invite_code + user_id", "invite_not_found": "rooms.list_open or ask host", "join_failed": "rooms.leave then retry", "match_full": "rooms.quick_match", "match_provisioning": "Lobby still starting — retry join_by_code in ~200ms"}, "when_to_use": "Guest joins host lobby using invite_code from rooms.create."}, "do_not_use_when": "Not for anonymous open pool — use rooms.quick_match unless you have invite_code.", "domain": "rooms", "domain_title": "Rooms MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "invite_not_found": "Unknown invite_code — ask host to re-share invite_code from rooms.create. → next: rooms.list_open", "join_failed": "Runtime room join failed — rooms.leave then rooms.quick_match with new idempotency_key. → next: rooms.quick_match", "match_full": "No open seats — new quick_match or wait bot_fill / poll_events. → next: rooms.poll_events", "match_provisioning": "Lobby room is still being created — retry quick_match or join_by_code in ~200ms (same idempotency_key). → next: rooms.quick_match"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rooms.gen1", "core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Guest joins host lobby using invite_code from rooms.create.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rooms", "owner_gene": "core.mcp.rooms.gen1", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["rooms.create", "rooms.poll_events", "stream.relay.ws_ticket"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "read", "safe_action": "rooms_join_by_code", "semantic_input_mode": "inherit_workflow", "summary": "Join a lobby by invite_code from rooms.create (guest-friendly).", "title": "Rooms Join By Code", "when_blocked": {"invalid_parameters": "invite_code + user_id", "invite_not_found": "rooms.list_open or ask host", "join_failed": "rooms.leave then retry", "match_full": "rooms.quick_match", "match_provisioning": "Lobby still starting — retry join_by_code in ~200ms"}, "when_not_to_use": "Not for anonymous open pool — use rooms.quick_match unless you have invite_code.", "when_to_use": "Guest joins host lobby using invite_code from rooms.create.", "write_mode": null}, {"action": "safety.evaluate", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.safety.gen1"], "id": "safety.evaluate", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Safety Evaluate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Score user or model text against the project safety policy and return a verdict."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.safety.gen1"], "id": "safety.evaluate", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Safety Evaluate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Score user or model text against the project safety policy and return a verdict."}, "domain": "safety", "domain_title": "Safety MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "genetic_tags": ["core.mcp.safety.gen1"], "instruction_hint": "Score user or model text against the project safety policy and return a verdict.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.safety", "owner_gene": "core.mcp.safety.gen1", "plane": "Safety probe: safety.evaluate — rules-first verdict; tenant overlays via generation plane.", "plane_chooser": "Probe one text: safety.evaluate (bots_run cap). Rules-first verdict — not a second safety LLM. Tenant playbook overlays: knowledge.config.patch + generation.promote — not raw prod DNA scripts.", "related_prompts": ["agentstack_knowledge_safety_tune"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "safety_evaluate", "semantic_input_mode": "inherit_workflow", "summary": "Score user or model text against the project safety policy and return a verdict.", "title": "Safety Evaluate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Score user or model text against the project safety policy and return a verdict.", "write_mode": null}, {"action": "seo.meta.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "seo", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["docs.seo.surface.gen1"], "id": "seo.meta.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Seo Meta Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Public marketing meta for path (title, OG, JSON-LD)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "seo", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["docs.seo.surface.gen1"], "id": "seo.meta.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Seo Meta Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Public marketing meta for path (title, OG, JSON-LD)."}, "domain": "seo", "domain_title": "Seo MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.seo.gen1"], "instruction_hint": "Public marketing meta for path (title, OG, JSON-LD).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.seo", "owner_gene": "core.mcp.seo.gen1", "plane": "SEO surface: seo.meta.get — indexable meta caps in shared/seo/; not hosting bytes.", "plane_chooser": "Marketing meta: seo.meta.get path=/…. Copy caps live in shared/seo — not hosting.bucket.file.patch. After registry/deploy copy changes: seo.cache.clear; readiness: seo.health.check.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "seo_meta_get", "semantic_input_mode": "inherit_workflow", "summary": "Fetch dynamic meta tags for a public marketing path (title, description, OG, JSON-LD).", "title": "Seo Meta Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Public marketing meta for path (title, OG, JSON-LD).", "write_mode": null}, {"action": "seo.health.check", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "seo", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["docs.seo.surface.gen1"], "id": "seo.health.check", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Seo Health Check", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "SEO registry + indexable path readiness."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "seo", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["docs.seo.surface.gen1"], "id": "seo.health.check", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Seo Health Check", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "SEO registry + indexable path readiness."}, "domain": "seo", "domain_title": "Seo MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.seo.gen1"], "instruction_hint": "SEO registry + indexable path readiness.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.seo", "owner_gene": "core.mcp.seo.gen1", "plane": "SEO surface: seo.meta.get — indexable meta caps in shared/seo/; not hosting bytes.", "plane_chooser": "Marketing meta: seo.meta.get path=/…. Copy caps live in shared/seo — not hosting.bucket.file.patch. After registry/deploy copy changes: seo.cache.clear; readiness: seo.health.check.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "seo_health_check", "semantic_input_mode": "inherit_workflow", "summary": "SEO registry version, indexable path count, and hosting funnel readiness.", "title": "Seo Health Check", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "SEO registry + indexable path readiness.", "write_mode": null}, {"action": "seo.cache.clear", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "seo", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["docs.seo.surface.gen1"], "id": "seo.cache.clear", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Seo Cache Clear", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Invalidate SEO neural cache; optional IndexNow ping."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "seo", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["docs.seo.surface.gen1"], "id": "seo.cache.clear", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Seo Cache Clear", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Invalidate SEO neural cache; optional IndexNow ping."}, "domain": "seo", "domain_title": "Seo MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.seo.gen1"], "instruction_hint": "Invalidate SEO neural cache; optional IndexNow ping.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.seo", "owner_gene": "core.mcp.seo.gen1", "plane": "SEO surface: seo.meta.get — indexable meta caps in shared/seo/; not hosting bytes.", "plane_chooser": "Marketing meta: seo.meta.get path=/…. Copy caps live in shared/seo — not hosting.bucket.file.patch. After registry/deploy copy changes: seo.cache.clear; readiness: seo.health.check.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "seo_cache_clear", "semantic_input_mode": "inherit_workflow", "summary": "Invalidate neural SEO meta + robots/sitemap caches; optionally ping IndexNow.", "title": "Seo Cache Clear", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Invalidate SEO neural cache; optional IndexNow ping.", "write_mode": null}, {"action": "showcase.catalog.get", "aliases": ["showcase.catalog"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.get", "related_tools": ["showcase.catalog.list_entries", "showcase.health.probe", "showcase.entry.resolve"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Full merged catalog + settings + health for ecosystem pid=1. Entries expose icon_path + icon_candidates resolved from project DNA brand leaves (showcase.icon_url, showcase.logo_url) with catalog overr"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.get", "related_tools": ["showcase.catalog.list_entries", "showcase.health.probe", "showcase.entry.resolve"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Full merged catalog + settings + health for ecosystem pid=1. Entries expose icon_path + icon_candidates resolved from project DNA brand leaves (showcase.icon_url, showcase.logo_url) with catalog overr"}, "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Full merged catalog + settings + health for ecosystem pid=1. Entries expose icon_path + icon_candid…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.list_entries", "showcase.health.probe", "showcase.entry.resolve"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "showcase_catalog_get", "semantic_input_mode": "inherit_workflow", "summary": "Merged public showcase catalog (ecosystem DNA + fixture seed). Each catalog.entries[] row includes icon_path and icon_candidates (svg/png/webp/jpg fallback chain under /showcase/icons/). Prefer showca", "title": "Showcase Catalog Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Full merged catalog + settings + health for ecosystem pid=1. Entries expose icon_path + icon_candidates resolved from project DNA brand leaves (showcase.icon_url, showcase.logo_url) with catalog overr", "write_mode": null}, {"action": "showcase.catalog.list_entries", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.list_entries", "related_tools": ["showcase.catalog.get", "showcase.entry.resolve"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog List Entries", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover gallery cards without full catalog.get — each row has icon_path for UI/MCP agents. Pair with showcase.entry.resolve before build/republish."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.list_entries", "related_tools": ["showcase.catalog.get", "showcase.entry.resolve"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog List Entries", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover gallery cards without full catalog.get — each row has icon_path for UI/MCP agents. Pair with showcase.entry.resolve before build/republish."}, "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Discover gallery cards without full catalog.get — each row has icon_path for UI/MCP agents. Pair wi…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.get", "showcase.entry.resolve"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "showcase_catalog_list_entries", "semantic_input_mode": "inherit_workflow", "summary": "Lightweight list of showcase catalog cards (merged). Each row includes icon_path + icon_candidates (svg→png→webp→jpg) for gallery and MCP agents.", "title": "Showcase Catalog List Entries", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover gallery cards without full catalog.get — each row has icon_path for UI/MCP agents. Pair with showcase.entry.resolve before build/republish.", "write_mode": null}, {"action": "showcase.catalog.patch_entry", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.patch_entry", "mutation_risk": "low", "related_tools": ["showcase.catalog.get", "showcase.catalog.diff_vs_fixture", "showcase.health.probe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Patch Entry", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "unknown_entry": "Unknown catalog entry_id — sync fixture or showcase.catalog.sync_fixture on ecosystem pid=1", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Edit title, tagline, hosting_bucket, status, or SEO overrides on one card — merged base, DNA leaf write. Gallery updates via catalog_revision without SPA deploy."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.patch_entry", "mutation_risk": "low", "related_tools": ["showcase.catalog.get", "showcase.catalog.diff_vs_fixture", "showcase.health.probe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Patch Entry", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "unknown_entry": "Unknown catalog entry_id — sync fixture or showcase.catalog.sync_fixture on ecosystem pid=1", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Edit title, tagline, hosting_bucket, status, or SEO overrides on one card — merged base, DNA leaf write. Gallery updates via catalog_revision without SPA deploy."}, "do_not_use_when": "Tenant demo DNA — safe_project_cycle + generation.promote, not catalog upsert on tenant pid.", "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Edit title, tagline, hosting_bucket, status, or SEO overrides on one card — merged base, DNA leaf w…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.get", "showcase.catalog.diff_vs_fixture", "showcase.health.probe"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_catalog_patch_entry", "semantic_input_mode": "inherit_workflow", "summary": "Partial update of one merged gallery card on ecosystem DNA (project_id=1). Uses effective catalog (DNA + fixture fill) as base. Patch keys match ShowcaseCatalogEntry fields (title, tagline, hosting_bu", "title": "Showcase Catalog Patch Entry", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "unknown_entry": "Unknown catalog entry_id — sync fixture or showcase.catalog.sync_fixture on ecosystem pid=1", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Tenant demo DNA — safe_project_cycle + generation.promote, not catalog upsert on tenant pid.", "when_to_use": "Edit title, tagline, hosting_bucket, status, or SEO overrides on one card — merged base, DNA leaf write. Gallery updates via catalog_revision without SPA deploy.", "write_mode": null}, {"action": "showcase.catalog.diff_vs_fixture", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.diff_vs_fixture", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Diff Vs Fixture", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drift report missing_in_dna / extra_in_dna before sync_fixture or export_fixture git commit."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.diff_vs_fixture", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Diff Vs Fixture", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drift report missing_in_dna / extra_in_dna before sync_fixture or export_fixture git commit."}, "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Drift report missing_in_dna / extra_in_dna before sync_fixture or export_fixture git commit.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "showcase_catalog_diff_vs_fixture", "semantic_input_mode": "inherit_workflow", "summary": "Drift report: DNA catalog entry ids vs git fixture.", "title": "Showcase Catalog Diff Vs Fixture", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drift report missing_in_dna / extra_in_dna before sync_fixture or export_fixture git commit.", "write_mode": null}, {"action": "showcase.catalog.sync_fixture", "ai_tips": "Materialize git fixture into DNA: mode missing (new ids), align (overwrite shared fields), align_and_prune (drop extra_in_dna). After align modes, applies showcase.catalog.apply_canonical_order (games first, TailRush lead). dry_run previews drift.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "align_and_prune on prod without dry_run — removes DNA-only cards (extra_in_dna).", "anti_patterns": ["align_and_prune on prod without dry_run — removes DNA-only cards (extra_in_dna).", "Editing only public/showcase-catalog.json — does not change live gallery."], "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Materializes showcase_catalog_v1.json into ecosystem DNA; dry_run skips writes.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.sync_fixture", "mutation_risk": "low", "related_tools": ["showcase.catalog.diff_vs_fixture", "showcase.catalog.export_fixture", "showcase.health.probe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Sync Fixture", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Materialize git fixture into DNA: mode missing (new ids), align (overwrite shared fields), align_and_prune (drop extra_in_dna). After align modes, applies showcase.catalog.apply_canonical_order (games"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Materializes showcase_catalog_v1.json into ecosystem DNA; dry_run skips writes.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.sync_fixture", "mutation_risk": "low", "related_tools": ["showcase.catalog.diff_vs_fixture", "showcase.catalog.export_fixture", "showcase.health.probe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Sync Fixture", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Materialize git fixture into DNA: mode missing (new ids), align (overwrite shared fields), align_and_prune (drop extra_in_dna). After align modes, applies showcase.catalog.apply_canonical_order (games"}, "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"conditional_mutate": "Materializes showcase_catalog_v1.json into ecosystem DNA; dry_run skips writes.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Materializes showcase_catalog_v1.json into ecosystem DNA; dry_run skips writes.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Materialize git fixture into DNA: mode missing (new ids), align (overwrite shared fields), align_an…", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.diff_vs_fixture", "showcase.catalog.export_fixture", "showcase.health.probe"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_catalog_sync_fixture", "semantic_input_mode": "inherit_workflow", "summary": "Pull git fixture showcase_catalog_v1.json into ecosystem DNA (pid=1) — no SPA deploy. mode=missing (default): add cards absent from DNA. mode=align: also overwrite shared ids from fixture (hosting_buc", "title": "Showcase Catalog Sync Fixture", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Materialize git fixture into DNA: mode missing (new ids), align (overwrite shared fields), align_and_prune (drop extra_in_dna). After align modes, applies showcase.catalog.apply_canonical_order (games", "write_mode": null}, {"action": "showcase.catalog.export_fixture", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.export_fixture", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Export Fixture", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export merged effective catalog for committing showcase_catalog_v1.json + static mirror."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.export_fixture", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Export Fixture", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export merged effective catalog for committing showcase_catalog_v1.json + static mirror."}, "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Export merged effective catalog for committing showcase_catalog_v1.json + static mirror.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "showcase_catalog_export_fixture", "semantic_input_mode": "inherit_workflow", "summary": "Export merged catalog as fixture-shaped JSON for git sync.", "title": "Showcase Catalog Export Fixture", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export merged effective catalog for committing showcase_catalog_v1.json + static mirror.", "write_mode": null}, {"action": "showcase.catalog.delete_entry", "ai_tips": "Remove a stale gallery card from DNA (e.g. rename hosted-game-lab → war-tactics). Does not unpublish tenant /s/ bytes.", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Deleting tenant project or hosting bucket — catalog row only; use tenant ops for /s/ bytes.", "anti_patterns": ["Deleting tenant project or hosting bucket — catalog row only; use tenant ops for /s/ bytes."], "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.delete_entry", "mutation_risk": "high", "related_tools": ["showcase.catalog.diff_vs_fixture", "showcase.catalog.sync_fixture"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Delete Entry", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "unknown_entry": "Unknown catalog entry_id — sync fixture or showcase.catalog.sync_fixture on ecosystem pid=1", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove a stale gallery card from DNA (e.g. rename hosted-game-lab → war-tactics). Does not unpublish tenant /s/ bytes."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.delete_entry", "mutation_risk": "high", "related_tools": ["showcase.catalog.diff_vs_fixture", "showcase.catalog.sync_fixture"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Delete Entry", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "unknown_entry": "Unknown catalog entry_id — sync fixture or showcase.catalog.sync_fixture on ecosystem pid=1", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove a stale gallery card from DNA (e.g. rename hosted-game-lab → war-tactics). Does not unpublish tenant /s/ bytes."}, "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Remove a stale gallery card from DNA (e.g. rename hosted-game-lab → war-tactics). Does not unpublis…", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.diff_vs_fixture", "showcase.catalog.sync_fixture"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "showcase_catalog_delete_entry", "semantic_input_mode": "inherit_workflow", "summary": "Remove one gallery card from ecosystem DNA (project_id=1). Drops entries_by_id, entry_order, and showcase.projects slug map. Does not delete tenant hosting bytes — use generation supply on tenant pid.", "title": "Showcase Catalog Delete Entry", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "unknown_entry": "Unknown catalog entry_id — sync fixture or showcase.catalog.sync_fixture on ecosystem pid=1", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove a stale gallery card from DNA (e.g. rename hosted-game-lab → war-tactics). Does not unpublish tenant /s/ bytes.", "write_mode": null}, {"action": "showcase.catalog.upsert_entry", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.upsert_entry", "mutation_risk": "low", "related_tools": ["showcase.catalog.patch_entry", "showcase.tenant.register"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Upsert Entry", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add or replace a full gallery card on pid=1 DNA. After backend ships new fixture ids, prefer showcase.catalog.sync_fixture mode=missing unless you need a custom row."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.upsert_entry", "mutation_risk": "low", "related_tools": ["showcase.catalog.patch_entry", "showcase.tenant.register"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Upsert Entry", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add or replace a full gallery card on pid=1 DNA. After backend ships new fixture ids, prefer showcase.catalog.sync_fixture mode=missing unless you need a custom row."}, "do_not_use_when": "Ecosystem pid=1 fixture supply only — not tenant heal scripts.", "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Add or replace a full gallery card on pid=1 DNA. After backend ships new fixture ids, prefer showca…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.patch_entry", "showcase.tenant.register"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_catalog_upsert_entry", "semantic_input_mode": "inherit_workflow", "summary": "Upsert one full ShowcaseCatalogEntry on ecosystem DNA (pid=1). Validates schema (project_slug showcase-*, active+hosting_bucket needs project_id>2). Prefer patch_entry for copy/bucket tweaks; upsert f", "title": "Showcase Catalog Upsert Entry", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Ecosystem pid=1 fixture supply only — not tenant heal scripts.", "when_to_use": "Add or replace a full gallery card on pid=1 DNA. After backend ships new fixture ids, prefer showcase.catalog.sync_fixture mode=missing unless you need a custom row.", "write_mode": null}, {"action": "showcase.settings.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.settings.patch", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Settings Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Featured hero card id, public_cache_max_age_s, hire_sku_map — gallery chrome without deploy."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.settings.patch", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Settings Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Featured hero card id, public_cache_max_age_s, hire_sku_map — gallery chrome without deploy."}, "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Featured hero card id, public_cache_max_age_s, hire_sku_map — gallery chrome without deploy.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_settings_patch", "semantic_input_mode": "inherit_workflow", "summary": "Patch showcase gallery settings on ecosystem DNA.", "title": "Showcase Settings Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Featured hero card id, public_cache_max_age_s, hire_sku_map — gallery chrome without deploy.", "write_mode": null}, {"action": "showcase.catalog.reorder", "ai_tips": "Change /showcase portfolio vs platform section order via entry_order. Run after sync_fixture when adding game cards.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Rewrites ecosystem DNA entry_order for gallery cards.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.reorder", "mutation_risk": "low", "related_tools": ["showcase.catalog.list_entries", "showcase.settings.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Reorder", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Change /showcase portfolio vs platform section order via entry_order. Run after sync_fixture when adding game cards."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Rewrites ecosystem DNA entry_order for gallery cards.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.reorder", "mutation_risk": "low", "related_tools": ["showcase.catalog.list_entries", "showcase.settings.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Reorder", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Change /showcase portfolio vs platform section order via entry_order. Run after sync_fixture when adding game cards."}, "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"conditional_mutate": "Rewrites ecosystem DNA entry_order for gallery cards.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Rewrites ecosystem DNA entry_order for gallery cards.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Change /showcase portfolio vs platform section order via entry_order. Run after sync_fixture when a…", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.list_entries", "showcase.settings.patch"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_catalog_reorder", "semantic_input_mode": "inherit_workflow", "summary": "Set gallery card order (entry_order on ecosystem DNA). Only ids present in DNA entries_by_id are kept; unknown ids are dropped silently.", "title": "Showcase Catalog Reorder", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Change /showcase portfolio vs platform section order via entry_order. Run after sync_fixture when adding game cards.", "write_mode": null}, {"action": "showcase.project.heal_gallery_marks", "ai_tips": "When cards lack a tenant mark — seed showcase.icon_url using BFF icon candidate order (platform monogram before generic /s/…/favicon). Skips real HTTPS/storage marks. dry_run first.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Overwriting custom showcase.icon_url — skips pids that already have a gallery-safe mark.", "anti_patterns": ["Overwriting custom showcase.icon_url — skips pids that already have a gallery-safe mark.", "Replacing catalog icon_path on pid=1 — this writes tenant project DNA only."], "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.project.heal_gallery_marks", "mutation_risk": "low", "related_tools": ["showcase.catalog.list_entries", "showcase.catalog.sync_fixture", "showcase.health.probe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Project Heal Gallery Marks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "When cards lack a tenant mark — seed showcase.icon_url using BFF icon candidate order (platform monogram before generic /s/…/favicon). Skips real HTTPS/storage marks. dry_run first."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.project.heal_gallery_marks", "mutation_risk": "low", "related_tools": ["showcase.catalog.list_entries", "showcase.catalog.sync_fixture", "showcase.health.probe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Project Heal Gallery Marks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "When cards lack a tenant mark — seed showcase.icon_url using BFF icon candidate order (platform monogram before generic /s/…/favicon). Skips real HTTPS/storage marks. dry_run first."}, "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "When cards lack a tenant mark — seed showcase.icon_url using BFF icon candidate order (platform mon…", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.list_entries", "showcase.catalog.sync_fixture", "showcase.health.probe"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_project_heal_gallery_marks", "semantic_input_mode": "inherit_workflow", "summary": "Seed tenant ``showcase.icon_url`` when no real gallery mark exists — uses the same candidate order as the public BFF (monogram before unprobed /s/…/favicon). Skips tenants that already have HTTPS, sto", "title": "Showcase Project Heal Gallery Marks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "When cards lack a tenant mark — seed showcase.icon_url using BFF icon candidate order (platform monogram before generic /s/…/favicon). Skips real HTTPS/storage marks. dry_run first.", "write_mode": null}, {"action": "showcase.catalog.apply_canonical_order", "ai_tips": "Fix DNA entry_order when EditFlow leads but games should — TailRush first, then thermomorphs/war-tactics/serpent/kamni, then other portfolio tenants. No card edits.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.apply_canonical_order", "mutation_risk": "low", "related_tools": ["showcase.catalog.sync_fixture", "showcase.catalog.list_entries", "showcase.catalog.reorder"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Apply Canonical Order", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fix DNA entry_order when EditFlow leads but games should — TailRush first, then thermomorphs/war-tactics/serpent/kamni, then other portfolio tenants. No card edits."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.apply_canonical_order", "mutation_risk": "low", "related_tools": ["showcase.catalog.sync_fixture", "showcase.catalog.list_entries", "showcase.catalog.reorder"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Apply Canonical Order", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fix DNA entry_order when EditFlow leads but games should — TailRush first, then thermomorphs/war-tactics/serpent/kamni, then other portfolio tenants. No card edits."}, "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Fix DNA entry_order when EditFlow leads but games should — TailRush first, then thermomorphs/war-ta…", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.sync_fixture", "showcase.catalog.list_entries", "showcase.catalog.reorder"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_catalog_apply_canonical_order", "semantic_input_mode": "inherit_workflow", "summary": "Rewrite ecosystem DNA entry_order so hosted games lead (TailRush first) without changing card payloads — matches /showcase SPA sort.", "title": "Showcase Catalog Apply Canonical Order", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fix DNA entry_order when EditFlow leads but games should — TailRush first, then thermomorphs/war-tactics/serpent/kamni, then other portfolio tenants. No card edits.", "write_mode": null}, {"action": "showcase.health.probe", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Expecting health stamps for ecosystem_catalog_only backlog cards — they have no /s/ bucket.", "anti_patterns": ["Expecting health stamps for ecosystem_catalog_only backlog cards — they have no /s/ bucket.", "Full-catalog probe in tight MCP sync batch — pass entry_ids to avoid N parallel HTTP probes."], "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.health.probe", "mutation_risk": "low", "related_tools": ["showcase.build.republish_entry", "showcase.sources.sync_status", "showcase.catalog.list_entries"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Health Probe", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After VPS republish or deploy.verify — stamp data.showcase.health when /s/ edge is ok. Scope with entry_ids (e.g. arcanestack, thermomorphs); backlog cards without bucket are skipped."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.health.probe", "mutation_risk": "low", "related_tools": ["showcase.build.republish_entry", "showcase.sources.sync_status", "showcase.catalog.list_entries"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Health Probe", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After VPS republish or deploy.verify — stamp data.showcase.health when /s/ edge is ok. Scope with entry_ids (e.g. arcanestack, thermomorphs); backlog cards without bucket are skipped."}, "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "After VPS republish or deploy.verify — stamp data.showcase.health when /s/ edge is ok. Scope with e…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.build.republish_entry", "showcase.sources.sync_status", "showcase.catalog.list_entries"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "showcase_health_probe", "semantic_input_mode": "inherit_workflow", "summary": "HTTP-probe canonical /s/{pid}/ buckets for active catalog entries and stamp ecosystem health when edge returns ok. Pass entry_ids to scope probes; omitting probes all active entries with hosting_bucke", "title": "Showcase Health Probe", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After VPS republish or deploy.verify — stamp data.showcase.health when /s/ edge is ok. Scope with entry_ids (e.g. arcanestack, thermomorphs); backlog cards without bucket are skipped.", "write_mode": null}, {"action": "showcase.tenant.register", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.tenant.register", "mutation_risk": "high", "related_tools": ["showcase.catalog.upsert_entry", "showcase.catalog.patch_entry", "showcase.project.heal_gallery_marks"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Tenant Register", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add a new independent_tenant gallery card on pid=1 DNA — live on /showcase without SPA deploy. Does not provision /s/ bytes; run agent_next heal + health.probe, then safe_project_cycle on tenant pid."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.tenant.register", "mutation_risk": "high", "related_tools": ["showcase.catalog.upsert_entry", "showcase.catalog.patch_entry", "showcase.project.heal_gallery_marks"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Tenant Register", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add a new independent_tenant gallery card on pid=1 DNA — live on /showcase without SPA deploy. Does not provision /s/ bytes; run agent_next heal + health.probe, then safe_project_cycle on tenant pid."}, "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Add a new independent_tenant gallery card on pid=1 DNA — live on /showcase without SPA deploy. Does…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.upsert_entry", "showcase.catalog.patch_entry", "showcase.project.heal_gallery_marks"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "showcase_tenant_register", "semantic_input_mode": "inherit_workflow", "summary": "Register an independent tenant on the public showcase (gallery card only).", "title": "Showcase Tenant Register", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add a new independent_tenant gallery card on pid=1 DNA — live on /showcase without SPA deploy. Does not provision /s/ bytes; run agent_next heal + health.probe, then safe_project_cycle on tenant pid.", "write_mode": null}, {"action": "showcase.build.republish_entry", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Tenant flagship DNA — use generation.promote on tenant pid, not platform_proof republish.", "anti_patterns": ["Tenant flagship DNA — use generation.promote on tenant pid, not platform_proof republish.", "independent_tenant catalog cards — tenant_generation_supply jurisdiction."], "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["repo.ops.prod_showcase.gen1"], "id": "showcase.build.republish_entry", "mutation_risk": "high", "related_tools": ["showcase.workspace.hydrate", "hosting.site.build", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Build Republish Entry", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "enqueue_lock_busy": "Retry hosting.site.build with the same project_id and bucket — the lock has no job_id yet. Do not poll hosting.site.build_status until enqueue returns job_id.", "entry_id_required": "Pass catalog entry_id (e.g. arcanestack, thermomorphs, editflow)", "forbidden": "Ecosystem owner required — auth.get_profile", "hosting_site_missing": "Bootstrap hosting bucket — showcase provisioning / deploy republish", "hydrate_source_missing": "Sync compile plane (deploy.showcase_sync_sources) or rebuild backend image", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "republish_failed": "Inspect data.error — often hydrate_source_missing or build step failure", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Republish one workspace platform_proof via hydrate + hosting.site.build. publish_plane=git_journal entries skip; push or promote with hosting.git instead."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["repo.ops.prod_showcase.gen1"], "id": "showcase.build.republish_entry", "mutation_risk": "high", "related_tools": ["showcase.workspace.hydrate", "hosting.site.build", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Build Republish Entry", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "enqueue_lock_busy": "Retry hosting.site.build with the same project_id and bucket — the lock has no job_id yet. Do not poll hosting.site.build_status until enqueue returns job_id.", "entry_id_required": "Pass catalog entry_id (e.g. arcanestack, thermomorphs, editflow)", "forbidden": "Ecosystem owner required — auth.get_profile", "hosting_site_missing": "Bootstrap hosting bucket — showcase provisioning / deploy republish", "hydrate_source_missing": "Sync compile plane (deploy.showcase_sync_sources) or rebuild backend image", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "republish_failed": "Inspect data.error — often hydrate_source_missing or build step failure", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Republish one workspace platform_proof via hydrate + hosting.site.build. publish_plane=git_journal entries skip; push or promote with hosting.git instead."}, "do_not_use_when": "Tenant flagship/site bytes — generation.promote on tenant pid, not platform_proof republish.", "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"execution_class": "heavy", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "heavy", "genetic_tags": ["core.mcp.showcase.gen1"], "hosting_atoms": {"HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_GIT_PLANE_CHOOSER": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branches dev or main. (2) generation.promote moves 8DNA only (config, fleet, knowledge) — not site bytes. Pass env_uuid on the write params. Skip a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. (3) Platform checkouts agentstack-core and shared often have no git remote — they ship by VPS deploy. Empty origin means do not git push origin. agentstack-frontend tracks agentstack/dev. 'push to dev' is plane 1, not generation.promote and not target=prod."}, "instruction_hint": "Republish one workspace platform_proof via hydrate + hosting.site.build. publish_plane=git_journal …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.workspace.hydrate", "hosting.site.build", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "production_publish", "safe_action": "showcase_build_republish_entry", "semantic_input_mode": "inherit_workflow", "summary": "Republish one platform_proof entry (ops_jurisdiction=showcase_bootstrap, PIDs 1438–1443). Not for tenant_generation_supply — use agentstack_safe_project_cycle.", "title": "Showcase Build Republish Entry", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "enqueue_lock_busy": "Retry hosting.site.build with the same project_id and bucket — the lock has no job_id yet. Do not poll hosting.site.build_status until enqueue returns job_id.", "entry_id_required": "Pass catalog entry_id (e.g. arcanestack, thermomorphs, editflow)", "forbidden": "Ecosystem owner required — auth.get_profile", "hosting_site_missing": "Bootstrap hosting bucket — showcase provisioning / deploy republish", "hydrate_source_missing": "Sync compile plane (deploy.showcase_sync_sources) or rebuild backend image", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "republish_failed": "Inspect data.error — often hydrate_source_missing or build step failure", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Tenant flagship/site bytes — generation.promote on tenant pid, not platform_proof republish.", "when_to_use": "Republish one workspace platform_proof via hydrate + hosting.site.build. publish_plane=git_journal entries skip; push or promote with hosting.git instead.", "workflow_ladder": [{"notes": "Once per bucket (arcanestack-prod on pid 1438).", "step": "hosting.git.init"}, {"notes": "Preview enqueue via post-receive.", "step": "git push agentstack HEAD:dev"}, {"notes": "job_id only — poll until completed.", "step": "hosting.site.build_status"}, {"notes": "ref=dev target=prod after green preview.", "step": "hosting.git.promote_branch"}, {"notes": "DNA only — dry_run first.", "step": "showcase.arcanestack.ensure_rules"}, {"notes": "entry_ids=[arcanestack].", "step": "showcase.health.probe"}], "write_mode": null}, {"action": "showcase.arcanestack.ensure_rules", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["repo.ops.prod_showcase.gen1"], "id": "showcase.arcanestack.ensure_rules", "mutation_risk": "low", "related_tools": ["showcase.build.republish_entry", "showcase.entry.resolve", "showcase.health.probe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Arcanestack Ensure Rules", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "enqueue_lock_busy": "Retry hosting.site.build with the same project_id and bucket — the lock has no job_id yet. Do not poll hosting.site.build_status until enqueue returns job_id.", "execution_error": "Read report in the error payload; fix the named rule or FAP leaf, then dry_run again", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Post-heal leaf: sync card-game FAP and logic templates onto the catalog proof project. SPA bytes stay on the git journal (publish_plane). dry_run first. Not a site republish."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["repo.ops.prod_showcase.gen1"], "id": "showcase.arcanestack.ensure_rules", "mutation_risk": "low", "related_tools": ["showcase.build.republish_entry", "showcase.entry.resolve", "showcase.health.probe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Arcanestack Ensure Rules", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "enqueue_lock_busy": "Retry hosting.site.build with the same project_id and bucket — the lock has no job_id yet. Do not poll hosting.site.build_status until enqueue returns job_id.", "execution_error": "Read report in the error payload; fix the named rule or FAP leaf, then dry_run again", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Post-heal leaf: sync card-game FAP and logic templates onto the catalog proof project. SPA bytes stay on the git journal (publish_plane). dry_run first. Not a site republish."}, "do_not_use_when": "Routine deploy — use deploy registry or VPS scripts; MCP is post-heal leaf DNA only.", "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"execution_class": "heavy", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "heavy", "genetic_tags": ["core.mcp.showcase.gen1"], "hosting_atoms": {"HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_GIT_PLANE_CHOOSER": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branches dev or main. (2) generation.promote moves 8DNA only (config, fleet, knowledge) — not site bytes. Pass env_uuid on the write params. Skip a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. (3) Platform checkouts agentstack-core and shared often have no git remote — they ship by VPS deploy. Empty origin means do not git push origin. agentstack-frontend tracks agentstack/dev. 'push to dev' is plane 1, not generation.promote and not target=prod."}, "instruction_hint": "Post-heal leaf: sync card-game FAP and logic templates onto the catalog proof project. SPA bytes st…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.build.republish_entry", "showcase.entry.resolve", "showcase.health.probe"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_arcanestack_ensure_rules", "semantic_input_mode": "inherit_workflow", "summary": "Leaf-sync card-game FAP and logic templates onto the catalog proof project. Does not publish SPA bytes — those come from the git journal.", "title": "Showcase Arcanestack Ensure Rules", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "enqueue_lock_busy": "Retry hosting.site.build with the same project_id and bucket — the lock has no job_id yet. Do not poll hosting.site.build_status until enqueue returns job_id.", "execution_error": "Read report in the error payload; fix the named rule or FAP leaf, then dry_run again", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Routine deploy — use deploy registry or VPS scripts; MCP is post-heal leaf DNA only.", "when_to_use": "Post-heal leaf: sync card-game FAP and logic templates onto the catalog proof project. SPA bytes stay on the git journal (publish_plane). dry_run first. Not a site republish.", "workflow_ladder": [{"notes": "Once per bucket (arcanestack-prod on pid 1438).", "step": "hosting.git.init"}, {"notes": "Preview enqueue via post-receive.", "step": "git push agentstack HEAD:dev"}, {"notes": "job_id only — poll until completed.", "step": "hosting.site.build_status"}, {"notes": "ref=dev target=prod after green preview.", "step": "hosting.git.promote_branch"}, {"notes": "DNA only — dry_run first.", "step": "showcase.arcanestack.ensure_rules"}, {"notes": "entry_ids=[arcanestack].", "step": "showcase.health.probe"}], "write_mode": null}, {"action": "showcase.workspace.hydrate", "ai_tips": "Bootstrap platform_proof bucket workspace/ from operator sources (same layout tenants use). Re-runs when .showcase_compile_sha drifts; then hosting.workspace.file.put + hosting.site.build.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Tenant buckets — hosting.workspace.init on tenant pid.", "anti_patterns": ["Tenant buckets — hosting.workspace.init on tenant pid.", "Hydrate before SHOWCASE_SOURCES_ROOT sync on VPS — workspace will be empty."], "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Copies archetype sources into hosting workspace bucket.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["repo.ops.prod_showcase.gen1", "core.hosting.bucket.gen1"], "id": "showcase.workspace.hydrate", "mutation_risk": "low", "related_tools": ["hosting.workspace.file.put", "hosting.site.build", "showcase.build.republish_entry"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Workspace Hydrate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "enqueue_lock_busy": "Retry hosting.site.build with the same project_id and bucket — the lock has no job_id yet. Do not poll hosting.site.build_status until enqueue returns job_id.", "entry_id_required": "Pass catalog entry_id (e.g. arcanestack, thermomorphs, editflow)", "forbidden": "Ecosystem owner required — auth.get_profile", "hosting_site_missing": "Bootstrap hosting bucket — showcase provisioning / deploy republish", "hydrate_source_missing": "Sync compile plane (deploy.showcase_sync_sources) or rebuild backend image", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bootstrap platform_proof bucket workspace/ from operator sources (same layout tenants use). Re-runs when .showcase_compile_sha drifts; then hosting.workspace.file.put + hosting.site.build."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Copies archetype sources into hosting workspace bucket.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["repo.ops.prod_showcase.gen1", "core.hosting.bucket.gen1"], "id": "showcase.workspace.hydrate", "mutation_risk": "low", "related_tools": ["hosting.workspace.file.put", "hosting.site.build", "showcase.build.republish_entry"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Workspace Hydrate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "enqueue_lock_busy": "Retry hosting.site.build with the same project_id and bucket — the lock has no job_id yet. Do not poll hosting.site.build_status until enqueue returns job_id.", "entry_id_required": "Pass catalog entry_id (e.g. arcanestack, thermomorphs, editflow)", "forbidden": "Ecosystem owner required — auth.get_profile", "hosting_site_missing": "Bootstrap hosting bucket — showcase provisioning / deploy republish", "hydrate_source_missing": "Sync compile plane (deploy.showcase_sync_sources) or rebuild backend image", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bootstrap platform_proof bucket workspace/ from operator sources (same layout tenants use). Re-runs when .showcase_compile_sha drifts; then hosting.workspace.file.put + hosting.site.build."}, "do_not_use_when": "Tenant buckets — hosting.workspace.init (+ seed_from_live) on tenant pid; do not use showcase.* hydrate (platform proof bootstrap only).", "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"conditional_mutate": "Copies archetype sources into hosting workspace bucket.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Copies archetype sources into hosting workspace bucket.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "hosting_atoms": {"HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_GIT_PLANE_CHOOSER": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branches dev or main. (2) generation.promote moves 8DNA only (config, fleet, knowledge) — not site bytes. Pass env_uuid on the write params. Skip a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. (3) Platform checkouts agentstack-core and shared often have no git remote — they ship by VPS deploy. Empty origin means do not git push origin. agentstack-frontend tracks agentstack/dev. 'push to dev' is plane 1, not generation.promote and not target=prod."}, "instruction_hint": "Bootstrap platform_proof bucket workspace/ from operator sources (same layout tenants use). Re-runs…", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["hosting.workspace.file.put", "hosting.site.build", "showcase.build.republish_entry"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_workspace_hydrate", "semantic_input_mode": "inherit_workflow", "summary": "Copy platform_proof archetype sources into bucket workspace/ for MCP edit + site.build.", "title": "Showcase Workspace Hydrate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "enqueue_lock_busy": "Retry hosting.site.build with the same project_id and bucket — the lock has no job_id yet. Do not poll hosting.site.build_status until enqueue returns job_id.", "entry_id_required": "Pass catalog entry_id (e.g. arcanestack, thermomorphs, editflow)", "forbidden": "Ecosystem owner required — auth.get_profile", "hosting_site_missing": "Bootstrap hosting bucket — showcase provisioning / deploy republish", "hydrate_source_missing": "Sync compile plane (deploy.showcase_sync_sources) or rebuild backend image", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Tenant buckets — hosting.workspace.init (+ seed_from_live) on tenant pid; do not use showcase.* hydrate (platform proof bootstrap only).", "when_to_use": "Bootstrap platform_proof bucket workspace/ from operator sources (same layout tenants use). Re-runs when .showcase_compile_sha drifts; then hosting.workspace.file.put + hosting.site.build.", "workflow_ladder": [{"notes": "Once per bucket (arcanestack-prod on pid 1438).", "step": "hosting.git.init"}, {"notes": "Preview enqueue via post-receive.", "step": "git push agentstack HEAD:dev"}, {"notes": "job_id only — poll until completed.", "step": "hosting.site.build_status"}, {"notes": "ref=dev target=prod after green preview.", "step": "hosting.git.promote_branch"}, {"notes": "DNA only — dry_run first.", "step": "showcase.arcanestack.ensure_rules"}, {"notes": "entry_ids=[arcanestack].", "step": "showcase.health.probe"}], "write_mode": null}, {"action": "showcase.sources.sync_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.prod_showcase.gen1"], "id": "showcase.sources.sync_status", "related_tools": ["showcase.sources.sync", "showcase.workspace.hydrate"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Sources Sync Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read VPS compile-plane status: manifest sha sidecar (last Windows upload), compile_ready, manifest_in_sync vs repo manifest when both exist. Does not hash the whole tree."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.prod_showcase.gen1"], "id": "showcase.sources.sync_status", "related_tools": ["showcase.sources.sync", "showcase.workspace.hydrate"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Sources Sync Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read VPS compile-plane status: manifest sha sidecar (last Windows upload), compile_ready, manifest_in_sync vs repo manifest when both exist. Does not hash the whole tree."}, "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Read VPS compile-plane status: manifest sha sidecar (last Windows upload), compile_ready, manifest_…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.sources.sync", "showcase.workspace.hydrate"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "showcase_sources_sync_status", "semantic_input_mode": "inherit_workflow", "summary": "Read VPS showcase-sources sync sidecar (sha256) when present.", "title": "Showcase Sources Sync Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read VPS compile-plane status: manifest sha sidecar (last Windows upload), compile_ready, manifest_in_sync vs repo manifest when both exist. Does not hash the whole tree.", "write_mode": null}, {"action": "showcase.sources.sync", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Expecting API/SCP from backend container — use Deploy Console or deploy-from-windows.ps1.", "anti_patterns": ["Expecting API/SCP from backend container — use Deploy Console or deploy-from-windows.ps1."], "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.prod_showcase.gen1"], "id": "showcase.sources.sync", "related_tools": ["showcase.sources.sync_status", "showcase.workspace.hydrate"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Sources Sync", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Contract-only: no API SCP. Windows deploy.showcase_sync_sources unless SHOWCASE_COMPILE_PLANE_VPS_SOT=1 (agents edit compile tree on VPS)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.prod_showcase.gen1"], "id": "showcase.sources.sync", "related_tools": ["showcase.sources.sync_status", "showcase.workspace.hydrate"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Sources Sync", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Contract-only: no API SCP. Windows deploy.showcase_sync_sources unless SHOWCASE_COMPILE_PLANE_VPS_SOT=1 (agents edit compile tree on VPS)."}, "do_not_use_when": "In-repo sync runs on Windows deploy host — MCP documents deploy.showcase_sync_sources contract.", "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Contract-only: no API SCP. Windows deploy.showcase_sync_sources unless SHOWCASE_COMPILE_PLANE_VPS_S…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.sources.sync_status", "showcase.workspace.hydrate"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "showcase_sources_sync", "semantic_input_mode": "inherit_workflow", "summary": "Operator contract for VPS showcase-sources sync. SCP runs via Deploy Console step deploy.showcase_sync_sources (Invoke-ShowcaseSyncSourcesOnVps), not from API.", "title": "Showcase Sources Sync", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "In-repo sync runs on Windows deploy host — MCP documents deploy.showcase_sync_sources contract.", "when_to_use": "Contract-only: no API SCP. Windows deploy.showcase_sync_sources unless SHOWCASE_COMPILE_PLANE_VPS_SOT=1 (agents edit compile tree on VPS).", "write_mode": null}, {"action": "showcase.entry.resolve", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Calling showcase.build.republish_entry for independent_tenant — use hosting.site.build on tenant pid.", "Skipping resolve and guessing plane from entry title — always resolve entry_id first."], "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.prod_showcase.gen1", "core.mcp.self_description.gen1"], "id": "showcase.entry.resolve", "related_tools": ["showcase.build.republish_entry", "showcase.workspace.hydrate", "showcase.sources.sync_status", "hosting.workspace.init", "hosting.site.build", "generation.supply_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Entry Resolve", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "entry_id_required": "Pass catalog entry_id (e.g. arcanestack, thermomorphs, editflow)", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_pid_or_bucket": "Entry lacks project_id or hosting_bucket — fix catalog row before republish", "platform_proof_entry_required": "Action is platform_proof only — tenant cards use tenant_generation_supply", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "unknown_entry": "Unknown catalog entry_id — sync fixture or showcase.catalog.sync_fixture on ecosystem pid=1", "unknown_entry_kind": "Catalog entry missing entry_kind — fix fixture / DNA upsert", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wrong_jurisdiction": "ops_jurisdiction mismatch for entry_kind — use showcase.entry.resolve plane"}, "when_to_use": "Before hydrate/republish — route entry_id to showcase_bootstrap vs tenant_generation_supply vs ecosystem_catalog_only (backlog cards without /s/). Gallery marks SoT: tenant project DNA showcase.icon_u"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.prod_showcase.gen1", "core.mcp.self_description.gen1"], "id": "showcase.entry.resolve", "related_tools": ["showcase.build.republish_entry", "showcase.workspace.hydrate", "showcase.sources.sync_status", "hosting.workspace.init", "hosting.site.build", "generation.supply_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Entry Resolve", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "entry_id_required": "Pass catalog entry_id (e.g. arcanestack, thermomorphs, editflow)", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_pid_or_bucket": "Entry lacks project_id or hosting_bucket — fix catalog row before republish", "platform_proof_entry_required": "Action is platform_proof only — tenant cards use tenant_generation_supply", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "unknown_entry": "Unknown catalog entry_id — sync fixture or showcase.catalog.sync_fixture on ecosystem pid=1", "unknown_entry_kind": "Catalog entry missing entry_kind — fix fixture / DNA upsert", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wrong_jurisdiction": "ops_jurisdiction mismatch for entry_kind — use showcase.entry.resolve plane"}, "when_to_use": "Before hydrate/republish — route entry_id to showcase_bootstrap vs tenant_generation_supply vs ecosystem_catalog_only (backlog cards without /s/). Gallery marks SoT: tenant project DNA showcase.icon_u"}, "domain": "showcase", "domain_title": "Showcase MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Before hydrate/republish — route entry_id to showcase_bootstrap vs tenant_generation_supply vs ecos…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.build.republish_entry", "showcase.workspace.hydrate", "showcase.sources.sync_status", "hosting.workspace.init", "hosting.site.build", "generation.supply_status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "showcase_entry_resolve", "semantic_input_mode": "inherit_workflow", "summary": "Route a showcase catalog entry_id to operator plane and suggested MCP actions (platform_proof vs independent_tenant).", "title": "Showcase Entry Resolve", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "entry_id_required": "Pass catalog entry_id (e.g. arcanestack, thermomorphs, editflow)", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_pid_or_bucket": "Entry lacks project_id or hosting_bucket — fix catalog row before republish", "platform_proof_entry_required": "Action is platform_proof only — tenant cards use tenant_generation_supply", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "unknown_entry": "Unknown catalog entry_id — sync fixture or showcase.catalog.sync_fixture on ecosystem pid=1", "unknown_entry_kind": "Catalog entry missing entry_kind — fix fixture / DNA upsert", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wrong_jurisdiction": "ops_jurisdiction mismatch for entry_kind — use showcase.entry.resolve plane"}, "when_to_use": "Before hydrate/republish — route entry_id to showcase_bootstrap vs tenant_generation_supply vs ecosystem_catalog_only (backlog cards without /s/). Gallery marks SoT: tenant project DNA showcase.icon_u", "write_mode": null}, {"action": "social.chat.index_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.index_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Index Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; empty entries[] is valid for new users", "forbidden": "social_read cap or operator session required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — MCP context must carry user_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get the current user's messenger sidebar index — list of channels with pinned/order metadata."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.index_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Index Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; empty entries[] is valid for new users", "forbidden": "social_read cap or operator session required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — MCP context must carry user_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get the current user's messenger sidebar index — list of channels with pinned/order metadata."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"execution_error": "Retry once; empty entries[] is valid for new users", "forbidden": "social_read cap or operator session required", "unauthorized": "auth.get_profile — MCP context must carry user_id"}, "execution_class": "plain_read", "instruction_hint": "Get the current user's messenger sidebar index — list of channels with pinned/order metadata.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_chat_index_get", "semantic_input_mode": "inherit_workflow", "summary": "Get the current user's messenger sidebar index — list of channels with pinned/order metadata.", "title": "Social Chat Index Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; empty entries[] is valid for new users", "forbidden": "social_read cap or operator session required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — MCP context must carry user_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get the current user's messenger sidebar index — list of channels with pinned/order metadata.", "write_mode": null}, {"action": "social.chat.index_put", "ai_tips": "Replace messenger sidebar index (subset-as-delete).", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.index_put", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Index Put", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap required", "invalid_parameters": "channel_id and entries required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Replace the messenger sidebar index (subset-as-delete with If-Match on REST)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.index_put", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Index Put", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap required", "invalid_parameters": "channel_id and entries required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Replace the messenger sidebar index (subset-as-delete with If-Match on REST)."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"forbidden": "social_read cap required", "invalid_parameters": "channel_id and entries required"}, "execution_class": "cheap", "instruction_hint": "Replace the messenger sidebar index (subset-as-delete with If-Match on REST).", "messenger_atoms": ["CHAT_INDEX_PUT"], "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_chat_index_put", "semantic_input_mode": "inherit_workflow", "summary": "Replace the messenger sidebar index (subset-as-delete with If-Match on REST).", "title": "Social Chat Index Put", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap required", "invalid_parameters": "channel_id and entries required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Replace the messenger sidebar index (subset-as-delete with If-Match on REST).", "write_mode": ["replace"], "write_mode_note": "Exception: subset-as-delete with If-Match. A short list can drop missing keys. Do not apply bots-style merge defaults here."}, {"action": "social.chat.history", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.history", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat History", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap or channel membership required", "invalid_parameters": "channel_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown — social.channels.register or channel_invites.direct", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Messenger channel history — use social.support.history for support tickets."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.history", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat History", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap or channel membership required", "invalid_parameters": "channel_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown — social.channels.register or channel_invites.direct", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Messenger channel history — use social.support.history for support tickets."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "social_read cap or channel membership required", "invalid_parameters": "channel_id required", "not_found": "channel_id unknown — social.channels.register or channel_invites.direct"}, "execution_class": "plain_read", "instruction_hint": "Messenger channel history — use social.support.history for support tickets.", "messenger_atoms": ["CHAT_SINCE_SEQ"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_chat_history", "semantic_input_mode": "inherit_workflow", "summary": "Read chat history from a messenger channel (AI-accessible).", "title": "Social Chat History", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap or channel membership required", "invalid_parameters": "channel_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown — social.channels.register or channel_invites.direct", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Messenger channel history — use social.support.history for support tickets.", "write_mode": null}, {"action": "social.chat.post", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.post", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Post", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "post_policy or membership denied", "invalid_parameters": "channel_id and body required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "In-app messenger message — not project support (psup) thread."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.post", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Post", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "post_policy or membership denied", "invalid_parameters": "channel_id and body required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "In-app messenger message — not project support (psup) thread."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"forbidden": "post_policy or membership denied", "invalid_parameters": "channel_id and body required", "not_found": "channel_id unknown"}, "execution_class": "cheap", "instruction_hint": "In-app messenger message — not project support (psup) thread.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_chat_post", "semantic_input_mode": "inherit_workflow", "summary": "Send a chat message to a messenger channel as the AI agent (authenticated user).", "title": "Social Chat Post", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "post_policy or membership denied", "invalid_parameters": "channel_id and body required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "In-app messenger message — not project support (psup) thread.", "write_mode": null}, {"action": "social.chat.pin", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.pin", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Pin", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pin a message in a channel."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.pin", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Pin", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pin a message in a channel."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Pin a message in a channel.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_chat_pin", "semantic_input_mode": "inherit_workflow", "summary": "Pin a message in a channel.", "title": "Social Chat Pin", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pin a message in a channel.", "write_mode": null}, {"action": "social.chat.unpin", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.unpin", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Unpin", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Unpin a message in a channel."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.unpin", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Unpin", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Unpin a message in a channel."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Unpin a message in a channel.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_chat_unpin", "semantic_input_mode": "inherit_workflow", "summary": "Unpin a message in a channel.", "title": "Social Chat Unpin", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Unpin a message in a channel.", "write_mode": null}, {"action": "social.chat.message_edit", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.message_edit", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Message Edit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "author-only edit or membership denied", "invalid_parameters": "channel_id, message_id, and body required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "message or channel unknown", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Edit own chat message (author only)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.message_edit", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Message Edit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "author-only edit or membership denied", "invalid_parameters": "channel_id, message_id, and body required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "message or channel unknown", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Edit own chat message (author only)."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "author-only edit or membership denied", "invalid_parameters": "channel_id, message_id, and body required", "not_found": "message or channel unknown"}, "execution_class": "plain_read", "instruction_hint": "Edit own chat message (author only).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_chat_message_edit", "semantic_input_mode": "inherit_workflow", "summary": "Edit own chat message (author only).", "title": "Social Chat Message Edit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "author-only edit or membership denied", "invalid_parameters": "channel_id, message_id, and body required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "message or channel unknown", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Edit own chat message (author only).", "write_mode": null}, {"action": "social.chat.message_delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.message_delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Message Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "delete_forbidden — author or channel owner per server rules", "invalid_parameters": "channel_id and message_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "message or channel unknown", "saved_channel_forbidden": "Cannot delete in saved-channel slice — pick live channel", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete a chat message (author or channel owner per server rules)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.message_delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Message Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "delete_forbidden — author or channel owner per server rules", "invalid_parameters": "channel_id and message_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "message or channel unknown", "saved_channel_forbidden": "Cannot delete in saved-channel slice — pick live channel", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete a chat message (author or channel owner per server rules)."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "errors": {"forbidden": "delete_forbidden — author or channel owner per server rules", "invalid_parameters": "channel_id and message_id required", "not_found": "message or channel unknown", "saved_channel_forbidden": "Cannot delete in saved-channel slice — pick live channel"}, "execution_class": "cheap", "instruction_hint": "Delete a chat message (author or channel owner per server rules).", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "social_chat_message_delete", "semantic_input_mode": "inherit_workflow", "summary": "Delete a chat message (author or channel owner per server rules).", "title": "Social Chat Message Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "delete_forbidden — author or channel owner per server rules", "invalid_parameters": "channel_id and message_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "message or channel unknown", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "saved_channel_forbidden": "Cannot delete in saved-channel slice — pick live channel", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete a chat message (author or channel owner per server rules).", "write_mode": null}, {"action": "social.chat.reaction", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.reaction", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Reaction", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "membership or reaction policy denied", "invalid_parameters": "channel_id, message_id, and emoji required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "message or channel unknown", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply one server-authoritative reaction on a message (immutable cell per user)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.reaction", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Reaction", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "membership or reaction policy denied", "invalid_parameters": "channel_id, message_id, and emoji required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "message or channel unknown", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply one server-authoritative reaction on a message (immutable cell per user)."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "membership or reaction policy denied", "invalid_parameters": "channel_id, message_id, and emoji required", "not_found": "message or channel unknown"}, "execution_class": "plain_read", "instruction_hint": "Apply one server-authoritative reaction on a message (immutable cell per user).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_chat_reaction", "semantic_input_mode": "inherit_workflow", "summary": "Apply one server-authoritative reaction on a message (immutable cell per user).", "title": "Social Chat Reaction", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "membership or reaction policy denied", "invalid_parameters": "channel_id, message_id, and emoji required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "message or channel unknown", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply one server-authoritative reaction on a message (immutable cell per user).", "write_mode": null}, {"action": "social.chat.read_set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.read_set", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Read Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update last-read pointer (read receipt) for a channel."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.read_set", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Read Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update last-read pointer (read receipt) for a channel."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Update last-read pointer (read receipt) for a channel.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_chat_read_set", "semantic_input_mode": "inherit_workflow", "summary": "Update last-read pointer (read receipt) for a channel.", "title": "Social Chat Read Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update last-read pointer (read receipt) for a channel.", "write_mode": null}, {"action": "social.chat.read_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.read_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Read Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get last-read state for a channel for the current user."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.read_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Read Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get last-read state for a channel for the current user."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Get last-read state for a channel for the current user.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_chat_read_get", "semantic_input_mode": "inherit_workflow", "summary": "Get last-read state for a channel for the current user.", "title": "Social Chat Read Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get last-read state for a channel for the current user.", "write_mode": null}, {"action": "social.chat.presence_online", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.presence_online", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Presence Online", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List user IDs currently online (active SSE stream-relay connection) in the home project."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.presence_online", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Presence Online", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List user IDs currently online (active SSE stream-relay connection) in the home project."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List user IDs currently online (active SSE stream-relay connection) in the home project.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_chat_presence_online", "semantic_input_mode": "inherit_workflow", "summary": "List user IDs currently online (active SSE stream-relay connection) in the home project.", "title": "Social Chat Presence Online", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List user IDs currently online (active SSE stream-relay connection) in the home project.", "write_mode": null}, {"action": "social.friends.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List friends for the current user."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List friends for the current user."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List friends for the current user.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_friends_list", "semantic_input_mode": "inherit_workflow", "summary": "List friends for the current user.", "title": "Social Friends List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List friends for the current user.", "write_mode": null}, {"action": "social.friends.user_ids", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.user_ids", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends User Ids", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ordered friend user id list."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.user_ids", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends User Ids", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ordered friend user id list."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Ordered friend user id list.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_friends_user_ids", "semantic_input_mode": "inherit_workflow", "summary": "Ordered friend user id list.", "title": "Social Friends User Ids", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ordered friend user id list.", "write_mode": null}, {"action": "social.friends.cards", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.cards", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Cards", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Public card fields for each friend."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.cards", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Cards", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Public card fields for each friend."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Public card fields for each friend.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_friends_cards", "semantic_input_mode": "inherit_workflow", "summary": "Public card fields for each friend.", "title": "Social Friends Cards", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Public card fields for each friend.", "write_mode": null}, {"action": "social.friends.cards_batch", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.cards_batch", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Cards Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Friend cards for specific user ids (must be friends)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.cards_batch", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Cards Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Friend cards for specific user ids (must be friends)."}, "do_not_use_when": "Only when friend ids are known — list/user_ids first.", "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Friend cards for specific user ids (must be friends).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_friends_cards_batch", "semantic_input_mode": "inherit_workflow", "summary": "Friend cards for specific user ids (must be friends).", "title": "Social Friends Cards Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Only when friend ids are known — list/user_ids first.", "when_to_use": "Friend cards for specific user ids (must be friends).", "write_mode": null}, {"action": "social.followers.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.followers.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Followers List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap required", "invalid_parameters": "home_project_id or user scope", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Users who follow the current user."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.followers.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Followers List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap required", "invalid_parameters": "home_project_id or user scope", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Users who follow the current user."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "social_read cap required", "invalid_parameters": "home_project_id or user scope", "unauthorized": "auth.get_profile required"}, "execution_class": "plain_read", "instruction_hint": "Users who follow the current user.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Merged timeline: social.merge_feed — not per-channel social.chat.history. Federation graph: social.federation.add before cross-project public publish.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_followers_list", "semantic_input_mode": "inherit_workflow", "summary": "Users who follow the current user.", "title": "Social Followers List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap required", "invalid_parameters": "home_project_id or user scope", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Users who follow the current user.", "write_mode": null}, {"action": "social.privacy.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.privacy.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Privacy Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project membership required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get friend/DM privacy settings."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.privacy.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Privacy Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project membership required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get friend/DM privacy settings."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "project membership required", "unauthorized": "auth.get_profile required"}, "execution_class": "plain_read", "instruction_hint": "Get friend/DM privacy settings.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_privacy_get", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Get friend/DM privacy settings.", "title": "Social Privacy Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project membership required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get friend/DM privacy settings.", "write_mode": null}, {"action": "social.privacy.put", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.privacy.put", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Privacy Put", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project write/admin required", "invalid_parameters": "privacy leaf shape — review diff before promote", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update privacy settings (incoming_friend_requests, dm_policy)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.privacy.put", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Privacy Put", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project write/admin required", "invalid_parameters": "privacy leaf shape — review diff before promote", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update privacy settings (incoming_friend_requests, dm_policy)."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"forbidden": "project write/admin required", "invalid_parameters": "privacy leaf shape — review diff before promote", "unauthorized": "auth.get_profile required"}, "execution_class": "cheap", "instruction_hint": "Update privacy settings (incoming_friend_requests, dm_policy).", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_privacy_put", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Update privacy settings (incoming_friend_requests, dm_policy).", "title": "Social Privacy Put", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project write/admin required", "invalid_parameters": "privacy leaf shape — review diff before promote", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update privacy settings (incoming_friend_requests, dm_policy).", "write_mode": null}, {"action": "social.friends.requests_in", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.requests_in", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Requests In", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Incoming friend requests."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.requests_in", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Requests In", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Incoming friend requests."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Incoming friend requests.", "mutation_kind": "none", "next_actions": ["social.friends.request_respond"], "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_friends_requests_in", "semantic_input_mode": "inherit_workflow", "summary": "Incoming friend requests.", "title": "Social Friends Requests In", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Incoming friend requests.", "write_mode": null}, {"action": "social.friends.requests_out", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.requests_out", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Requests Out", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Outgoing friend requests."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.requests_out", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Requests Out", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Outgoing friend requests."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Outgoing friend requests.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_friends_requests_out", "semantic_input_mode": "inherit_workflow", "summary": "Outgoing friend requests.", "title": "Social Friends Requests Out", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Outgoing friend requests.", "write_mode": null}, {"action": "social.friends.request_respond", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.request_respond", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Request Respond", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Accept/reject/subscriber/block on an incoming friend request."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.request_respond", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Request Respond", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Accept/reject/subscriber/block on an incoming friend request."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Accept/reject/subscriber/block on an incoming friend request.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_friends_request_respond", "semantic_input_mode": "inherit_workflow", "summary": "Accept/reject/subscriber/block on an incoming friend request.", "title": "Social Friends Request Respond", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Accept/reject/subscriber/block on an incoming friend request.", "write_mode": null}, {"action": "social.friends.request", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.request", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Request", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Send a friend request (optional source context for public_channel)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.request", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Request", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Send a friend request (optional source context for public_channel)."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Send a friend request (optional source context for public_channel).", "mutation_kind": "none", "next_actions": ["social.friends.requests_out"], "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_friends_request", "semantic_input_mode": "inherit_workflow", "summary": "Send a friend request (optional source context for public_channel).", "title": "Social Friends Request", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Send a friend request (optional source context for public_channel).", "write_mode": null}, {"action": "social.friends.accept", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.accept", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Accept", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Accept friend request from user_id."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.accept", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Accept", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Accept friend request from user_id."}, "do_not_use_when": "Prefer social.friends.request_respond when unified respond is available.", "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Accept friend request from user_id.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_friends_accept", "semantic_input_mode": "inherit_workflow", "summary": "Accept friend request from user_id.", "title": "Social Friends Accept", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Prefer social.friends.request_respond when unified respond is available.", "when_to_use": "Accept friend request from user_id.", "write_mode": null}, {"action": "social.friends.remove", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.remove", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Remove", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove an existing friend."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.remove", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Remove", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove an existing friend."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Remove an existing friend.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "low_write", "safe_action": "social_friends_remove", "semantic_input_mode": "inherit_workflow", "summary": "Remove an existing friend.", "title": "Social Friends Remove", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove an existing friend.", "write_mode": null}, {"action": "social.friends.reject", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.reject", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Reject", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reject a pending friend request."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.reject", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Reject", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reject a pending friend request."}, "do_not_use_when": "Prefer social.friends.request_respond for inbox triage.", "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Reject a pending friend request.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_friends_reject", "semantic_input_mode": "inherit_workflow", "summary": "Reject a pending friend request.", "title": "Social Friends Reject", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Prefer social.friends.request_respond for inbox triage.", "when_to_use": "Reject a pending friend request.", "write_mode": null}, {"action": "social.friends.cancel", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.cancel", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Cancel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cancel outgoing friend request."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.cancel", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Cancel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cancel outgoing friend request."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Cancel outgoing friend request.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_friends_cancel", "semantic_input_mode": "inherit_workflow", "summary": "Cancel outgoing friend request.", "title": "Social Friends Cancel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cancel outgoing friend request.", "write_mode": null}, {"action": "social.friends.block", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.block", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Block", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Block a user."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.block", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Block", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Block a user."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Block a user.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_friends_block", "semantic_input_mode": "inherit_workflow", "summary": "Block a user.", "title": "Social Friends Block", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Block a user.", "write_mode": null}, {"action": "social.users.public_cards", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.users.public_cards", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Users Public Cards", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Public display cards for user ids (no friendship check)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.users.public_cards", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Users Public Cards", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Public display cards for user ids (no friendship check)."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Public display cards for user ids (no friendship check).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_users_public_cards", "semantic_input_mode": "inherit_workflow", "summary": "Public display cards for user ids (no friendship check).", "title": "Social Users Public Cards", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Public display cards for user ids (no friendship check).", "write_mode": null}, {"action": "social.users.lookup", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.users.lookup", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Users Lookup", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Find users by id, email, or @username (no email in response)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.users.lookup", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Users Lookup", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Find users by id, email, or @username (no email in response)."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Find users by id, email, or @username (no email in response).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_users_lookup", "semantic_input_mode": "inherit_workflow", "summary": "Find users by id, email, or @username (no email in response).", "title": "Social Users Lookup", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Find users by id, email, or @username (no email in response).", "write_mode": null}, {"action": "social.party_invite.mint", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Persists short-lived party invite token.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.party_invite.mint", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Party Invite Mint", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mint a short-lived party invite token for a relay room."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Persists short-lived party invite token.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.party_invite.mint", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Party Invite Mint", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mint a short-lived party invite token for a relay room."}, "domain": "social", "effect": {"conditional_mutate": "Persists short-lived party invite token.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Persists short-lived party invite token.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "instruction_hint": "Mint a short-lived party invite token for a relay room.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_party_invite_mint", "semantic_input_mode": "inherit_workflow", "summary": "Mint a short-lived party invite token for a relay room.", "title": "Social Party Invite Mint", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mint a short-lived party invite token for a relay room.", "write_mode": null}, {"action": "social.party_invite.verify", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.party_invite.verify", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Party Invite Verify", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify party invite token (no auth required on REST; MCP still needs project context)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.party_invite.verify", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Party Invite Verify", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify party invite token (no auth required on REST; MCP still needs project context)."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Verify party invite token (no auth required on REST; MCP still needs project context).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_party_invite_verify", "semantic_input_mode": "inherit_workflow", "summary": "Verify party invite token (no auth required on REST; MCP still needs project context).", "title": "Social Party Invite Verify", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify party invite token (no auth required on REST; MCP still needs project context).", "write_mode": null}, {"action": "social.channel_invites.link_token", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.link_token", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Link Token", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create shareable link token for a channel (owner)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.link_token", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Link Token", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create shareable link token for a channel (owner)."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Create shareable link token for a channel (owner).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_channel_invites_link_token", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Create shareable link token for a channel (owner).", "title": "Social Channel Invites Link Token", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create shareable link token for a channel (owner).", "write_mode": null}, {"action": "social.channel_invites.direct", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.direct", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Direct", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "channel owner or social_read cap required", "invalid_parameters": "channel_id and invitee user id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create direct channel invite to a user (owner)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.direct", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Direct", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "channel owner or social_read cap required", "invalid_parameters": "channel_id and invitee user id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create direct channel invite to a user (owner)."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "channel owner or social_read cap required", "invalid_parameters": "channel_id and invitee user id required", "not_found": "channel_id unknown"}, "execution_class": "plain_read", "instruction_hint": "Create direct channel invite to a user (owner).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_channel_invites_direct", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Create direct channel invite to a user (owner).", "title": "Social Channel Invites Direct", "tool_chains": ["multi_tenant_onboarding"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "channel owner or social_read cap required", "invalid_parameters": "channel_id and invitee user id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create direct channel invite to a user (owner).", "write_mode": null}, {"action": "social.channel_invites.inbox", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.inbox", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Inbox", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List pending channel invites for the current user."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.inbox", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Inbox", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List pending channel invites for the current user."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List pending channel invites for the current user.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_channel_invites_inbox", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "List pending channel invites for the current user.", "title": "Social Channel Invites Inbox", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List pending channel invites for the current user.", "write_mode": null}, {"action": "social.channel_invites.accept", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.accept", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Accept", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Accept a channel invite from inbox."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.accept", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Accept", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Accept a channel invite from inbox."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Accept a channel invite from inbox.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_channel_invites_accept", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Accept a channel invite from inbox.", "title": "Social Channel Invites Accept", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Accept a channel invite from inbox.", "write_mode": null}, {"action": "social.channel_invites.decline", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.decline", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Decline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Decline a channel invite."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.decline", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Decline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Decline a channel invite."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Decline a channel invite.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_channel_invites_decline", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Decline a channel invite.", "title": "Social Channel Invites Decline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Decline a channel invite.", "write_mode": null}, {"action": "social.channel_invites.redeem", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.redeem", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Redeem", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Redeem channel invite token."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.redeem", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Redeem", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Redeem channel invite token."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Redeem channel invite token.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_channel_invites_redeem", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Redeem channel invite token.", "title": "Social Channel Invites Redeem", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Redeem channel invite token.", "write_mode": null}, {"action": "social.federation.add", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.federation.add", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Federation Add", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "both projects must grant federation", "invalid_parameters": "peer_project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add federated open-channel pointer on consumer project."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.federation.add", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Federation Add", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "both projects must grant federation", "invalid_parameters": "peer_project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add federated open-channel pointer on consumer project."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"forbidden": "both projects must grant federation", "invalid_parameters": "peer_project_id required", "unauthorized": "auth.get_profile required"}, "execution_class": "cheap", "instruction_hint": "Add federated open-channel pointer on consumer project.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Merged timeline: social.merge_feed — not per-channel social.chat.history. Federation graph: social.federation.add before cross-project public publish.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_federation_add", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Add federated open-channel pointer on consumer project.", "title": "Social Federation Add", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "both projects must grant federation", "invalid_parameters": "peer_project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add federated open-channel pointer on consumer project.", "write_mode": null}, {"action": "social.federation.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.federation.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Federation Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project read on home_project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "no federation edge — social.federation.add first", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List federation pointers for a consumer project."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.federation.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Federation Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project read on home_project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "no federation edge — social.federation.add first", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List federation pointers for a consumer project."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "project read on home_project_id", "not_found": "no federation edge — social.federation.add first", "unauthorized": "auth.get_profile required"}, "execution_class": "plain_read", "instruction_hint": "List federation pointers for a consumer project.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Merged timeline: social.merge_feed — not per-channel social.chat.history. Federation graph: social.federation.add before cross-project public publish.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_federation_get", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "List federation pointers for a consumer project.", "title": "Social Federation Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project read on home_project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "no federation edge — social.federation.add first", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List federation pointers for a consumer project.", "write_mode": null}, {"action": "social.channels.register", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.register", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channels Register", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap required", "invalid_parameters": "home_project_id and title required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "visibility/post_policy/room_kind invalid"}, "when_to_use": "Create a new messenger channel (group chat, DM, or broadcast)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.register", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channels Register", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap required", "invalid_parameters": "home_project_id and title required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "visibility/post_policy/room_kind invalid"}, "when_to_use": "Create a new messenger channel (group chat, DM, or broadcast)."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"forbidden": "social_read cap required", "invalid_parameters": "home_project_id and title required", "validation_error": "visibility/post_policy/room_kind invalid"}, "execution_class": "cheap", "instruction_hint": "Create a new messenger channel (group chat, DM, or broadcast).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_channels_register", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Create a new messenger channel (group chat, DM, or broadcast).", "title": "Social Channels Register", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap required", "invalid_parameters": "home_project_id and title required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "visibility/post_policy/room_kind invalid"}, "when_to_use": "Create a new messenger channel (group chat, DM, or broadcast).", "write_mode": null}, {"action": "social.channels.update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.update", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channels Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update channel metadata (owner)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.update", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channels Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update channel metadata (owner)."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Update channel metadata (owner).", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_channels_update", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Update channel metadata (owner).", "title": "Social Channels Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update channel metadata (owner).", "write_mode": null}, {"action": "social.channels.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channels Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete a channel (owner) and unpublish from public index."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channels Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete a channel (owner) and unpublish from public index."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Delete a channel (owner) and unpublish from public index.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "social_channels_delete", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Delete a channel (owner) and unpublish from public index.", "title": "Social Channels Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete a channel (owner) and unpublish from public index.", "write_mode": null}, {"action": "social.channels.list", "aliases": ["channels.list", "social.channel.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channels List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap or home project membership", "invalid_parameters": "home_project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — list requires signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List all channels in the home project."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channels List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap or home project membership", "invalid_parameters": "home_project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — list requires signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List all channels in the home project."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "social_read cap or home project membership", "invalid_parameters": "home_project_id required", "unauthorized": "auth.get_profile — list requires signed-in user"}, "execution_class": "plain_read", "instruction_hint": "List all channels in the home project.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_channels_list", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "List all channels in the home project.", "title": "Social Channels List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap or home project membership", "invalid_parameters": "home_project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — list requires signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List all channels in the home project.", "write_mode": null}, {"action": "social.channels.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channels Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get one channel if the current user may access it."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channels Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get one channel if the current user may access it."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Get one channel if the current user may access it.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_channels_get", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Get one channel if the current user may access it.", "title": "Social Channels Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get one channel if the current user may access it.", "write_mode": null}, {"action": "social.entities.expand", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.entities.expand", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Entities Expand", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Batch-resolve channel/surrogate ids to metadata (max 100 ids)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.entities.expand", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Entities Expand", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Batch-resolve channel/surrogate ids to metadata (max 100 ids)."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Batch-resolve channel/surrogate ids to metadata (max 100 ids).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_entities_expand", "semantic_input_mode": "inherit_workflow", "summary": "Batch-resolve channel/surrogate ids to metadata (max 100 ids).", "title": "Social Entities Expand", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Batch-resolve channel/surrogate ids to metadata (max 100 ids).", "write_mode": null}, {"action": "social.pas.public_me_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.pas.public_me_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Pas Public Me Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read Principal Access public slice for current user on a home project."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.pas.public_me_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Pas Public Me Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read Principal Access public slice for current user on a home project."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read Principal Access public slice for current user on a home project.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_pas_public_me_get", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Read Principal Access public slice for current user on a home project.", "title": "Social Pas Public Me Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read Principal Access public slice for current user on a home project.", "write_mode": null}, {"action": "social.pas.public_me_put", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.pas.public_me_put", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Pas Public Me Put", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Replace channels/chats/groups lists in PAS public slice."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.pas.public_me_put", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Pas Public Me Put", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Replace channels/chats/groups lists in PAS public slice."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Replace channels/chats/groups lists in PAS public slice.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_pas_public_me_put", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Replace channels/chats/groups lists in PAS public slice.", "title": "Social Pas Public Me Put", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Replace channels/chats/groups lists in PAS public slice.", "write_mode": null}, {"action": "social.public.quota_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.quota_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Quota Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Social public index quota for current user."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.quota_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Quota Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Social public index quota for current user."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Social public index quota for current user.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_public_quota_get", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Social public index quota for current user.", "title": "Social Public Quota Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Social public index quota for current user.", "write_mode": null}, {"action": "social.public.me", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.me", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Me", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Public maps from user row (ecosystem.social.public)."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.me", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Me", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Public maps from user row (ecosystem.social.public)."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Public maps from user row (ecosystem.social.public).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_public_me", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Public maps from user row (ecosystem.social.public).", "title": "Social Public Me", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Public maps from user row (ecosystem.social.public).", "write_mode": null}, {"action": "social.public.publish", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.publish", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Publish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "publish policy or social_read cap denied", "invalid_parameters": "home_project_id and channel_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown — social.channels.register first", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Publish a channel/chats/groups entry to public index."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.publish", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Publish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "publish policy or social_read cap denied", "invalid_parameters": "home_project_id and channel_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown — social.channels.register first", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Publish a channel/chats/groups entry to public index."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"forbidden": "publish policy or social_read cap denied", "invalid_parameters": "home_project_id and channel_id required", "not_found": "channel_id unknown — social.channels.register first"}, "execution_class": "cheap", "instruction_hint": "Publish a channel/chats/groups entry to public index.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "production_publish", "safe_action": "social_public_publish", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Publish a channel/chats/groups entry to public index.", "title": "Social Public Publish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "publish policy or social_read cap denied", "invalid_parameters": "home_project_id and channel_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown — social.channels.register first", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Publish a channel/chats/groups entry to public index.", "write_mode": null}, {"action": "social.public.unpublish", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.unpublish", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Unpublish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove a public index entry."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.unpublish", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Unpublish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove a public index entry."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Remove a public index entry.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "production_publish", "safe_action": "social_public_unpublish", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Remove a public index entry.", "title": "Social Public Unpublish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove a public index entry.", "write_mode": null}, {"action": "social.public.index", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.index", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Index", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read a page of the public discovery index."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.index", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Index", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read a page of the public discovery index."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read a page of the public discovery index.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_public_index", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Read a page of the public discovery index.", "title": "Social Public Index", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read a page of the public discovery index.", "write_mode": null}, {"action": "social.public.reconcile", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.reconcile", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reconcile public maps (privileged role only)."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.reconcile", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reconcile public maps (privileged role only)."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Reconcile public maps (privileged role only).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "social_public_reconcile", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Reconcile public maps (privileged role only).", "title": "Social Public Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reconcile public maps (privileged role only).", "write_mode": null}, {"action": "social.merge_feed", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "effect_override": {"conditional_mutate": "Merge-read only; no durable social writes.", "kind": "read", "read_only_hint": true}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.merge_feed", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Merge Feed", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap required", "invalid_parameters": "limit/cursor bounds — not social.chat.history", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — merged feed is per user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Merge read of multiple channel pointers (reader must access each). Each pointer is the latest 200 messages. Page one channel with social.chat.history."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "effect_override": {"conditional_mutate": "Merge-read only; no durable social writes.", "kind": "read", "read_only_hint": true}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.merge_feed", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Merge Feed", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap required", "invalid_parameters": "limit/cursor bounds — not social.chat.history", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — merged feed is per user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Merge read of multiple channel pointers (reader must access each). Each pointer is the latest 200 messages. Page one channel with social.chat.history."}, "domain": "social", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Merge-read only; no durable social writes.", "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "effect_override": {"conditional_mutate": "Merge-read only; no durable social writes.", "kind": "read", "read_only_hint": true}, "errors": {"forbidden": "social_read cap required", "invalid_parameters": "limit/cursor bounds — not social.chat.history", "unauthorized": "auth.get_profile — merged feed is per user"}, "execution_class": "plain_read", "instruction_hint": "Merge read of multiple channel pointers (reader must access each). Each pointer is the latest 200 m…", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Merged timeline: social.merge_feed — not per-channel social.chat.history. Federation graph: social.federation.add before cross-project public publish.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_merge_feed", "semantic_input_mode": "inherit_workflow", "summary": "Merge read of multiple channel pointers (reader must access each). Each pointer is the latest 200 messages. Page one channel with social.chat.history.", "title": "Social Merge Feed", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap required", "invalid_parameters": "limit/cursor bounds — not social.chat.history", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — merged feed is per user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Merge read of multiple channel pointers (reader must access each). Each pointer is the latest 200 messages. Page one channel with social.chat.history.", "write_mode": null}, {"action": "social.admin.chat_sweep", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.chat_sweep", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Chat Sweep", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run one chat history prune batch. Requires ecosystem owner/admin on project 1."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.chat_sweep", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Chat Sweep", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run one chat history prune batch. Requires ecosystem owner/admin on project 1."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Run one chat history prune batch. Requires ecosystem owner/admin on project 1.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_chat_sweep", "semantic_input_mode": "inherit_workflow", "summary": "Run one chat history prune batch. Requires ecosystem owner/admin on project 1.", "title": "Social Admin Chat Sweep", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run one chat history prune batch. Requires ecosystem owner/admin on project 1.", "write_mode": null}, {"action": "social.admin.user_summary", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.user_summary", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin User Summary", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: aggregate friend/request/block counts and messenger prefs summary for a user_id."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.user_summary", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin User Summary", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: aggregate friend/request/block counts and messenger prefs summary for a user_id."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: aggregate friend/request/block counts and messenger prefs summary for a user_id.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_user_summary", "semantic_input_mode": "inherit_workflow", "summary": "Operator: aggregate friend/request/block counts and messenger prefs summary for a user_id.", "title": "Social Admin User Summary", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: aggregate friend/request/block counts and messenger prefs summary for a user_id.", "write_mode": null}, {"action": "social.admin.chat_index_page", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.chat_index_page", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Chat Index Page", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: paginated messenger chat index for a user (cursor/limit)."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.chat_index_page", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Chat Index Page", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: paginated messenger chat index for a user (cursor/limit)."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: paginated messenger chat index for a user (cursor/limit).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_chat_index_page", "semantic_input_mode": "inherit_workflow", "summary": "Operator: paginated messenger chat index for a user (cursor/limit).", "title": "Social Admin Chat Index Page", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: paginated messenger chat index for a user (cursor/limit).", "write_mode": null}, {"action": "social.admin.channel_search", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.channel_search", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Channel Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: search channel metadata on a home_project_id by substring (id/title)."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.channel_search", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Channel Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: search channel metadata on a home_project_id by substring (id/title)."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: search channel metadata on a home_project_id by substring (id/title).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_channel_search", "semantic_input_mode": "inherit_workflow", "summary": "Operator: search channel metadata on a home_project_id by substring (id/title).", "title": "Social Admin Channel Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: search channel metadata on a home_project_id by substring (id/title).", "write_mode": null}, {"action": "social.admin.directory_search", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.directory_search", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Directory Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: unified typeahead — users (8DNA) + channels for a home_project_id."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.directory_search", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Directory Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: unified typeahead — users (8DNA) + channels for a home_project_id."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: unified typeahead — users (8DNA) + channels for a home_project_id.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_directory_search", "semantic_input_mode": "inherit_workflow", "summary": "Operator: unified typeahead — users (8DNA) + channels for a home_project_id.", "title": "Social Admin Directory Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: unified typeahead — users (8DNA) + channels for a home_project_id.", "write_mode": null}, {"action": "social.admin.messenger_policy_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.messenger_policy_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Messenger Policy Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: read messenger retention defaults, stored overrides, and merged effective policy."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.messenger_policy_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Messenger Policy Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: read messenger retention defaults, stored overrides, and merged effective policy."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: read messenger retention defaults, stored overrides, and merged effective policy.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_messenger_policy_get", "semantic_input_mode": "inherit_workflow", "summary": "Operator: read messenger retention defaults, stored overrides, and merged effective policy.", "title": "Social Admin Messenger Policy Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: read messenger retention defaults, stored overrides, and merged effective policy.", "write_mode": null}, {"action": "social.admin.messenger_policy_set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.messenger_policy_set", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Messenger Policy Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: replace messenger_operator_policy on ecosystem project (tiers, temp TTL, sweep ceiling)."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.messenger_policy_set", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Messenger Policy Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: replace messenger_operator_policy on ecosystem project (tiers, temp TTL, sweep ceiling)."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Operator: replace messenger_operator_policy on ecosystem project (tiers, temp TTL, sweep ceiling).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_admin_messenger_policy_set", "semantic_input_mode": "inherit_workflow", "summary": "Operator: replace messenger_operator_policy on ecosystem project (tiers, temp TTL, sweep ceiling).", "title": "Social Admin Messenger Policy Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: replace messenger_operator_policy on ecosystem project (tiers, temp TTL, sweep ceiling).", "write_mode": null}, {"action": "social.admin.messenger_client_cache_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.messenger_client_cache_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Messenger Client Cache Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: read messenger client cache limits (defaults, stored overrides, merged effective)."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.messenger_client_cache_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Messenger Client Cache Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: read messenger client cache limits (defaults, stored overrides, merged effective)."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: read messenger client cache limits (defaults, stored overrides, merged effective).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_messenger_client_cache_get", "semantic_input_mode": "inherit_workflow", "summary": "Operator: read messenger client cache limits (defaults, stored overrides, merged effective).", "title": "Social Admin Messenger Client Cache Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: read messenger client cache limits (defaults, stored overrides, merged effective).", "write_mode": null}, {"action": "social.admin.messenger_client_cache_set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.messenger_client_cache_set", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Messenger Client Cache Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: replace data.ecosystem.messenger_client_cache on ecosystem project (media/IDB/OPFS caps)."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.messenger_client_cache_set", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Messenger Client Cache Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: replace data.ecosystem.messenger_client_cache on ecosystem project (media/IDB/OPFS caps)."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Operator: replace data.ecosystem.messenger_client_cache on ecosystem project (media/IDB/OPFS caps).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_admin_messenger_client_cache_set", "semantic_input_mode": "inherit_workflow", "summary": "Operator: replace data.ecosystem.messenger_client_cache on ecosystem project (media/IDB/OPFS caps).", "title": "Social Admin Messenger Client Cache Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: replace data.ecosystem.messenger_client_cache on ecosystem project (media/IDB/OPFS caps).", "write_mode": null}, {"action": "social.admin.public_index_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.public_index_status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Public Index Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: public index page or reconcile maps (set reconcile=true)."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.public_index_status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Public Index Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: public index page or reconcile maps (set reconcile=true)."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: public index page or reconcile maps (set reconcile=true).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_public_index_status", "semantic_input_mode": "inherit_workflow", "summary": "Operator: public index page or reconcile maps (set reconcile=true).", "title": "Social Admin Public Index Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: public index page or reconcile maps (set reconcile=true).", "write_mode": null}, {"action": "social.admin.dm_thread_meta", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.dm_thread_meta", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Dm Thread Meta", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: DM thread metadata (counts, participants) for support; audited."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.dm_thread_meta", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Dm Thread Meta", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: DM thread metadata (counts, participants) for support; audited."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: DM thread metadata (counts, participants) for support; audited.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_dm_thread_meta", "semantic_input_mode": "inherit_workflow", "summary": "Operator: DM thread metadata (counts, participants) for support; audited.", "title": "Social Admin Dm Thread Meta", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: DM thread metadata (counts, participants) for support; audited.", "write_mode": null}, {"action": "social.admin.graph_edges", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.graph_edges", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Graph Edges", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: list friend and blocked edges for a user (capped)."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.graph_edges", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Graph Edges", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: list friend and blocked edges for a user (capped)."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: list friend and blocked edges for a user (capped).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_graph_edges", "semantic_input_mode": "inherit_workflow", "summary": "Operator: list friend and blocked edges for a user (capped).", "title": "Social Admin Graph Edges", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: list friend and blocked edges for a user (capped).", "write_mode": null}, {"action": "social.admin.relay_hints", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.relay_hints", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Relay Hints", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: static hints for stream relay room naming and diagnostics paths."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.relay_hints", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Relay Hints", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: static hints for stream relay room naming and diagnostics paths."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: static hints for stream relay room naming and diagnostics paths.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_relay_hints", "semantic_input_mode": "inherit_workflow", "summary": "Operator: static hints for stream relay room naming and diagnostics paths.", "title": "Social Admin Relay Hints", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: static hints for stream relay room naming and diagnostics paths.", "write_mode": null}, {"action": "social.admin.force_delete_message", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.force_delete_message", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Force Delete Message", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: delete a chat message by id from DNA ring (ecosystem owner). Use dry_run first."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.force_delete_message", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Force Delete Message", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: delete a chat message by id from DNA ring (ecosystem owner). Use dry_run first."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Operator: delete a chat message by id from DNA ring (ecosystem owner). Use dry_run first.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "social_admin_force_delete_message", "semantic_input_mode": "inherit_workflow", "summary": "Operator: delete a chat message by id from DNA ring (ecosystem owner). Use dry_run first.", "title": "Social Admin Force Delete Message", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: delete a chat message by id from DNA ring (ecosystem owner). Use dry_run first.", "write_mode": null}, {"action": "social.admin.reset_messenger_prefs", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.reset_messenger_prefs", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Reset Messenger Prefs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: clear messenger_prefs for a user (reason required)."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.reset_messenger_prefs", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Reset Messenger Prefs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: clear messenger_prefs for a user (reason required)."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Operator: clear messenger_prefs for a user (reason required).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_admin_reset_messenger_prefs", "semantic_input_mode": "inherit_workflow", "summary": "Operator: clear messenger_prefs for a user (reason required).", "title": "Social Admin Reset Messenger Prefs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: clear messenger_prefs for a user (reason required).", "write_mode": null}, {"action": "social.admin.revoke_federation", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.revoke_federation", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Revoke Federation", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: remove a federation pointer from consumer to source channel."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.revoke_federation", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Revoke Federation", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: remove a federation pointer from consumer to source channel."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Operator: remove a federation pointer from consumer to source channel.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "social_admin_revoke_federation", "semantic_input_mode": "inherit_workflow", "summary": "Operator: remove a federation pointer from consumer to source channel.", "title": "Social Admin Revoke Federation", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: remove a federation pointer from consumer to source channel.", "write_mode": null}, {"action": "social.admin.force_close_channel", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.force_close_channel", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Force Close Channel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: delete channel metadata from project data_channels (ecosystem owner)."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.force_close_channel", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Force Close Channel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: delete channel metadata from project data_channels (ecosystem owner)."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Operator: delete channel metadata from project data_channels (ecosystem owner).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "social_admin_force_close_channel", "semantic_input_mode": "inherit_workflow", "summary": "Operator: delete channel metadata from project data_channels (ecosystem owner).", "title": "Social Admin Force Close Channel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: delete channel metadata from project data_channels (ecosystem owner).", "write_mode": null}, {"action": "social.chat.delta", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.delta", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Delta", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "delta_failed": "Retry once; verify channel_id and since_seq/since_hlc cursors", "forbidden": "social_read cap or channel membership denied", "invalid_parameters": "channel_id required — discover via social.chat.index_get", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown — social.channels.register or invites", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — delta requires signed-in reader_user_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Unified incremental delta for a messenger channel — one call returns new messages,"}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.delta", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Delta", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "delta_failed": "Retry once; verify channel_id and since_seq/since_hlc cursors", "forbidden": "social_read cap or channel membership denied", "invalid_parameters": "channel_id required — discover via social.chat.index_get", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown — social.channels.register or invites", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — delta requires signed-in reader_user_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Unified incremental delta for a messenger channel — one call returns new messages,"}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"delta_failed": "Retry once; verify channel_id and since_seq/since_hlc cursors", "forbidden": "social_read cap or channel membership denied", "invalid_parameters": "channel_id required — discover via social.chat.index_get", "not_found": "channel_id unknown — social.channels.register or invites", "unauthorized": "auth.get_profile — delta requires signed-in reader_user_id"}, "execution_class": "plain_read", "instruction_hint": "Unified incremental delta for a messenger channel — one call returns new messages,", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_chat_delta", "semantic_input_mode": "inherit_workflow", "summary": "Unified incremental delta for a messenger channel — one call returns new messages,", "title": "Social Chat Delta", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "delta_failed": "Retry once; verify channel_id and since_seq/since_hlc cursors", "forbidden": "social_read cap or channel membership denied", "invalid_parameters": "channel_id required — discover via social.chat.index_get", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown — social.channels.register or invites", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — delta requires signed-in reader_user_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Unified incremental delta for a messenger channel — one call returns new messages,", "write_mode": null}, {"action": "social.chat.crdt_update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.crdt_update", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Crdt Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply a Y.js CRDT update to a channel's shared document (bodies / pins / deletes)."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.crdt_update", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Crdt Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply a Y.js CRDT update to a channel's shared document (bodies / pins / deletes)."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Apply a Y.js CRDT update to a channel's shared document (bodies / pins / deletes).", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_chat_crdt_update", "semantic_input_mode": "inherit_workflow", "summary": "Apply a Y.js CRDT update to a channel's shared document (bodies / pins / deletes).", "title": "Social Chat Crdt Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply a Y.js CRDT update to a channel's shared document (bodies / pins / deletes).", "write_mode": null}, {"action": "social.chat.crdt_state", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.crdt_state", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Crdt State", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read the CRDT snapshot and update log for a channel."}, "capability_descriptor_slim": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.crdt_state", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Crdt State", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read the CRDT snapshot and update log for a channel."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read the CRDT snapshot and update log for a channel.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_chat_crdt_state", "semantic_input_mode": "inherit_workflow", "summary": "Read the CRDT snapshot and update log for a channel.", "title": "Social Chat Crdt State", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read the CRDT snapshot and update log for a channel.", "write_mode": null}, {"action": "social.support.history", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not use social.chat.history for support tickets — psup threads are social.support.*.", "Call social.support.eligibility before assuming support is enabled."], "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.history", "related_tools": ["social.support.send", "social.support.request_human", "social.chat.history"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support History", "when_blocked": {"channel_not_bound": "support channel not provisioned — social.support.config.patch or owner enables entry gates", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eligibility_denied": "social.support.eligibility — end_user_support_enabled false for project_id; use public lounge flag or enable private support", "forbidden": "project membership required — context.project_id bound to home project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read caller's psup thread (user plane) — pair with social.support.send."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.history", "related_tools": ["social.support.send", "social.support.request_human", "social.chat.history"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support History", "when_blocked": {"channel_not_bound": "support channel not provisioned — social.support.config.patch or owner enables entry gates", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eligibility_denied": "social.support.eligibility — end_user_support_enabled false for project_id; use public lounge flag or enable private support", "forbidden": "project membership required — context.project_id bound to home project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read caller's psup thread (user plane) — pair with social.support.send."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read caller's psup thread (user plane) — pair with social.support.send.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.send", "social.support.request_human", "social.chat.history"], "required_cap": "project_support", "requires_preflight": false, "risk_class": "read", "safe_action": "social_support_history", "semantic_input_mode": "inherit_workflow", "summary": "Read project support thread for the authenticated user (channel psup_p{pid}_u{uid}).", "support_atoms": {"SUPPORT_ELIGIBILITY_FIRST": "social.support.eligibility before history/send — end_user_support_enabled false returns eligibility_denied on user-plane reads.", "SUPPORT_NOT_CHAT": "Support threads are social.support.* — social.chat.history is messenger DMs, not psup tickets.", "SUPPORT_USER_VS_STAFF": "End users: social.support.history / social.support.send on psup_p{pid}_u{uid}. Staff desk: social.support.inbox / transition / assign — not social.chat.*."}, "title": "Social Support History", "when_blocked": {"channel_not_bound": "support channel not provisioned — social.support.config.patch or owner enables entry gates", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eligibility_denied": "social.support.eligibility — end_user_support_enabled false for project_id; use public lounge flag or enable private support", "forbidden": "project membership required — context.project_id bound to home project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read caller's psup thread (user plane) — pair with social.support.send.", "write_mode": null}, {"action": "social.support.send", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Staff reply needs channel_user_id + desk access — omit target for end-user self send.", "Do not duplicate messenger DM flows — support uses psup channel ids."], "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.send", "related_tools": ["social.support.history", "social.support.request_human"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Send", "when_blocked": {"channel_not_bound": "psup channel missing — enable support entry or social.support.config.patch ai binding", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eligibility_denied": "social.support.eligibility — private support disabled; check end_user_support_enabled", "forbidden": "auth.get_profile — cannot post without authenticated user", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "staff_only": "staff reply with channel_user_id requires support desk access — use user plane send without channel_user_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Post in psup thread: user message or staff reply when permitted."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.send", "related_tools": ["social.support.history", "social.support.request_human"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Send", "when_blocked": {"channel_not_bound": "psup channel missing — enable support entry or social.support.config.patch ai binding", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eligibility_denied": "social.support.eligibility — private support disabled; check end_user_support_enabled", "forbidden": "auth.get_profile — cannot post without authenticated user", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "staff_only": "staff reply with channel_user_id requires support desk access — use user plane send without channel_user_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Post in psup thread: user message or staff reply when permitted."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Post in psup thread: user message or staff reply when permitted.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.history", "social.support.request_human"], "required_cap": "project_support", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_support_send", "semantic_input_mode": "inherit_workflow", "summary": "Send a message in the user's support thread for a project (user) or staff reply when permitted.", "support_atoms": {"SUPPORT_ELIGIBILITY_FIRST": "social.support.eligibility before history/send — end_user_support_enabled false returns eligibility_denied on user-plane reads.", "SUPPORT_NOT_CHAT": "Support threads are social.support.* — social.chat.history is messenger DMs, not psup tickets."}, "title": "Social Support Send", "when_blocked": {"channel_not_bound": "psup channel missing — enable support entry or social.support.config.patch ai binding", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eligibility_denied": "social.support.eligibility — private support disabled; check end_user_support_enabled", "forbidden": "auth.get_profile — cannot post without authenticated user", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "staff_only": "staff reply with channel_user_id requires support desk access — use user plane send without channel_user_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Post in psup thread: user message or staff reply when permitted.", "write_mode": null}, {"action": "social.support.inbox", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not call inbox from user plane — staff membership required.", "User messages: social.support.send without channel_user_id."], "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.inbox", "related_tools": ["social.support.history", "social.support.transition", "social.support.assign"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Social Support Inbox", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project support desk access denied — not project owner/admin/support role", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "staff_only": "social.support.inbox requires support staff membership — resolve_support_access; user plane uses history/send", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Staff desk: list open support tickets for a project."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.inbox", "related_tools": ["social.support.history", "social.support.transition", "social.support.assign"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Social Support Inbox", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project support desk access denied — not project owner/admin/support role", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "staff_only": "social.support.inbox requires support staff membership — resolve_support_access; user plane uses history/send", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Staff desk: list open support tickets for a project."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Staff desk: list open support tickets for a project.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"items": {"description": "array", "items": {"type": "object"}, "type": "array"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.history", "social.support.transition", "social.support.assign"], "required_cap": "project_support", "requires_preflight": false, "risk_class": "read", "safe_action": "social_support_inbox", "semantic_input_mode": "inherit_workflow", "summary": "Staff inbox preview list for a project (requires support access).", "support_atoms": {"SUPPORT_USER_VS_STAFF": "End users: social.support.history / social.support.send on psup_p{pid}_u{uid}. Staff desk: social.support.inbox / transition / assign — not social.chat.*."}, "title": "Social Support Inbox", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project support desk access denied — not project owner/admin/support role", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "staff_only": "social.support.inbox requires support staff membership — resolve_support_access; user plane uses history/send", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Staff desk: list open support tickets for a project.", "write_mode": null}, {"action": "social.support.eligibility", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.eligibility", "related_tools": ["social.support.search_projects", "social.support.history"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Eligibility", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_ids must be a numeric array (max 80)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required before eligibility batch", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Batch: which home projects expose support lounge vs private psup."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.eligibility", "related_tools": ["social.support.search_projects", "social.support.history"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Eligibility", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_ids must be a numeric array (max 80)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required before eligibility batch", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Batch: which home projects expose support lounge vs private psup."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Batch: which home projects expose support lounge vs private psup.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.search_projects", "social.support.history"], "required_cap": "project_support", "requires_preflight": false, "risk_class": "read", "safe_action": "social_support_eligibility", "semantic_input_mode": "inherit_workflow", "summary": "Batch read: for home project ids the user can access, returns whether end-user private support and/or public Messenger support lounge are enabled (channel id psup_pub_p{pid} when public).", "support_atoms": {"SUPPORT_ELIGIBILITY_FIRST": "social.support.eligibility before history/send — end_user_support_enabled false returns eligibility_denied on user-plane reads.", "SUPPORT_USER_VS_STAFF": "End users: social.support.history / social.support.send on psup_p{pid}_u{uid}. Staff desk: social.support.inbox / transition / assign — not social.chat.*."}, "title": "Social Support Eligibility", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_ids must be a numeric array (max 80)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required before eligibility batch", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Batch: which home projects expose support lounge vs private psup.", "write_mode": null}, {"action": "social.support.search_projects", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.search_projects", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Search Projects", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "limit max 80 — omit q for recent contacts", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Find projects the user can contact for support by title query."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.search_projects", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Search Projects", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "limit max 80 — omit q for recent contacts", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Find projects the user can contact for support by title query."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Find projects the user can contact for support by title query.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_support_search_projects", "semantic_input_mode": "inherit_workflow", "summary": "Search projects the user may contact via support (titles ranked vs query). Returns support entry flags per row.", "support_atoms": {"SUPPORT_ELIGIBILITY_FIRST": "social.support.eligibility before history/send — end_user_support_enabled false returns eligibility_denied on user-plane reads.", "SUPPORT_USER_VS_STAFF": "End users: social.support.history / social.support.send on psup_p{pid}_u{uid}. Staff desk: social.support.inbox / transition / assign — not social.chat.*."}, "title": "Social Support Search Projects", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "limit max 80 — omit q for recent contacts", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Find projects the user can contact for support by title query.", "write_mode": null}, {"action": "social.support.transition", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.transition", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Transition", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "support desk access required on project_id", "invalid_status": "TicketStatus enum — same recovery as invalid_transition", "invalid_transition": "TicketStatus enum — open/pending/resolved/closed/reopened", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "staff_only": "staff desk only — social.support.inbox first; user plane cannot transition", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Staff: move ticket lifecycle status (open/pending/resolved)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.transition", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Transition", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "support desk access required on project_id", "invalid_status": "TicketStatus enum — same recovery as invalid_transition", "invalid_transition": "TicketStatus enum — open/pending/resolved/closed/reopened", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "staff_only": "staff desk only — social.support.inbox first; user plane cannot transition", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Staff: move ticket lifecycle status (open/pending/resolved)."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Staff: move ticket lifecycle status (open/pending/resolved).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "project_support", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_support_transition", "semantic_input_mode": "inherit_workflow", "summary": "Staff: transition a support ticket lifecycle status (requires support desk access).", "support_atoms": {"SUPPORT_USER_VS_STAFF": "End users: social.support.history / social.support.send on psup_p{pid}_u{uid}. Staff desk: social.support.inbox / transition / assign — not social.chat.*."}, "title": "Social Support Transition", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "support desk access required on project_id", "invalid_status": "TicketStatus enum — same recovery as invalid_transition", "invalid_transition": "TicketStatus enum — open/pending/resolved/closed/reopened", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "staff_only": "staff desk only — social.support.inbox first; user plane cannot transition", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Staff: move ticket lifecycle status (open/pending/resolved).", "write_mode": null}, {"action": "social.support.assign", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.assign", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Assign", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "support desk access required on project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "staff_only": "staff desk only — assignee_user_id must be support staff on project", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Staff: assign ticket to staff user id or unassign (null)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.assign", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Assign", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "support desk access required on project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "staff_only": "staff desk only — assignee_user_id must be support staff on project", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Staff: assign ticket to staff user id or unassign (null)."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Staff: assign ticket to staff user id or unassign (null).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "project_support", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_support_assign", "semantic_input_mode": "inherit_workflow", "summary": "Staff: assign a support ticket to a staff user id (or unassign with null).", "support_atoms": {"SUPPORT_USER_VS_STAFF": "End users: social.support.history / social.support.send on psup_p{pid}_u{uid}. Staff desk: social.support.inbox / transition / assign — not social.chat.*."}, "title": "Social Support Assign", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "support desk access required on project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "staff_only": "staff desk only — assignee_user_id must be support staff on project", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Staff: assign ticket to staff user id or unassign (null).", "write_mode": null}, {"action": "social.support.request_human", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.request_human", "related_tools": ["social.support.send", "social.support.history"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Request Human", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eligibility_denied": "private support disabled — social.support.eligibility first", "forbidden": "caller must own the psup thread for project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "End user: escalate AI/handoff to human staff on current ticket."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.request_human", "related_tools": ["social.support.send", "social.support.history"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Request Human", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eligibility_denied": "private support disabled — social.support.eligibility first", "forbidden": "caller must own the psup thread for project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "End user: escalate AI/handoff to human staff on current ticket."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "End user: escalate AI/handoff to human staff on current ticket.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.send", "social.support.history"], "required_cap": "project_support", "requires_preflight": false, "risk_class": "read", "safe_action": "social_support_request_human", "semantic_input_mode": "inherit_workflow", "summary": "End user: request a human handoff for the current ticket (pending when allowed).", "title": "Social Support Request Human", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eligibility_denied": "private support disabled — social.support.eligibility first", "forbidden": "caller must own the psup thread for project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "End user: escalate AI/handoff to human staff on current ticket.", "write_mode": null}, {"action": "social.support.config.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.social.support.gen1"], "id": "social.support.config.patch", "mutation_risk": "low", "related_tools": ["social.support.ai_binding_health", "agents.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Config Patch", "when_blocked": {"channel_not_bound": "ai_agent_uuid must reference a project-scoped agent — agents.get before patch; social.support.ai_binding_health after bind", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project owner or admin required — not end-user self-service", "invalid_parameters": "patch object required with partial support config keys", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bind one project agent as support AI. Do not also set chat triggers on that agent."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.social.support.gen1"], "id": "social.support.config.patch", "mutation_risk": "low", "related_tools": ["social.support.ai_binding_health", "agents.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Config Patch", "when_blocked": {"channel_not_bound": "ai_agent_uuid must reference a project-scoped agent — agents.get before patch; social.support.ai_binding_health after bind", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project owner or admin required — not end-user self-service", "invalid_parameters": "patch object required with partial support config keys", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bind one project agent as support AI. Do not also set chat triggers on that agent."}, "domain": "social", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Bind one project agent as support AI. Do not also set chat triggers on that agent.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.ai_binding_health", "agents.get"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_support_config_patch", "semantic_input_mode": "inherit_workflow", "summary": "Merge project support config (ai_agent_uuid, ai_mode, entry gates). Owner or admin.", "support_atoms": {"SUPPORT_AI_BINDING": "social.support.config.patch binds one project agent — confirm with social.support.ai_binding_health; channel_not_bound when ai_agent_uuid missing."}, "title": "Social Support Config Patch", "when_blocked": {"channel_not_bound": "ai_agent_uuid must reference a project-scoped agent — agents.get before patch; social.support.ai_binding_health after bind", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project owner or admin required — not end-user self-service", "invalid_parameters": "patch object required with partial support config keys", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bind one project agent as support AI. Do not also set chat triggers on that agent.", "write_mode": null}, {"action": "social.support.ai_binding_health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.social.support.gen1"], "id": "social.support.ai_binding_health", "related_tools": ["social.support.config.patch", "agents.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Ai Binding Health", "when_blocked": {"channel_not_bound": "no ai_agent_uuid in support config — social.support.config.patch with agents.list id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project read membership required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After social.support.config.patch, confirm the bound agent and mode."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.social.support.gen1"], "id": "social.support.ai_binding_health", "related_tools": ["social.support.config.patch", "agents.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Ai Binding Health", "when_blocked": {"channel_not_bound": "no ai_agent_uuid in support config — social.support.config.patch with agents.list id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project read membership required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After social.support.config.patch, confirm the bound agent and mode."}, "domain": "social", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "After social.support.config.patch, confirm the bound agent and mode.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.config.patch", "agents.get"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_support_ai_binding_health", "semantic_input_mode": "inherit_workflow", "summary": "Read support AI binding health (agent, mode, warnings).", "support_atoms": {"SUPPORT_AI_BINDING": "social.support.config.patch binds one project agent — confirm with social.support.ai_binding_health; channel_not_bound when ai_agent_uuid missing.", "SUPPORT_ELIGIBILITY_FIRST": "social.support.eligibility before history/send — end_user_support_enabled false returns eligibility_denied on user-plane reads."}, "title": "Social Support Ai Binding Health", "when_blocked": {"channel_not_bound": "no ai_agent_uuid in support config — social.support.config.patch with agents.list id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project read membership required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After social.support.config.patch, confirm the bound agent and mode.", "write_mode": null}, {"action": "stream.relay.list_rooms", "aliases": ["stream.relay.rooms.list", "stream_relay.list_rooms", "stream_relay.rooms.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "stream.relay.list_rooms", "related_tools": ["stream.relay.create_room", "stream.relay.ws_ticket"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stream Relay List Rooms", "visitor_callable": true, "when_blocked": {"execution_error": "Relay DNA read failed — retry once", "invalid_parameters": "project_id", "unauthorized": "auth.get_profile"}, "when_to_use": "Inventory relay DNA rooms — before create_room or ws_ticket."}, "capability_descriptor_slim": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "stream.relay.list_rooms", "related_tools": ["stream.relay.create_room", "stream.relay.ws_ticket"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stream Relay List Rooms", "visitor_callable": true, "when_blocked": {"execution_error": "Relay DNA read failed — retry once", "invalid_parameters": "project_id", "unauthorized": "auth.get_profile"}, "when_to_use": "Inventory relay DNA rooms — before create_room or ws_ticket."}, "do_not_use_when": "Not for qm: ephemeral rooms — use rooms.poll_events.", "domain": "stream", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"execution_error": "Relay or room runtime failed — retry once; for qm: rooms use poll fallback. → next: rooms.poll_events", "invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "unauthorized": "MCP context missing user_id — auth.get_profile or hosted session. → next: auth.get_profile"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Inventory relay DNA rooms — before create_room or ws_ticket.", "mutation_kind": "none", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["stream.relay.create_room", "stream.relay.ws_ticket"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "stream_relay_list_rooms", "semantic_input_mode": "inherit_workflow", "summary": "List stream relay rooms for the active project (same service as REST GET /api/stream-relay/rooms).", "title": "Stream Relay List Rooms", "when_blocked": {"execution_error": "Relay DNA read failed — retry once", "invalid_parameters": "project_id", "unauthorized": "auth.get_profile"}, "when_not_to_use": "Not for qm: ephemeral rooms — use rooms.poll_events.", "when_to_use": "Inventory relay DNA rooms — before create_room or ws_ticket.", "write_mode": null}, {"action": "stream.relay.ws_ticket", "aliases": ["relay.ws_ticket", "stream_relay.ws_ticket", "ws.ticket"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "stream.relay.ws_ticket", "related_tools": ["rooms.quick_match", "rooms.poll_events"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stream Relay Ws Ticket", "visitor_callable": true, "when_blocked": {"authority_is_stackscript": "script.room.tick — server tick owns the board; unwrap relay_envelope.body only", "execution_error": "rooms.poll_events", "hosted_app_required": "POST /api/hosted-apps/{pid}/session", "invalid_parameters": "project_id, user_id, room_id", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match", "message_too_large": "Relay frame exceeds room max_message_size — shrink the lockstep payload; do not retry the same blob. → next: stream.relay.ws_ticket", "not_a_participant": "rooms.quick_match first — ws_ticket requires QM seat", "rate_limit_exceeded": "Inbound relay rate window is full — back off; do not tight-loop broadcast. → next: rooms.poll_events", "room_not_joinable": "Use room_id from rooms.quick_match (qm:…)", "unauthorized": "auth.get_profile or hosted session", "ws_ticket_failed": "Retry ws_ticket; fallback poll"}, "when_to_use": "Mint short-lived JWT for wss …/stream-relay/ws/rooms/{room_id}?token= — never put API keys in the query."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "stream.relay.ws_ticket", "related_tools": ["rooms.quick_match", "rooms.poll_events"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stream Relay Ws Ticket", "visitor_callable": true, "when_blocked": {"authority_is_stackscript": "script.room.tick — server tick owns the board; unwrap relay_envelope.body only", "execution_error": "rooms.poll_events", "hosted_app_required": "POST /api/hosted-apps/{pid}/session", "invalid_parameters": "project_id, user_id, room_id", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match", "message_too_large": "Relay frame exceeds room max_message_size — shrink the lockstep payload; do not retry the same blob. → next: stream.relay.ws_ticket", "not_a_participant": "rooms.quick_match first — ws_ticket requires QM seat", "rate_limit_exceeded": "Inbound relay rate window is full — back off; do not tight-loop broadcast. → next: rooms.poll_events", "room_not_joinable": "Use room_id from rooms.quick_match (qm:…)", "unauthorized": "auth.get_profile or hosted session", "ws_ticket_failed": "Retry ws_ticket; fallback poll"}, "when_to_use": "Mint short-lived JWT for wss …/stream-relay/ws/rooms/{room_id}?token= — never put API keys in the query."}, "do_not_use_when": "Not before rooms.quick_match seats you (qm: room_id). Not for script-only coop without relay room.", "domain": "stream", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"authority_is_stackscript": "Server tick owns board DNA — clients read relay_envelope.body; use script.room.tick on authority, not client state_update. → next: script.room.tick", "execution_error": "Relay or room runtime failed — retry once; for qm: rooms use poll fallback. → next: rooms.poll_events", "hosted_app_required": "Player path: mint hosted session cookie, then rooms.* on /s/{pid}/mcp. → next: discovery.describe", "invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match", "message_too_large": "Relay frame exceeds room max_message_size — shrink the lockstep payload; do not retry the same blob. → next: stream.relay.ws_ticket", "not_a_participant": "Only seated players may poll or open ws_ticket — rooms.quick_match first. → next: rooms.quick_match", "rate_limit_exceeded": "Inbound relay rate window is full — back off; do not tight-loop broadcast. → next: rooms.poll_events", "room_not_joinable": "For quick match use room_id from rooms.quick_match (qm:… prefix). For persisted relay rooms use stream.relay.create_room first. → next: rooms.quick_match", "unauthorized": "MCP context missing user_id — auth.get_profile or hosted session. → next: auth.get_profile", "ws_ticket_failed": "JWT mint failed — retry rooms.quick_match then ws_ticket; fall back to rooms.poll_events. → next: rooms.poll_events"}, "examples": [{"action": "stream.relay.ws_ticket", "params": {"project_id": 2052, "room_id": "qm:wt-match:1v1:qm_a1b2c3d4e5f67890", "ttl_seconds": 60}}], "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Mint short-lived JWT for wss …/stream-relay/ws/rooms/{room_id}?token= — never put API keys in the q…", "mutation_kind": "none", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["rooms.quick_match", "rooms.poll_events"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "stream_relay_ws_ticket", "semantic_input_mode": "inherit_workflow", "summary": "Mint a short-lived JWT for wss://…/api/stream-relay/ws/rooms/{room_id}?token=… Do not put API keys in the WS query. Polling fallback: rooms.poll_events.", "title": "Stream Relay Ws Ticket", "when_blocked": {"authority_is_stackscript": "script.room.tick — server tick owns the board; unwrap relay_envelope.body only", "execution_error": "rooms.poll_events", "hosted_app_required": "POST /api/hosted-apps/{pid}/session", "invalid_parameters": "project_id, user_id, room_id", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match", "message_too_large": "Relay frame exceeds room max_message_size — shrink the lockstep payload; do not retry the same blob. → next: stream.relay.ws_ticket", "not_a_participant": "rooms.quick_match first — ws_ticket requires QM seat", "rate_limit_exceeded": "Inbound relay rate window is full — back off; do not tight-loop broadcast. → next: rooms.poll_events", "room_not_joinable": "Use room_id from rooms.quick_match (qm:…)", "unauthorized": "auth.get_profile or hosted session", "ws_ticket_failed": "Retry ws_ticket; fallback poll"}, "when_not_to_use": "Not before rooms.quick_match seats you (qm: room_id). Not for script-only coop without relay room.", "when_to_use": "Mint short-lived JWT for wss …/stream-relay/ws/rooms/{room_id}?token= — never put API keys in the query.", "write_mode": null}, {"action": "stream.relay.create_room", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.games.quick_match.gen1"], "id": "stream.relay.create_room", "related_tools": ["stream.relay.ws_ticket", "stream.relay.list_rooms"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stream Relay Create Room", "visitor_callable": false, "when_blocked": {"execution_error": "stream.relay.list_rooms", "invalid_parameters": "room_id + authenticated user", "room_create_failed": "Retry or stream.relay.list_rooms for collisions", "unauthorized": "auth.get_profile"}, "when_to_use": "Persist relay room for StackScript room.host — then stream.relay.ws_ticket."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.games.quick_match.gen1"], "id": "stream.relay.create_room", "related_tools": ["stream.relay.ws_ticket", "stream.relay.list_rooms"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stream Relay Create Room", "visitor_callable": false, "when_blocked": {"execution_error": "stream.relay.list_rooms", "invalid_parameters": "room_id + authenticated user", "room_create_failed": "Retry or stream.relay.list_rooms for collisions", "unauthorized": "auth.get_profile"}, "when_to_use": "Persist relay room for StackScript room.host — then stream.relay.ws_ticket."}, "do_not_use_when": "Not for quick_match netplay — rooms.quick_match creates qm: rooms.", "domain": "stream", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"execution_error": "Relay or room runtime failed — retry once; for qm: rooms use poll fallback. → next: rooms.poll_events", "invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "room_create_failed": "Could not allocate relay room — retry or lower concurrent matches. → next: rooms.quick_match", "unauthorized": "MCP context missing user_id — auth.get_profile or hosted session. → next: auth.get_profile"}, "execution_class": "cheap", "genetic_tags": ["core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Persist relay room for StackScript room.host — then stream.relay.ws_ticket.", "mutation_kind": "entity", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["stream.relay.ws_ticket", "stream.relay.list_rooms"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "stream_relay_create_room", "semantic_input_mode": "inherit_workflow", "summary": "Create a stream relay room (DNA ecosystem.stream_relay.rooms) for multiplayer hosts.", "title": "Stream Relay Create Room", "when_blocked": {"execution_error": "stream.relay.list_rooms", "invalid_parameters": "room_id + authenticated user", "room_create_failed": "Retry or stream.relay.list_rooms for collisions", "unauthorized": "auth.get_profile"}, "when_not_to_use": "Not for quick_match netplay — rooms.quick_match creates qm: rooms.", "when_to_use": "Persist relay room for StackScript room.host — then stream.relay.ws_ticket.", "write_mode": null}, {"action": "script.put", "aliases": ["script.create", "scripts.create", "scripts.put"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": true, "kind": "mutate", "mutates_when": {"validate_only": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "validate_only=true compile-only; default persists SSBC + DNA index", "effect_depends_on_params": true, "kind": "mutate", "mutates_when": {"validate_only": false}}, "execution_class": "heavy", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.put", "mutates_when": {"validate_only": false}, "mutation_risk": "high", "related_tools": ["script.test", "script.dry_run", "script.versions"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Put", "when_blocked": {"SS1202": "P1 has no throw — return { ok: false } for a room error. Allowed: int expr, a+b, tick+1, return input, return { ok: true|false }. script.docs topic=syntax", "SS1210": "dna.read export missing read_paths — add read_paths: ['leaf.path']; or script.put validate_only + recompile_version for stale SSBC object returns", "SS9001": "script_version_conflict — refresh base_version", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "batch_semantic_anchor_required": "Persistent script.put in execute: options.execution_intent=direct or options.goal; validate_only=true compile-only batches exempt", "budget_exceeded": "Fabric execute budget saturated — honor retry_after_ms or split validate_only batches", "cap_not_implemented": "ctx.dna.cas is fail-closed at compile; events.emit needs a quoted string channel. http/notify/secrets stay unimplemented — script.docs topic=host", "caps_approval_required": "approve_caps=true on script.put or script.publish", "compile_error": "Compiler rejected body — see diagnostics[] and message_en", "compile_failed": "See diagnostics[] from compiler", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S — shrink sources or split script.put batches", "ctx_dna_write_without_cap": "Declare wallet/dna caps on export before ctx.dna.write", "ctx_not_declared": "Declare ctx in export signature before ctx.dna.read or ctx.dna.write (defineFn requires explicit ctx)", "dna_read_without_read_paths": "Add read_paths: ['leaf.path'] on dna.read export (SS1210)", "dna_write_path_not_constant": "One $segment is the room id: ctx.dna.write(['rooms', $room_id, 'state'], n) and write_paths: ['rooms.$room_id.state']. '{room_id}' and template strings are rejected.", "dna_write_without_write_paths": "Add write_paths: ['leaf.path'] on dna.write export before ctx.dna.write (SS1210)", "duplicate_export_name": "Two exports share the same name in one put batch", "entry_path_required": "Multi-file put requires entry: 'main.ts' (S-11)", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "export_body_stubbed_p1": "Use return int, a±b, tick+1, or { ok: true }; not host logic in body", "export_define_incomplete": "Object define* missing async body or run() — fix formatting/comments between }, and async", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before put", "invalid_parameters": "files[] required with path/content", "no_exports_found": "Entry file must export defineCommand/defineView/defineFn/defineRoom — script.docs topic=syntax; multi-file entry must be the file that contains define*", "no_exports_in_entry_scope": "Exports live in a sibling file — set entry to that path (e.g. room.ts) or move defineRoom/defineFn into the entry file; import alone does not publish exports", "partial_export_compile": "Fix all SS1210/SS1202 in batch — compile is fail-closed", "payload_too_large": "Split files[] or upload to storage first — max ~8MB per script.put batch", "preflight_blocked": "preflight.check action=script.publish before put publish=live", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "rate_limit_exceeded": "Throttle script.put — honor retry_after_ms from response", "script_put_failed": "Unexpected put failure — inspect data.diagnostics", "script_version_conflict": "Pass base_version from script.versions aliases.latest_version", "server_busy": "StackScript compile lane busy — retry after retry_after_ms", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "shared_module_needs_main_export_in_same_put": "Include main.ts with defineFn/defineCommand in the same script.put files[] batch as thermo-shared.ts (use shared alone is not a script)", "source_pathological": "Source line count, line length, or comment-padding probe (SS1098) — max 25k lines/file, 8KiB/line; split or trim before script.put", "ssbc_blob_unreadable": "SSBC artifact missing or corrupt in storage — re script.put", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "storage_upload_failed": "Storage plane rejected sources manifest — check storage.get_quota"}, "when_to_use": "Compile TypeScript (.ts) sources to SSBC — files[].content is TS, not JSON. validate_only=true: compile receipt only (no DNA version). Persistent put in a multi-step MCP batch: set options.execution_i"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": true, "kind": "mutate", "mutates_when": {"validate_only": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "validate_only=true compile-only; default persists SSBC + DNA index", "effect_depends_on_params": true, "kind": "mutate", "mutates_when": {"validate_only": false}}, "execution_class": "heavy", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.put", "mutates_when": {"validate_only": false}, "mutation_risk": "high", "related_tools": ["script.test", "script.dry_run", "script.versions"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Put", "when_blocked": {"SS1202": "P1 has no throw — return { ok: false } for a room error. Allowed: int expr, a+b, tick+1, return input, return { ok: true|false }. script.docs topic=syntax", "SS1210": "dna.read export missing read_paths — add read_paths: ['leaf.path']; or script.put validate_only + recompile_version for stale SSBC object returns", "SS9001": "script_version_conflict — refresh base_version", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "batch_semantic_anchor_required": "Persistent script.put in execute: options.execution_intent=direct or options.goal; validate_only=true compile-only batches exempt", "budget_exceeded": "Fabric execute budget saturated — honor retry_after_ms or split validate_only batches", "cap_not_implemented": "ctx.dna.cas is fail-closed at compile; events.emit needs a quoted string channel. http/notify/secrets stay unimplemented — script.docs topic=host", "caps_approval_required": "approve_caps=true on script.put or script.publish", "compile_error": "Compiler rejected body — see diagnostics[] and message_en", "compile_failed": "See diagnostics[] from compiler", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S — shrink sources or split script.put batches", "ctx_dna_write_without_cap": "Declare wallet/dna caps on export before ctx.dna.write", "ctx_not_declared": "Declare ctx in export signature before ctx.dna.read or ctx.dna.write (defineFn requires explicit ctx)", "dna_read_without_read_paths": "Add read_paths: ['leaf.path'] on dna.read export (SS1210)", "dna_write_path_not_constant": "One $segment is the room id: ctx.dna.write(['rooms', $room_id, 'state'], n) and write_paths: ['rooms.$room_id.state']. '{room_id}' and template strings are rejected.", "dna_write_without_write_paths": "Add write_paths: ['leaf.path'] on dna.write export before ctx.dna.write (SS1210)", "duplicate_export_name": "Two exports share the same name in one put batch", "entry_path_required": "Multi-file put requires entry: 'main.ts' (S-11)", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "export_body_stubbed_p1": "Use return int, a±b, tick+1, or { ok: true }; not host logic in body", "export_define_incomplete": "Object define* missing async body or run() — fix formatting/comments between }, and async", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before put", "invalid_parameters": "files[] required with path/content", "no_exports_found": "Entry file must export defineCommand/defineView/defineFn/defineRoom — script.docs topic=syntax; multi-file entry must be the file that contains define*", "no_exports_in_entry_scope": "Exports live in a sibling file — set entry to that path (e.g. room.ts) or move defineRoom/defineFn into the entry file; import alone does not publish exports", "partial_export_compile": "Fix all SS1210/SS1202 in batch — compile is fail-closed", "payload_too_large": "Split files[] or upload to storage first — max ~8MB per script.put batch", "preflight_blocked": "preflight.check action=script.publish before put publish=live", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "rate_limit_exceeded": "Throttle script.put — honor retry_after_ms from response", "script_put_failed": "Unexpected put failure — inspect data.diagnostics", "script_version_conflict": "Pass base_version from script.versions aliases.latest_version", "server_busy": "StackScript compile lane busy — retry after retry_after_ms", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "shared_module_needs_main_export_in_same_put": "Include main.ts with defineFn/defineCommand in the same script.put files[] batch as thermo-shared.ts (use shared alone is not a script)", "source_pathological": "Source line count, line length, or comment-padding probe (SS1098) — max 25k lines/file, 8KiB/line; split or trim before script.put", "ssbc_blob_unreadable": "SSBC artifact missing or corrupt in storage — re script.put", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "storage_upload_failed": "Storage plane rejected sources manifest — check storage.get_quota"}, "when_to_use": "Compile TypeScript (.ts) sources to SSBC — files[].content is TS, not JSON. validate_only=true: compile receipt only (no DNA version). Persistent put in a multi-step MCP batch: set options.execution_i"}, "do_not_use_when": "Not for executing exports — use script.test / script.dry_run after compile. validate_only=true does not persist; full put needs batch execution_intent when required.", "domain": "script", "effect": {"audit_batch_param_sensitive": true, "conditional_mutate": "validate_only=true compile-only; default persists SSBC + DNA index", "effect_depends_on_params": true, "execution_class": "heavy", "generation": true, "kind": "mutate", "mutates_when": {"validate_only": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "validate_only=true compile-only; default persists SSBC + DNA index", "effect_depends_on_params": true, "kind": "mutate", "mutates_when": {"validate_only": false}}, "errors": {"SS1202": "P1 has no throw — return { ok: false } for a room error. Allowed: int expr, a+b, tick+1, return input, return { ok: true|false }. script.docs topic=syntax", "SS1210": "dna.read export missing read_paths — add read_paths: ['leaf.path']; or script.put validate_only + recompile_version for stale SSBC object returns", "SS9001": "script_version_conflict — refresh base_version", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "batch_semantic_anchor_required": "Persistent script.put in execute: options.execution_intent=direct or options.goal; validate_only=true compile-only batches exempt", "budget_exceeded": "Fabric execute budget saturated — honor retry_after_ms or split validate_only batches", "cap_not_implemented": "ctx.dna.cas is fail-closed at compile; events.emit needs a quoted string channel. http/notify/secrets stay unimplemented — script.docs topic=host", "caps_approval_required": "approve_caps=true on script.put or script.publish", "compile_error": "Compiler rejected body — see diagnostics[] and message_en", "compile_failed": "See diagnostics[] from compiler", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S — shrink sources or split script.put batches", "ctx_dna_write_without_cap": "Declare wallet/dna caps on export before ctx.dna.write", "ctx_not_declared": "Declare ctx in export signature before ctx.dna.read or ctx.dna.write (defineFn requires explicit ctx)", "dna_read_without_read_paths": "Add read_paths: ['leaf.path'] on dna.read export (SS1210)", "dna_write_path_not_constant": "One $segment is the room id: ctx.dna.write(['rooms', $room_id, 'state'], n) and write_paths: ['rooms.$room_id.state']. '{room_id}' and template strings are rejected.", "dna_write_without_write_paths": "Add write_paths: ['leaf.path'] on dna.write export before ctx.dna.write (SS1210)", "duplicate_export_name": "Two exports share the same name in one put batch", "entry_path_required": "Multi-file put requires entry: 'main.ts' (S-11)", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "export_body_stubbed_p1": "Use return int, a±b, tick+1, or { ok: true }; not host logic in body", "export_define_incomplete": "Object define* missing async body or run() — fix formatting/comments between }, and async", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before put", "invalid_parameters": "files[] required with path/content", "no_exports_found": "Entry file must export defineCommand/defineView/defineFn/defineRoom — script.docs topic=syntax; multi-file entry must be the file that contains define*", "no_exports_in_entry_scope": "Exports live in a sibling file — set entry to that path (e.g. room.ts) or move defineRoom/defineFn into the entry file; import alone does not publish exports", "partial_export_compile": "Fix all SS1210/SS1202 in batch — compile is fail-closed", "payload_too_large": "Split files[] or upload to storage first — max ~8MB per script.put batch", "preflight_blocked": "preflight.check action=script.publish before put publish=live", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "rate_limit_exceeded": "Throttle script.put — honor retry_after_ms from response", "script_put_failed": "Unexpected put failure — inspect data.diagnostics", "script_version_conflict": "Pass base_version from script.versions aliases.latest_version", "server_busy": "StackScript compile lane busy — retry after retry_after_ms", "shared_module_needs_main_export_in_same_put": "Include main.ts with defineFn/defineCommand in the same script.put files[] batch as thermo-shared.ts (use shared alone is not a script)", "source_pathological": "Source line count, line length, or comment-padding probe (SS1098) — max 25k lines/file, 8KiB/line; split or trim before script.put", "ssbc_blob_unreadable": "SSBC artifact missing or corrupt in storage — re script.put", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "storage_upload_failed": "Storage plane rejected sources manifest — check storage.get_quota"}, "examples": [{"name": "Validate-only compile (no DNA write)", "request": {"params": {"files": [{"content": "export const tick = defineCommand({ name: \"tick\", caps: [], run() { return 1; } });", "path": "main.ts"}], "script_id": "demo-counter", "validate_only": true}, "tool": "script.put"}, "response": {"data": {"export_names": ["tick"], "ok": true}, "success": true}}], "execution_class": "heavy", "instruction_hint": "Compile TypeScript (.ts) sources to SSBC — files[].content is TS, not JSON. validate_only=true: com…", "language": "typescript", "lifecycle_checklist": "ABI: {} vs [] vs omitted for zero-arg exports — same in script.test and script.dry_run. Batch mutat…", "mcp_batch_hint": "MCP execute budget: whole batch ~60s — split large script.put (max ~8MB files) into validate_only first batch, then test/dry_run; compile concurrency defaults to 4. Hosted Nahual: batch success steps hoist script.run observability on the step root (timings, dna_persisted, runtime_neural_staged) — read step.timings, not only step.result.", "mutation_kind": "entity", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"base_version_for_next_put": {"description": "Pass as base_version on the next script.put for optimistic lock", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "code_hash": {"description": "SSBC content hash (blake3)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "compile": {"description": "Compiler diagnostics and bytecode metadata (alias: diagnostics)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "cost": {"description": "Fuel / USD estimate block from compile", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "diagnostics": {"description": "Compiler diagnostics (SS1202 stub warnings, SS9001 conflicts, cap_not_implemented e.g. ctx.dna.cas fail-closed)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "error": {"description": "Machine error code when ok is false", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "export_names": {"description": "Export names for script.dry_run / logic template field export_name", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "exports": {"description": "Export metadata list from compile output", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "instruction_slice": {"description": "Optional operator hints from enrich_stackscript_instruction_slice", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "language": {"description": "Always typescript for script.put sources (TS subset, not JSON logic)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "next_actions": {"description": "Suggested MCP ladder steps after successful put", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "ok": {"description": "True when the service operation completed successfully", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "persisted": {"description": "False when validate_only compile — no DNA version written", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "script_id": {"description": "StackScript identifier in project scope", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "source_file_extension": {"description": "Use .ts paths in files[] (e.g. main.ts)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "suggested_read_paths": {"description": "Per-export dot paths inferred from dna.read([...]) when SS1210 — copy into read_paths on the export", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "validate_only": {"description": "When true, compile-only receipt (see persisted)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "version": {"description": "Newly stored version number after compile", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "preflight_action": "preflight.check", "related_tools": ["script.test", "script.dry_run", "script.versions"], "required_cap": "stackscript_write", "requires_preflight": true, "risk_class": "low_write", "rollback": ["script.delete"], "safe_action": "script_put", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Compile and store StackScript sources (TypeScript .ts subset → SSBC). files[]: {path, content} with TS source — not JSON logic rules. validate_only=true: compile receipt only (no DNA version). Persist", "title": "Script Put", "verification": ["script.get"], "verify": [{"action": "script.get", "predicate": "named resource is visible"}], "when_blocked": {"SS1202": "P1 has no throw — return { ok: false } for a room error. Allowed: int expr, a+b, tick+1, return input, return { ok: true|false }. script.docs topic=syntax", "SS1210": "dna.read export missing read_paths — add read_paths: ['leaf.path']; or script.put validate_only + recompile_version for stale SSBC object returns", "SS9001": "script_version_conflict — refresh base_version", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "batch_semantic_anchor_required": "Persistent script.put in execute: options.execution_intent=direct or options.goal; validate_only=true compile-only batches exempt", "budget_exceeded": "Fabric execute budget saturated — honor retry_after_ms or split validate_only batches", "cap_not_implemented": "ctx.dna.cas is fail-closed at compile; events.emit needs a quoted string channel. http/notify/secrets stay unimplemented — script.docs topic=host", "caps_approval_required": "approve_caps=true on script.put or script.publish", "compile_error": "Compiler rejected body — see diagnostics[] and message_en", "compile_failed": "See diagnostics[] from compiler", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S — shrink sources or split script.put batches", "ctx_dna_write_without_cap": "Declare wallet/dna caps on export before ctx.dna.write", "ctx_not_declared": "Declare ctx in export signature before ctx.dna.read or ctx.dna.write (defineFn requires explicit ctx)", "dna_read_without_read_paths": "Add read_paths: ['leaf.path'] on dna.read export (SS1210)", "dna_write_path_not_constant": "One $segment is the room id: ctx.dna.write(['rooms', $room_id, 'state'], n) and write_paths: ['rooms.$room_id.state']. '{room_id}' and template strings are rejected.", "dna_write_without_write_paths": "Add write_paths: ['leaf.path'] on dna.write export before ctx.dna.write (SS1210)", "duplicate_export_name": "Two exports share the same name in one put batch", "entry_path_required": "Multi-file put requires entry: 'main.ts' (S-11)", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "export_body_stubbed_p1": "Use return int, a±b, tick+1, or { ok: true }; not host logic in body", "export_define_incomplete": "Object define* missing async body or run() — fix formatting/comments between }, and async", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before put", "invalid_parameters": "files[] required with path/content", "no_exports_found": "Entry file must export defineCommand/defineView/defineFn/defineRoom — script.docs topic=syntax; multi-file entry must be the file that contains define*", "no_exports_in_entry_scope": "Exports live in a sibling file — set entry to that path (e.g. room.ts) or move defineRoom/defineFn into the entry file; import alone does not publish exports", "partial_export_compile": "Fix all SS1210/SS1202 in batch — compile is fail-closed", "payload_too_large": "Split files[] or upload to storage first — max ~8MB per script.put batch", "preflight_blocked": "preflight.check action=script.publish before put publish=live", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "rate_limit_exceeded": "Throttle script.put — honor retry_after_ms from response", "script_put_failed": "Unexpected put failure — inspect data.diagnostics", "script_version_conflict": "Pass base_version from script.versions aliases.latest_version", "server_busy": "StackScript compile lane busy — retry after retry_after_ms", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "shared_module_needs_main_export_in_same_put": "Include main.ts with defineFn/defineCommand in the same script.put files[] batch as thermo-shared.ts (use shared alone is not a script)", "source_pathological": "Source line count, line length, or comment-padding probe (SS1098) — max 25k lines/file, 8KiB/line; split or trim before script.put", "ssbc_blob_unreadable": "SSBC artifact missing or corrupt in storage — re script.put", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "storage_upload_failed": "Storage plane rejected sources manifest — check storage.get_quota"}, "when_not_to_use": "Not for executing exports — use script.test / script.dry_run after compile. validate_only=true does not persist; full put needs batch execution_intent when required.", "when_to_use": "Compile TypeScript (.ts) sources to SSBC — files[].content is TS, not JSON. validate_only=true: compile receipt only (no DNA version). Persistent put in a multi-step MCP batch: set options.execution_i", "workflow_ladder": ["script.docs?topic=syntax — TypeScript export shapes before script.put", "script.put validate_only=true — compile receipt only (persisted=false)", "script.put persist — version + code_hash from receipt", "script.test (version=latest) on the same script_id — before publish", "script.dry_run with export + input — inspect write_set and cost.fuel", "preflight.check action=script.publish — caps / approval preview", "script.publish alias live after caps approval if caps_diff.requires_approval", "script.run on prod only after generation.promote when using sandbox", "logic.attach_template tpl_stackscript_trigger_shell (field_values from put receipt)", "logic.dry_run — verify nested_stackscript trace on script_processor steps"], "write_mode": null}, {"action": "script.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.get", "mutation_risk": "low", "related_tools": ["script.versions", "script.put", "script.test"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Get", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "content_missing": "SSBC blob unreadable — script.put recompile or pick another version alias", "not_found": "Unknown script_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "version_not_found": "script.versions — pick live|staging|numeric"}, "when_to_use": "Default version=latest (compiled slice); use live after script.publish. Pass include_sources=true to hydrate meta.sources; files[] always returned. generation_env_uuid scopes sandbox reads."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.get", "mutation_risk": "low", "related_tools": ["script.versions", "script.put", "script.test"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Get", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "content_missing": "SSBC blob unreadable — script.put recompile or pick another version alias", "not_found": "Unknown script_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "version_not_found": "script.versions — pick live|staging|numeric"}, "when_to_use": "Default version=latest (compiled slice); use live after script.publish. Pass include_sources=true to hydrate meta.sources; files[] always returned. generation_env_uuid scopes sandbox reads."}, "do_not_use_when": "Not for executing exports — script.test / script.dry_run / script.run. Not a substitute for script.studio_bundle when you need versions ladder in one hop.", "domain": "script", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Reads resolve against generation_env_uuid when set in MCP context (sandbox anchor); otherwise production project slice", "effect_depends_on_params": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "content_missing": "SSBC blob unreadable — script.put recompile or pick another version alias", "not_found": "Unknown script_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "version_not_found": "script.versions — pick live|staging|numeric"}, "execution_class": "plain_read", "instruction_hint": "Default version=latest (compiled slice); use live after script.publish. Pass include_sources=true t…", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.versions", "script.put", "script.test"], "required_cap": "stackscript_read", "requires_preflight": false, "risk_class": "read", "runtime_vars_hint": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "safe_action": "script_get", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Get script metadata and version info.", "title": "Script Get", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "content_missing": "SSBC blob unreadable — script.put recompile or pick another version alias", "not_found": "Unknown script_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "version_not_found": "script.versions — pick live|staging|numeric"}, "when_not_to_use": "Not for executing exports — script.test / script.dry_run / script.run. Not a substitute for script.studio_bundle when you need versions ladder in one hop.", "when_to_use": "Default version=latest (compiled slice); use live after script.publish. Pass include_sources=true to hydrate meta.sources; files[] always returned. generation_env_uuid scopes sandbox reads.", "workflow_ladder": ["script.docs?topic=syntax — TypeScript export shapes before script.put", "script.put validate_only=true — compile receipt only (persisted=false)", "script.put persist — version + code_hash from receipt", "script.test (version=latest) on the same script_id — before publish", "script.dry_run with export + input — inspect write_set and cost.fuel", "preflight.check action=script.publish — caps / approval preview", "script.publish alias live after caps approval if caps_diff.requires_approval", "script.run on prod only after generation.promote when using sandbox", "logic.attach_template tpl_stackscript_trigger_shell (field_values from put receipt)", "logic.dry_run — verify nested_stackscript trace on script_processor steps"], "write_mode": null}, {"action": "script.studio_bundle", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.studio_bundle", "mutation_risk": "low", "related_tools": ["script.get", "script.versions", "script.put"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Studio Bundle", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "invalid_parameters": "max_versions must be integer 1–100 when set", "not_found": "Unknown script_id — script.put or script.list", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "version_not_found": "Resolved version missing from versions tree"}, "when_to_use": "Studio shell read model — script.get (include_sources) + script.versions in one MCP round-trip. Prefer over separate get+versions when opening Script Studio."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.studio_bundle", "mutation_risk": "low", "related_tools": ["script.get", "script.versions", "script.put"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Studio Bundle", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "invalid_parameters": "max_versions must be integer 1–100 when set", "not_found": "Unknown script_id — script.put or script.list", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "version_not_found": "Resolved version missing from versions tree"}, "when_to_use": "Studio shell read model — script.get (include_sources) + script.versions in one MCP round-trip. Prefer over separate get+versions when opening Script Studio."}, "do_not_use_when": "Not for headless automation — use script.get or script.list for one concern. Avoid include_sources=true on large trees; Studio sets it explicitly. Not a substitute for script.profile or script.dry_run.", "domain": "script", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "invalid_parameters": "max_versions must be integer 1–100 when set", "not_found": "Unknown script_id — script.put or script.list", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "version_not_found": "Resolved version missing from versions tree"}, "execution_class": "plain_read", "instruction_hint": "Studio shell read model — script.get (include_sources) + script.versions in one MCP round-trip. Pre…", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.get", "script.versions", "script.put"], "required_cap": "stackscript_read", "requires_preflight": false, "risk_class": "read", "safe_action": "script_studio_bundle", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Studio read model: detail files + version ladder in one call.", "title": "Script Studio Bundle", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "invalid_parameters": "max_versions must be integer 1–100 when set", "not_found": "Unknown script_id — script.put or script.list", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "version_not_found": "Resolved version missing from versions tree"}, "when_not_to_use": "Not for headless automation — use script.get or script.list for one concern. Avoid include_sources=true on large trees; Studio sets it explicitly. Not a substitute for script.profile or script.dry_run.", "when_to_use": "Studio shell read model — script.get (include_sources) + script.versions in one MCP round-trip. Prefer over separate get+versions when opening Script Studio.", "write_mode": null}, {"action": "script.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.list", "mutation_risk": "low", "related_tools": ["script.get", "script.put"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script List", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id"}, "when_to_use": "Index map — scoped to generation_env_uuid when set (else production slice)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.list", "mutation_risk": "low", "related_tools": ["script.get", "script.put"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script List", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id"}, "when_to_use": "Index map — scoped to generation_env_uuid when set (else production slice)."}, "do_not_use_when": "Not for per-export bytecode or sources — script.get or script.studio_bundle. Does not run scripts.", "domain": "script", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Reads resolve against generation_env_uuid when set in MCP context (sandbox anchor); otherwise production project slice", "effect_depends_on_params": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id"}, "execution_class": "plain_read", "instruction_hint": "Index map — scoped to generation_env_uuid when set (else production slice).", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.get", "script.put"], "required_cap": "stackscript_read", "requires_preflight": false, "risk_class": "read", "safe_action": "script_list", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "List scripts in project.", "title": "Script List", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id"}, "when_not_to_use": "Not for per-export bytecode or sources — script.get or script.studio_bundle. Does not run scripts.", "when_to_use": "Index map — scoped to generation_env_uuid when set (else production slice).", "write_mode": null}, {"action": "script.test", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.test", "mutation_risk": "low", "related_tools": ["script.put", "script.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Test", "when_blocked": {"SS1202": "P1 has no throw — return { ok: false } for a room error. Allowed: int expr, a+b, tick+1, return input, return { ok: true|false }. script.docs topic=syntax", "SS1401": "dna.write path not in write_paths — fix export meta or script.put", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Retry once (heal from meta.sources) or script.put", "cap_not_implemented": "P1 VM — dna.*, events.emit (host allowlist), wallet via stackscript.wallet.replay; not http/notify/secrets — script.docs topic=host", "compile_failed": "Ephemeral files[] did not compile — see diagnostics", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S", "db_unavailable": "Retry script.test after retry_after_ms", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field on test_input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_write_path_denied": "Same as SS1401", "entry_path_required": "Multi-file files[] needs entry", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "expect_value_mismatch": "VM value differed from expect_value — fix script or input", "export_body_stubbed_p1": "Re script.put with supported return forms", "export_not_found": "Use export_names from script.put receipt", "input_alias_conflict": "test_input and input both set but differ — pass only one ABI payload", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass test_input / input — export requires parameters", "input_requires_integer_slots": "Numeric input slots only in P1 VM", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish or put with publish=live", "payload_too_large": "files[] exceeds the same byte cap as script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "run_timeout": "VM exceeded run timeout — simplify export", "script_id_or_files_required": "Pass script_id or ephemeral files[] with path/content and optional entry", "script_not_found": "script.put first", "script_test_failed": "Smoke test failed", "source_pathological": "Trim pathological sources (SS1098) before script.test", "stackscript_fuel_quota_exceeded": "Upgrade plan or script.profile", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "test_input_required": "Pass test_input matching export input_fields", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions", "vm_division_by_zero": "Guard divisor in script body before divide/mod", "vm_fuel_exhausted": "Export exceeded per-run fuel limit — simplify body or raise cap", "vm_int_overflow": "int53 overflow — narrow arithmetic in export body", "wallet_user_required": "MCP session user_id required — omit params.user_id", "workflow_scope_leak": "params.user_id must match session user_id"}, "when_to_use": "Sandbox smoke on latest_version after script.put (version=latest default; use version=live only after script.publish). expect_value compares wire data.value (scalar or {value:…}); explicit null is ass"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.test", "mutation_risk": "low", "related_tools": ["script.put", "script.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Test", "when_blocked": {"SS1202": "P1 has no throw — return { ok: false } for a room error. Allowed: int expr, a+b, tick+1, return input, return { ok: true|false }. script.docs topic=syntax", "SS1401": "dna.write path not in write_paths — fix export meta or script.put", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Retry once (heal from meta.sources) or script.put", "cap_not_implemented": "P1 VM — dna.*, events.emit (host allowlist), wallet via stackscript.wallet.replay; not http/notify/secrets — script.docs topic=host", "compile_failed": "Ephemeral files[] did not compile — see diagnostics", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S", "db_unavailable": "Retry script.test after retry_after_ms", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field on test_input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_write_path_denied": "Same as SS1401", "entry_path_required": "Multi-file files[] needs entry", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "expect_value_mismatch": "VM value differed from expect_value — fix script or input", "export_body_stubbed_p1": "Re script.put with supported return forms", "export_not_found": "Use export_names from script.put receipt", "input_alias_conflict": "test_input and input both set but differ — pass only one ABI payload", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass test_input / input — export requires parameters", "input_requires_integer_slots": "Numeric input slots only in P1 VM", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish or put with publish=live", "payload_too_large": "files[] exceeds the same byte cap as script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "run_timeout": "VM exceeded run timeout — simplify export", "script_id_or_files_required": "Pass script_id or ephemeral files[] with path/content and optional entry", "script_not_found": "script.put first", "script_test_failed": "Smoke test failed", "source_pathological": "Trim pathological sources (SS1098) before script.test", "stackscript_fuel_quota_exceeded": "Upgrade plan or script.profile", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "test_input_required": "Pass test_input matching export input_fields", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions", "vm_division_by_zero": "Guard divisor in script body before divide/mod", "vm_fuel_exhausted": "Export exceeded per-run fuel limit — simplify body or raise cap", "vm_int_overflow": "int53 overflow — narrow arithmetic in export body", "wallet_user_required": "MCP session user_id required — omit params.user_id", "workflow_scope_leak": "params.user_id must match session user_id"}, "when_to_use": "Sandbox smoke on latest_version after script.put (version=latest default; use version=live only after script.publish). expect_value compares wire data.value (scalar or {value:…}); explicit null is ass"}, "do_not_use_when": "Not for production DNA commit or wallet settlement — use script.run after promote. Does not heal stale SSBC (unlike script.run); use script.recompile_version. dna.read needs read_paths prefetch — cache miss fails in dry_run VM.", "domain": "script", "effect": {"audit_batch_allowed": true, "conditional_mutate": "VM smoke via dry_run — no persist on validate path; generation_env_uuid scopes sandbox reads like script.dry_run", "effect_depends_on_params": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"SS1202": "P1 has no throw — return { ok: false } for a room error. Allowed: int expr, a+b, tick+1, return input, return { ok: true|false }. script.docs topic=syntax", "SS1401": "dna.write path not in write_paths — fix export meta or script.put", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Retry once (heal from meta.sources) or script.put", "cap_not_implemented": "P1 VM — dna.*, events.emit (host allowlist), wallet via stackscript.wallet.replay; not http/notify/secrets — script.docs topic=host", "compile_failed": "Ephemeral files[] did not compile — see diagnostics", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S", "db_unavailable": "Retry script.test after retry_after_ms", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field on test_input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_write_path_denied": "Same as SS1401", "entry_path_required": "Multi-file files[] needs entry", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "expect_value_mismatch": "VM value differed from expect_value — fix script or input", "export_body_stubbed_p1": "Re script.put with supported return forms", "export_not_found": "Use export_names from script.put receipt", "input_alias_conflict": "test_input and input both set but differ — pass only one ABI payload", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass test_input / input — export requires parameters", "input_requires_integer_slots": "Numeric input slots only in P1 VM", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish or put with publish=live", "payload_too_large": "files[] exceeds the same byte cap as script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "run_timeout": "VM exceeded run timeout — simplify export", "script_id_or_files_required": "Pass script_id or ephemeral files[] with path/content and optional entry", "script_not_found": "script.put first", "script_test_failed": "Smoke test failed", "source_pathological": "Trim pathological sources (SS1098) before script.test", "stackscript_fuel_quota_exceeded": "Upgrade plan or script.profile", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "test_input_required": "Pass test_input matching export input_fields", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions", "vm_division_by_zero": "Guard divisor in script body before divide/mod", "vm_fuel_exhausted": "Export exceeded per-run fuel limit — simplify body or raise cap", "vm_int_overflow": "int53 overflow — narrow arithmetic in export body", "wallet_user_required": "MCP session user_id required — omit params.user_id", "workflow_scope_leak": "params.user_id must match session user_id"}, "examples": [{"name": "Smoke test with positional input", "request": {"params": {"expect_value": 5, "export": "add", "script_id": "demo-counter", "test_input": [2, 3], "version": "latest"}, "tool": "script.test"}}], "execution_class": "plain_read", "instruction_hint": "Sandbox smoke on latest_version after script.put (version=latest default; use version=live only aft…", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.put", "script.dry_run"], "required_cap": "stackscript_write", "requires_preflight": false, "risk_class": "read", "safe_action": "script_test", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Smoke-test an export via dry_run VM (no DNA commit). Optional expect_value assertion.", "title": "Script Test", "when_blocked": {"SS1202": "P1 has no throw — return { ok: false } for a room error. Allowed: int expr, a+b, tick+1, return input, return { ok: true|false }. script.docs topic=syntax", "SS1401": "dna.write path not in write_paths — fix export meta or script.put", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Retry once (heal from meta.sources) or script.put", "cap_not_implemented": "P1 VM — dna.*, events.emit (host allowlist), wallet via stackscript.wallet.replay; not http/notify/secrets — script.docs topic=host", "compile_failed": "Ephemeral files[] did not compile — see diagnostics", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S", "db_unavailable": "Retry script.test after retry_after_ms", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field on test_input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_write_path_denied": "Same as SS1401", "entry_path_required": "Multi-file files[] needs entry", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "expect_value_mismatch": "VM value differed from expect_value — fix script or input", "export_body_stubbed_p1": "Re script.put with supported return forms", "export_not_found": "Use export_names from script.put receipt", "input_alias_conflict": "test_input and input both set but differ — pass only one ABI payload", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass test_input / input — export requires parameters", "input_requires_integer_slots": "Numeric input slots only in P1 VM", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish or put with publish=live", "payload_too_large": "files[] exceeds the same byte cap as script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "run_timeout": "VM exceeded run timeout — simplify export", "script_id_or_files_required": "Pass script_id or ephemeral files[] with path/content and optional entry", "script_not_found": "script.put first", "script_test_failed": "Smoke test failed", "source_pathological": "Trim pathological sources (SS1098) before script.test", "stackscript_fuel_quota_exceeded": "Upgrade plan or script.profile", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "test_input_required": "Pass test_input matching export input_fields", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions", "vm_division_by_zero": "Guard divisor in script body before divide/mod", "vm_fuel_exhausted": "Export exceeded per-run fuel limit — simplify body or raise cap", "vm_int_overflow": "int53 overflow — narrow arithmetic in export body", "wallet_user_required": "MCP session user_id required — omit params.user_id", "workflow_scope_leak": "params.user_id must match session user_id"}, "when_not_to_use": "Not for production DNA commit or wallet settlement — use script.run after promote. Does not heal stale SSBC (unlike script.run); use script.recompile_version. dna.read needs read_paths prefetch — cache miss fails in dry_run VM.", "when_to_use": "Sandbox smoke on latest_version after script.put (version=latest default; use version=live only after script.publish). expect_value compares wire data.value (scalar or {value:…}); explicit null is ass", "workflow_ladder": ["script.docs?topic=syntax — TypeScript export shapes before script.put", "script.put validate_only=true — compile receipt only (persisted=false)", "script.put persist — version + code_hash from receipt", "script.test (version=latest) on the same script_id — before publish", "script.dry_run with export + input — inspect write_set and cost.fuel", "preflight.check action=script.publish — caps / approval preview", "script.publish alias live after caps approval if caps_diff.requires_approval", "script.run on prod only after generation.promote when using sandbox", "logic.attach_template tpl_stackscript_trigger_shell (field_values from put receipt)", "logic.dry_run — verify nested_stackscript trace on script_processor steps"], "write_mode": null}, {"action": "script.dry_run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.dry_run", "mutation_risk": "low", "related_tools": ["script.put", "script.test", "script.run", "script.publish", "logic.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Dry Run", "when_blocked": {"SS1401": "dna.write path not in write_paths — fix export meta or script.put", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Re-upload via script.put", "bytecode_stale": "compiler_version on the stored artifact differs — script.recompile_version or script.put before dry_run", "cap_not_implemented": "P1 VM — dna.*, events.emit (host allowlist), wallet via stackscript.wallet.replay; not http/notify/secrets — script.docs topic=host", "compile_failed": "Ephemeral sources did not compile — see diagnostics", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S", "db_unavailable": "Retry dry_run after retry_after_ms — same as script.run", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field on input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_write_path_denied": "Same as SS1401", "entry_path_required": "Multi-file files[] needs entry", "expect_value_mismatch": "VM value differed from expect_value — fix script or input", "export_not_found": "Use export_names from script.put receipt", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass input object or positional array — export requires parameters", "input_requires_integer_slots": "input values must be numeric (coerce strings)", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "invalid_parameters": "Ephemeral dry_run needs files[] with path and content", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish or put with publish=live", "payload_too_large": "files[] exceeds the same byte cap as script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "run_timeout": "VM exceeded run timeout — simplify export or split work", "script_dry_run_failed": "VM or export error — see error field", "script_id_or_files_required": "Pass script_id or ephemeral files[] with path/content and optional entry", "script_not_found": "script.put first", "source_pathological": "Source line count, line length, or comment-padding probe (SS1098) — max 25k lines/file, 8KiB/line; split or trim before script.dry_run", "stackscript_fuel_quota_exceeded": "Upgrade plan or reduce fuel", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions", "vm_division_by_zero": "Guard divisor in script body before divide/mod", "vm_fuel_exhausted": "Export exceeded per-run fuel limit — simplify body or raise cap", "vm_int_overflow": "int53 overflow — narrow arithmetic in export body", "wallet_user_required": "MCP session user_id required — omit params.user_id", "workflow_scope_leak": "params.user_id must match session user_id"}, "when_to_use": "Simulate export — inspect write_set, fuel, cost before script.run. Optional files[{path,content}] compiles in memory (ephemeral_compile) without script.put; omit files to run the stored SSBC. Multi-fi"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.dry_run", "mutation_risk": "low", "related_tools": ["script.put", "script.test", "script.run", "script.publish", "logic.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Dry Run", "when_blocked": {"SS1401": "dna.write path not in write_paths — fix export meta or script.put", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Re-upload via script.put", "bytecode_stale": "compiler_version on the stored artifact differs — script.recompile_version or script.put before dry_run", "cap_not_implemented": "P1 VM — dna.*, events.emit (host allowlist), wallet via stackscript.wallet.replay; not http/notify/secrets — script.docs topic=host", "compile_failed": "Ephemeral sources did not compile — see diagnostics", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S", "db_unavailable": "Retry dry_run after retry_after_ms — same as script.run", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field on input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_write_path_denied": "Same as SS1401", "entry_path_required": "Multi-file files[] needs entry", "expect_value_mismatch": "VM value differed from expect_value — fix script or input", "export_not_found": "Use export_names from script.put receipt", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass input object or positional array — export requires parameters", "input_requires_integer_slots": "input values must be numeric (coerce strings)", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "invalid_parameters": "Ephemeral dry_run needs files[] with path and content", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish or put with publish=live", "payload_too_large": "files[] exceeds the same byte cap as script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "run_timeout": "VM exceeded run timeout — simplify export or split work", "script_dry_run_failed": "VM or export error — see error field", "script_id_or_files_required": "Pass script_id or ephemeral files[] with path/content and optional entry", "script_not_found": "script.put first", "source_pathological": "Source line count, line length, or comment-padding probe (SS1098) — max 25k lines/file, 8KiB/line; split or trim before script.dry_run", "stackscript_fuel_quota_exceeded": "Upgrade plan or reduce fuel", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions", "vm_division_by_zero": "Guard divisor in script body before divide/mod", "vm_fuel_exhausted": "Export exceeded per-run fuel limit — simplify body or raise cap", "vm_int_overflow": "int53 overflow — narrow arithmetic in export body", "wallet_user_required": "MCP session user_id required — omit params.user_id", "workflow_scope_leak": "params.user_id must match session user_id"}, "when_to_use": "Simulate export — inspect write_set, fuel, cost before script.run. Optional files[{path,content}] compiles in memory (ephemeral_compile) without script.put; omit files to run the stored SSBC. Multi-fi"}, "do_not_use_when": "Do not use for production DNA commit — script.run after promote. wallet_ops and events in dry_run are previews only.", "domain": "script", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Reads resolve against generation_env_uuid when set in MCP context (sandbox anchor); otherwise production project slice", "effect_depends_on_params": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"SS1401": "dna.write path not in write_paths — fix export meta or script.put", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Re-upload via script.put", "bytecode_stale": "compiler_version on the stored artifact differs — script.recompile_version or script.put before dry_run", "cap_not_implemented": "P1 VM — dna.*, events.emit (host allowlist), wallet via stackscript.wallet.replay; not http/notify/secrets — script.docs topic=host", "compile_failed": "Ephemeral sources did not compile — see diagnostics", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S", "db_unavailable": "Retry dry_run after retry_after_ms — same as script.run", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field on input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_write_path_denied": "Same as SS1401", "entry_path_required": "Multi-file files[] needs entry", "expect_value_mismatch": "VM value differed from expect_value — fix script or input", "export_not_found": "Use export_names from script.put receipt", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass input object or positional array — export requires parameters", "input_requires_integer_slots": "input values must be numeric (coerce strings)", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "invalid_parameters": "Ephemeral dry_run needs files[] with path and content", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish or put with publish=live", "payload_too_large": "files[] exceeds the same byte cap as script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "run_timeout": "VM exceeded run timeout — simplify export or split work", "script_dry_run_failed": "VM or export error — see error field", "script_id_or_files_required": "Pass script_id or ephemeral files[] with path/content and optional entry", "script_not_found": "script.put first", "source_pathological": "Source line count, line length, or comment-padding probe (SS1098) — max 25k lines/file, 8KiB/line; split or trim before script.dry_run", "stackscript_fuel_quota_exceeded": "Upgrade plan or reduce fuel", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions", "vm_division_by_zero": "Guard divisor in script body before divide/mod", "vm_fuel_exhausted": "Export exceeded per-run fuel limit — simplify body or raise cap", "vm_int_overflow": "int53 overflow — narrow arithmetic in export body", "wallet_user_required": "MCP session user_id required — omit params.user_id", "workflow_scope_leak": "params.user_id must match session user_id"}, "examples": [{"name": "Preview write_set and fuel", "request": {"params": {"export": "tick", "input": {"n": 1}, "script_id": "demo-counter", "version": "latest"}, "tool": "script.dry_run"}}], "execution_class": "plain_read", "instruction_hint": "Simulate export — inspect write_set, fuel, cost before script.run. Optional files[{path,content}] c…", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.put", "script.test", "script.run", "script.publish", "logic.dry_run"], "required_cap": "stackscript_read", "requires_preflight": false, "risk_class": "read", "runtime_vars_hint": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "safe_action": "script_dry_run", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Execute without persisting side effects.", "title": "Script Dry Run", "when_blocked": {"SS1401": "dna.write path not in write_paths — fix export meta or script.put", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Re-upload via script.put", "bytecode_stale": "compiler_version on the stored artifact differs — script.recompile_version or script.put before dry_run", "cap_not_implemented": "P1 VM — dna.*, events.emit (host allowlist), wallet via stackscript.wallet.replay; not http/notify/secrets — script.docs topic=host", "compile_failed": "Ephemeral sources did not compile — see diagnostics", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S", "db_unavailable": "Retry dry_run after retry_after_ms — same as script.run", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field on input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_write_path_denied": "Same as SS1401", "entry_path_required": "Multi-file files[] needs entry", "expect_value_mismatch": "VM value differed from expect_value — fix script or input", "export_not_found": "Use export_names from script.put receipt", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass input object or positional array — export requires parameters", "input_requires_integer_slots": "input values must be numeric (coerce strings)", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "invalid_parameters": "Ephemeral dry_run needs files[] with path and content", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish or put with publish=live", "payload_too_large": "files[] exceeds the same byte cap as script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "run_timeout": "VM exceeded run timeout — simplify export or split work", "script_dry_run_failed": "VM or export error — see error field", "script_id_or_files_required": "Pass script_id or ephemeral files[] with path/content and optional entry", "script_not_found": "script.put first", "source_pathological": "Source line count, line length, or comment-padding probe (SS1098) — max 25k lines/file, 8KiB/line; split or trim before script.dry_run", "stackscript_fuel_quota_exceeded": "Upgrade plan or reduce fuel", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions", "vm_division_by_zero": "Guard divisor in script body before divide/mod", "vm_fuel_exhausted": "Export exceeded per-run fuel limit — simplify body or raise cap", "vm_int_overflow": "int53 overflow — narrow arithmetic in export body", "wallet_user_required": "MCP session user_id required — omit params.user_id", "workflow_scope_leak": "params.user_id must match session user_id"}, "when_not_to_use": "Do not use for production DNA commit — script.run after promote. wallet_ops and events in dry_run are previews only.", "when_to_use": "Simulate export — inspect write_set, fuel, cost before script.run. Optional files[{path,content}] compiles in memory (ephemeral_compile) without script.put; omit files to run the stored SSBC. Multi-fi", "workflow_ladder": ["script.docs?topic=syntax — TypeScript export shapes before script.put", "script.put validate_only=true — compile receipt only (persisted=false)", "script.put persist — version + code_hash from receipt", "script.test (version=latest) on the same script_id — before publish", "script.dry_run with export + input — inspect write_set and cost.fuel", "preflight.check action=script.publish — caps / approval preview", "script.publish alias live after caps approval if caps_diff.requires_approval", "script.run on prod only after generation.promote when using sandbox", "logic.attach_template tpl_stackscript_trigger_shell (field_values from put receipt)", "logic.dry_run — verify nested_stackscript trace on script_processor steps"], "write_mode": null}, {"action": "script.run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.run", "mutation_risk": "low", "related_tools": ["script.dry_run", "script.profile", "stackscript.dna.replay", "stackscript.wallet.replay", "rooms.quick_match"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Run", "visitor_callable": true, "when_blocked": {"SS1401": "dna.write path not in export write_paths — add write_paths on defineFn/defineCommand or narrow ctx.dna.put leaf", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Re-compile via script.put", "bytecode_stale": "Stored compiler_version differs — script.recompile_version off hosted hot path (no heal-on-read on script.run)", "cap_not_implemented": "P1 fail-closed — ctx.dna.cas is cap_not_implemented (not generic SS1202); dna.read/write + events.emit + wallet — script.docs topic=host", "commit_failed": "Ledger may be committed; DNA atomic failed — stackscript.dna.replay with dna_repair_path then script.profile", "db_unavailable": "Postgres recovering or pool reset — retry script.run with the same idempotency_key after retry_after_ms. failure_phase=dna_commit|repair_lookup|index_lookup|idempotency_lock|neural_flush tells which stage timed out — see data.failure_phase. neural_flush: L1 staged ok; background PG flush backlog — retry same idempotency_key", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field (matchId) on input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_read_miss_in_run": "Live script.run — declare read_paths on export, prefetch via input.__dna_prefetch, then script.dry_run to verify before commit", "dna_repair_outbox_failed": "Ledger committed but DNA repair outbox did not persist — operator incident; do not assume DNA matches ledger without manual verify", "dna_repair_pending": "Pending dna_repair outbox for this idempotency_key — stackscript.dna.replay before script.run (VM skipped)", "dna_write_path_denied": "Same as SS1401 — declare write_paths matching DNA leaves", "dry_run_preview_not_committable": "Internal — do not commit dry_run preview", "export_not_found": "Match script.put export_names", "export_not_public": "Hosted script.run denied — owner script.publish with approve_public_run=true after generation.promote", "generation_fork_required": "Operator-only prod write — hosted players use public_run after script.publish approve_public_run", "idempotency_key_reused": "Same key with different payload", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass input matching export input_fields — same ABI as script.dry_run", "input_requires_integer_slots": "Numeric input slots only in P1 VM", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish alias live or script.dry_run version=latest", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "public_run_caps_exceed_ceiling": "Export caps exceed hosted visitor ceiling — narrow caps or use operator run", "quick_match_required": "Hosted wt.m.* export without QM seat — rooms.quick_match then rooms.poll_events before retry", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "revision_conflict": "input.expected_revision does not match the runtime leaf. Retry script.run with data.actual_revision and a new idempotency_key.", "revision_required": "Runtime DNA write needs input.expected_revision (aliases match_revision, revision). Use data.actual_revision from this error — do not re-read DNA first. Not emitted for internal room_host ticks (script.room.tick); those use revision_gate + in-txn CAS.", "run_in_progress": "Same idempotency_key still running — wait retry_after_ms or use a new key", "run_lock_timeout": "Idempotency lock held too long — another run with the same key may be stuck; wait retry_after_ms or use a fresh idempotency_key", "run_timeout": "VM exceeded STACKSCRIPT_RUN_VM_SEC — simplify export, prefetch DNA, or split work", "sandbox_run_commit_forbidden": "Hosted cannot pin env_uuid for prod commit — use operator promote ladder", "sandbox_runtime_path_denied": "Sandbox commit allows ecosystem.scripts.runtime.* only — fix export write_paths (SS1401)", "script_not_found": "script.profile — then script.put + script.publish (live); not a missing export name", "script_run_failed": "VM or host error — see diagnostics in data", "stackscript_fuel_quota_exceeded": "Monthly fuel cap exceeded", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions — live alias may lag latest", "vm_division_by_zero": "Guard divisor before divide/mod in export body", "vm_fuel_exhausted": "Per-run fuel cap — reduce work or split exports", "vm_int_overflow": "int53 overflow in export body", "wallet_commit_failed": "Ledger step failed — balances unchanged in DNA on current path; legacy repair leaves: stackscript.wallet.replay with wallet_repair_path", "wallet_insufficient_funds": "Top up commerce wallet before wallet.debit in script.run", "wallet_partial_state": "Ledger spend_partial_state for script ref_id — stackscript.wallet.replay or new idempotency_key after ops review", "wallet_user_required": "MCP session must include operator user_id for wallet caps", "workflow_scope_leak": "params.user_id must match session user_id"}, "when_to_use": "Production DNA commit — batch generation_env_uuid is ignored (W25); use script.dry_run in sandbox, generation.promote, then script.run. script.dry_run first. See docs/operations/STACKSCRIPT_GENERATION"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.run", "mutation_risk": "low", "related_tools": ["script.dry_run", "script.profile", "stackscript.dna.replay", "stackscript.wallet.replay", "rooms.quick_match"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Run", "visitor_callable": true, "when_blocked": {"SS1401": "dna.write path not in export write_paths — add write_paths on defineFn/defineCommand or narrow ctx.dna.put leaf", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Re-compile via script.put", "bytecode_stale": "Stored compiler_version differs — script.recompile_version off hosted hot path (no heal-on-read on script.run)", "cap_not_implemented": "P1 fail-closed — ctx.dna.cas is cap_not_implemented (not generic SS1202); dna.read/write + events.emit + wallet — script.docs topic=host", "commit_failed": "Ledger may be committed; DNA atomic failed — stackscript.dna.replay with dna_repair_path then script.profile", "db_unavailable": "Postgres recovering or pool reset — retry script.run with the same idempotency_key after retry_after_ms. failure_phase=dna_commit|repair_lookup|index_lookup|idempotency_lock|neural_flush tells which stage timed out — see data.failure_phase. neural_flush: L1 staged ok; background PG flush backlog — retry same idempotency_key", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field (matchId) on input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_read_miss_in_run": "Live script.run — declare read_paths on export, prefetch via input.__dna_prefetch, then script.dry_run to verify before commit", "dna_repair_outbox_failed": "Ledger committed but DNA repair outbox did not persist — operator incident; do not assume DNA matches ledger without manual verify", "dna_repair_pending": "Pending dna_repair outbox for this idempotency_key — stackscript.dna.replay before script.run (VM skipped)", "dna_write_path_denied": "Same as SS1401 — declare write_paths matching DNA leaves", "dry_run_preview_not_committable": "Internal — do not commit dry_run preview", "export_not_found": "Match script.put export_names", "export_not_public": "Hosted script.run denied — owner script.publish with approve_public_run=true after generation.promote", "generation_fork_required": "Operator-only prod write — hosted players use public_run after script.publish approve_public_run", "idempotency_key_reused": "Same key with different payload", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass input matching export input_fields — same ABI as script.dry_run", "input_requires_integer_slots": "Numeric input slots only in P1 VM", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish alias live or script.dry_run version=latest", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "public_run_caps_exceed_ceiling": "Export caps exceed hosted visitor ceiling — narrow caps or use operator run", "quick_match_required": "Hosted wt.m.* export without QM seat — rooms.quick_match then rooms.poll_events before retry", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "revision_conflict": "input.expected_revision does not match the runtime leaf. Retry script.run with data.actual_revision and a new idempotency_key.", "revision_required": "Runtime DNA write needs input.expected_revision (aliases match_revision, revision). Use data.actual_revision from this error — do not re-read DNA first. Not emitted for internal room_host ticks (script.room.tick); those use revision_gate + in-txn CAS.", "run_in_progress": "Same idempotency_key still running — wait retry_after_ms or use a new key", "run_lock_timeout": "Idempotency lock held too long — another run with the same key may be stuck; wait retry_after_ms or use a fresh idempotency_key", "run_timeout": "VM exceeded STACKSCRIPT_RUN_VM_SEC — simplify export, prefetch DNA, or split work", "sandbox_run_commit_forbidden": "Hosted cannot pin env_uuid for prod commit — use operator promote ladder", "sandbox_runtime_path_denied": "Sandbox commit allows ecosystem.scripts.runtime.* only — fix export write_paths (SS1401)", "script_not_found": "script.profile — then script.put + script.publish (live); not a missing export name", "script_run_failed": "VM or host error — see diagnostics in data", "stackscript_fuel_quota_exceeded": "Monthly fuel cap exceeded", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions — live alias may lag latest", "vm_division_by_zero": "Guard divisor before divide/mod in export body", "vm_fuel_exhausted": "Per-run fuel cap — reduce work or split exports", "vm_int_overflow": "int53 overflow in export body", "wallet_commit_failed": "Ledger step failed — balances unchanged in DNA on current path; legacy repair leaves: stackscript.wallet.replay with wallet_repair_path", "wallet_insufficient_funds": "Top up commerce wallet before wallet.debit in script.run", "wallet_partial_state": "Ledger spend_partial_state for script ref_id — stackscript.wallet.replay or new idempotency_key after ops review", "wallet_user_required": "MCP session must include operator user_id for wallet caps", "workflow_scope_leak": "params.user_id must match session user_id"}, "when_to_use": "Production DNA commit — batch generation_env_uuid is ignored (W25); use script.dry_run in sandbox, generation.promote, then script.run. script.dry_run first. See docs/operations/STACKSCRIPT_GENERATION"}, "do_not_use_when": "Do not use under generation_env_uuid or to preview write_set — use script.dry_run, then generation.promote before prod commit. Batch context.generation_env_uuid is ignored (W25); passing env_uuid still triggers sandbox_run_commit_forbidden. Not for compile smoke — use script.test or script.put validate_only. Hosted wt.m.* exports need rooms.quick_match seat first — not for QM netplay without poll/ws. DNA coop lobby scripts (e.g. *.open / *.scan) do not use rooms.* — do not force quick_match.", "domain": "script", "effect": {"conditional_mutate": "Production commit only (_env_uuid_prod_commit); consumes VM fuel; preflight.check with context.project_id before first run; generation_env_uuid ignored — use script.test or script.dry_run to validate", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"SS1401": "dna.write path not in export write_paths — add write_paths on defineFn/defineCommand or narrow ctx.dna.put leaf", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Re-compile via script.put", "bytecode_stale": "Stored compiler_version differs — script.recompile_version off hosted hot path (no heal-on-read on script.run)", "cap_not_implemented": "P1 fail-closed — ctx.dna.cas is cap_not_implemented (not generic SS1202); dna.read/write + events.emit + wallet — script.docs topic=host", "commit_failed": "Ledger may be committed; DNA atomic failed — stackscript.dna.replay with dna_repair_path then script.profile", "db_unavailable": "Postgres recovering or pool reset — retry script.run with the same idempotency_key after retry_after_ms. failure_phase=dna_commit|repair_lookup|index_lookup|idempotency_lock|neural_flush tells which stage timed out — see data.failure_phase. neural_flush: L1 staged ok; background PG flush backlog — retry same idempotency_key", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field (matchId) on input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_read_miss_in_run": "Live script.run — declare read_paths on export, prefetch via input.__dna_prefetch, then script.dry_run to verify before commit", "dna_repair_outbox_failed": "Ledger committed but DNA repair outbox did not persist — operator incident; do not assume DNA matches ledger without manual verify", "dna_repair_pending": "Pending dna_repair outbox for this idempotency_key — stackscript.dna.replay before script.run (VM skipped)", "dna_write_path_denied": "Same as SS1401 — declare write_paths matching DNA leaves", "dry_run_preview_not_committable": "Internal — do not commit dry_run preview", "export_not_found": "Match script.put export_names", "export_not_public": "Hosted script.run denied — owner script.publish with approve_public_run=true after generation.promote", "generation_fork_required": "Operator-only prod write — hosted players use public_run after script.publish approve_public_run", "idempotency_key_reused": "Same key with different payload", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass input matching export input_fields — same ABI as script.dry_run", "input_requires_integer_slots": "Numeric input slots only in P1 VM", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish alias live or script.dry_run version=latest", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "public_run_caps_exceed_ceiling": "Export caps exceed hosted visitor ceiling — narrow caps or use operator run", "quick_match_required": "Hosted wt.m.* export without QM seat — rooms.quick_match then rooms.poll_events before retry", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "revision_conflict": "input.expected_revision does not match the runtime leaf. Retry script.run with data.actual_revision and a new idempotency_key.", "revision_required": "Runtime DNA write needs input.expected_revision (aliases match_revision, revision). Use data.actual_revision from this error — do not re-read DNA first. Not emitted for internal room_host ticks (script.room.tick); those use revision_gate + in-txn CAS.", "run_in_progress": "Same idempotency_key still running — wait retry_after_ms or use a new key", "run_lock_timeout": "Idempotency lock held too long — another run with the same key may be stuck; wait retry_after_ms or use a fresh idempotency_key", "run_timeout": "VM exceeded STACKSCRIPT_RUN_VM_SEC — simplify export, prefetch DNA, or split work", "sandbox_run_commit_forbidden": "Hosted cannot pin env_uuid for prod commit — use operator promote ladder", "sandbox_runtime_path_denied": "Sandbox commit allows ecosystem.scripts.runtime.* only — fix export write_paths (SS1401)", "script_not_found": "script.profile — then script.put + script.publish (live); not a missing export name", "script_run_failed": "VM or host error — see diagnostics in data", "stackscript_fuel_quota_exceeded": "Monthly fuel cap exceeded", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions — live alias may lag latest", "vm_division_by_zero": "Guard divisor before divide/mod in export body", "vm_fuel_exhausted": "Per-run fuel cap — reduce work or split exports", "vm_int_overflow": "int53 overflow in export body", "wallet_commit_failed": "Ledger step failed — balances unchanged in DNA on current path; legacy repair leaves: stackscript.wallet.replay with wallet_repair_path", "wallet_insufficient_funds": "Top up commerce wallet before wallet.debit in script.run", "wallet_partial_state": "Ledger spend_partial_state for script ref_id — stackscript.wallet.replay or new idempotency_key after ops review", "wallet_user_required": "MCP session must include operator user_id for wallet caps", "workflow_scope_leak": "params.user_id must match session user_id"}, "examples": [{"name": "Live export after publish ladder", "request": {"params": {"export": "tick", "idempotency_key": "run-demo-1", "input": {}, "script_id": "demo-counter", "version": "live"}, "tool": "script.run"}, "response": {"data": {"fuel_used": 12, "ok": true}, "success": true}}], "execution_class": "cheap", "hosted_coop_input": "Hosted coop commits: optional input.advisory_scope or coop_advisory_scope (opaque string); else runtime match_id from write_set; else {export}:{seed} on *.open; else {export}:{shard_key}:{value} for lobby_id|shard|pub|room_id. Same scope serializes; runtime leaves are NeuralCache L1 hot with debounced PG flush (timings.neural_defer=true); idempotency/fuel infra still flush immediately — retry same idempotency_key on db_unavailable. Read-only exports (e.g. nhl.scan without dna.write) set persist_idempotency=false — replay check still runs; PG idempotency leaf is omitted on commit.", "instruction_hint": "Production DNA commit — batch generation_env_uuid is ignored (W25); use script.dry_run in sandbox, …", "language": "typescript", "mutation_kind": "entity", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"actual_revision": {"description": "Runtime leaf revision after commit, or the current leaf when revision_required / revision_conflict", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "cost": {"description": "Fuel / USD estimate block from fuel_used", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "data": {"description": "VM return { value } when ok", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "dna_persisted": {"description": "False while runtime is neural-staged only; True after full PG commit", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "dna_repair_path": {"description": "Dotted DNA path when commit_failed after ledger (use stackscript.dna.replay)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "error": {"description": "Machine error code when ok is false", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "fuel_used": {"description": "VM fuel consumed during run", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "hint": {"description": "Operator recovery text (wallet/dna repair, idempotency, caps)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "idempotency_key": {"description": "Echo when caller supplied idempotency_key", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "idempotent_replay": {"description": "True when idempotency_key matched a prior successful commit", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "instruction_slice": {"description": "Optional operator hints from enrich_stackscript_instruction_slice", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "invocation_id": {"description": "Stable invocation identifier after commit", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "language": {"description": "Always typescript for script.put sources (TS subset, not JSON logic)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "match_id": {"description": "Runtime match id when the revision gate fired", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "ok": {"description": "True when the service operation completed successfully", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "recoverable": {"description": "True when wallet or DNA repair leaf was persisted", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "runtime_neural_staged": {"description": "True when hosted runtime leaves are L1-hot; PG flush is debounced (timings.neural_defer=true)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "script_id": {"description": "StackScript identifier in project scope", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "source_file_extension": {"description": "Use .ts paths in files[] (e.g. main.ts)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "timings": {"description": "Phase ms: lookup_ms, vm_ms; script.run adds bundle_ms, fuel_ms, commit_ms, pool_wait_ms, advisory_scope, dna_paths, neural_defer, neural_flush_backlog, neural_pending_paths when present", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "wallet_repair_path": {"description": "Dotted DNA path when wallet_commit_failed (use stackscript.wallet.replay)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "write_set_applied": {"description": "Count of DNA paths applied on commit", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane_chooser": "Hosted /s/{pid}/mcp: public_run exports after script.publish approve_public_run. DNA coop lobby: script.run on tenant exports — not rooms.*. QM netplay: rooms.quick_match → poll/ws_ticket → script.run on wt.m.*. Operator: full compile ladder + generation.promote. Match turns: idempotency + expected_revision in input.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.dry_run", "script.profile", "stackscript.dna.replay", "stackscript.wallet.replay", "rooms.quick_match"], "required_cap": "stackscript_run", "requires_preflight": true, "risk_class": "external_side_effect", "rollback": ["stackscript.dna.replay"], "runtime_vars_hint": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "safe_action": "script_run", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Execute a published script export on production DNA. Batch generation_env_uuid is ignored; use script.dry_run in sandbox.", "title": "Script Run", "verification": ["script.profile"], "verify": [{"action": "script.profile", "predicate": "named resource is visible"}], "when_blocked": {"SS1401": "dna.write path not in export write_paths — add write_paths on defineFn/defineCommand or narrow ctx.dna.put leaf", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Re-compile via script.put", "bytecode_stale": "Stored compiler_version differs — script.recompile_version off hosted hot path (no heal-on-read on script.run)", "cap_not_implemented": "P1 fail-closed — ctx.dna.cas is cap_not_implemented (not generic SS1202); dna.read/write + events.emit + wallet — script.docs topic=host", "commit_failed": "Ledger may be committed; DNA atomic failed — stackscript.dna.replay with dna_repair_path then script.profile", "db_unavailable": "Postgres recovering or pool reset — retry script.run with the same idempotency_key after retry_after_ms. failure_phase=dna_commit|repair_lookup|index_lookup|idempotency_lock|neural_flush tells which stage timed out — see data.failure_phase. neural_flush: L1 staged ok; background PG flush backlog — retry same idempotency_key", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field (matchId) on input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_read_miss_in_run": "Live script.run — declare read_paths on export, prefetch via input.__dna_prefetch, then script.dry_run to verify before commit", "dna_repair_outbox_failed": "Ledger committed but DNA repair outbox did not persist — operator incident; do not assume DNA matches ledger without manual verify", "dna_repair_pending": "Pending dna_repair outbox for this idempotency_key — stackscript.dna.replay before script.run (VM skipped)", "dna_write_path_denied": "Same as SS1401 — declare write_paths matching DNA leaves", "dry_run_preview_not_committable": "Internal — do not commit dry_run preview", "export_not_found": "Match script.put export_names", "export_not_public": "Hosted script.run denied — owner script.publish with approve_public_run=true after generation.promote", "generation_fork_required": "Operator-only prod write — hosted players use public_run after script.publish approve_public_run", "idempotency_key_reused": "Same key with different payload", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass input matching export input_fields — same ABI as script.dry_run", "input_requires_integer_slots": "Numeric input slots only in P1 VM", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish alias live or script.dry_run version=latest", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "public_run_caps_exceed_ceiling": "Export caps exceed hosted visitor ceiling — narrow caps or use operator run", "quick_match_required": "Hosted wt.m.* export without QM seat — rooms.quick_match then rooms.poll_events before retry", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "revision_conflict": "input.expected_revision does not match the runtime leaf. Retry script.run with data.actual_revision and a new idempotency_key.", "revision_required": "Runtime DNA write needs input.expected_revision (aliases match_revision, revision). Use data.actual_revision from this error — do not re-read DNA first. Not emitted for internal room_host ticks (script.room.tick); those use revision_gate + in-txn CAS.", "run_in_progress": "Same idempotency_key still running — wait retry_after_ms or use a new key", "run_lock_timeout": "Idempotency lock held too long — another run with the same key may be stuck; wait retry_after_ms or use a fresh idempotency_key", "run_timeout": "VM exceeded STACKSCRIPT_RUN_VM_SEC — simplify export, prefetch DNA, or split work", "sandbox_run_commit_forbidden": "Hosted cannot pin env_uuid for prod commit — use operator promote ladder", "sandbox_runtime_path_denied": "Sandbox commit allows ecosystem.scripts.runtime.* only — fix export write_paths (SS1401)", "script_not_found": "script.profile — then script.put + script.publish (live); not a missing export name", "script_run_failed": "VM or host error — see diagnostics in data", "stackscript_fuel_quota_exceeded": "Monthly fuel cap exceeded", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions — live alias may lag latest", "vm_division_by_zero": "Guard divisor before divide/mod in export body", "vm_fuel_exhausted": "Per-run fuel cap — reduce work or split exports", "vm_int_overflow": "int53 overflow in export body", "wallet_commit_failed": "Ledger step failed — balances unchanged in DNA on current path; legacy repair leaves: stackscript.wallet.replay with wallet_repair_path", "wallet_insufficient_funds": "Top up commerce wallet before wallet.debit in script.run", "wallet_partial_state": "Ledger spend_partial_state for script ref_id — stackscript.wallet.replay or new idempotency_key after ops review", "wallet_user_required": "MCP session must include operator user_id for wallet caps", "workflow_scope_leak": "params.user_id must match session user_id"}, "when_not_to_use": "Do not use under generation_env_uuid or to preview write_set — use script.dry_run, then generation.promote before prod commit. Batch context.generation_env_uuid is ignored (W25); passing env_uuid still triggers sandbox_run_commit_forbidden. Not for compile smoke — use script.test or script.put validate_only. Hosted wt.m.* exports need rooms.quick_match seat first — not for QM netplay without poll/ws. DNA coop lobby scripts (e.g. *.open / *.scan) do not use rooms.* — do not force quick_match.", "when_to_use": "Production DNA commit — batch generation_env_uuid is ignored (W25); use script.dry_run in sandbox, generation.promote, then script.run. script.dry_run first. See docs/operations/STACKSCRIPT_GENERATION", "workflow_ladder": ["script.docs?topic=syntax — TypeScript export shapes before script.put", "script.put validate_only=true — compile receipt only (persisted=false)", "script.put persist — version + code_hash from receipt", "script.test (version=latest) on the same script_id — before publish", "script.dry_run with export + input — inspect write_set and cost.fuel", "preflight.check action=script.publish — caps / approval preview", "script.publish alias live after caps approval if caps_diff.requires_approval", "script.run on prod only after generation.promote when using sandbox", "logic.attach_template tpl_stackscript_trigger_shell (field_values from put receipt)", "logic.dry_run — verify nested_stackscript trace on script_processor steps"], "write_mode": null}, {"action": "script.docs", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.docs", "mutation_risk": "low", "related_tools": ["script.put", "script.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Docs", "when_blocked": {"unknown_topic": "topic must be a key from script.docs with no topic (overview lists topics)"}, "when_to_use": "TypeScript syntax + runtime topics (syntax, overview, fuel, migration, host, runtime, room, idempotency, dna_repair, limits)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.docs", "mutation_risk": "low", "related_tools": ["script.put", "script.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Docs", "when_blocked": {"unknown_topic": "topic must be a key from script.docs with no topic (overview lists topics)"}, "when_to_use": "TypeScript syntax + runtime topics (syntax, overview, fuel, migration, host, runtime, room, idempotency, dna_repair, limits)."}, "do_not_use_when": "Reference only — does not compile, publish, or mutate DNA. For live errors use instruction_slice on script.test / script.dry_run / script.run.", "domain": "script", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"unknown_topic": "topic must be a key from script.docs with no topic (overview lists topics)"}, "execution_class": "plain_read", "instruction_hint": "TypeScript syntax + runtime topics (syntax, overview, fuel, migration, host, runtime, room, idempot…", "language": "typescript", "lifecycle_checklist": "ABI: {} vs [] vs omitted for zero-arg exports — same in script.test and script.dry_run. Batch mutat…", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.put", "script.dry_run"], "required_cap": "stackscript_read", "requires_preflight": false, "risk_class": "read", "safe_action": "script_docs", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "StackScript language docs (TypeScript subset). Topics: syntax, overview, fuel, migration, host, runtime, room, idempotency, dna_repair, limits (aliases: rooms, multiplayer).", "title": "Script Docs", "when_blocked": {"unknown_topic": "topic must be a key from script.docs with no topic (overview lists topics)"}, "when_not_to_use": "Reference only — does not compile, publish, or mutate DNA. For live errors use instruction_slice on script.test / script.dry_run / script.run.", "when_to_use": "TypeScript syntax + runtime topics (syntax, overview, fuel, migration, host, runtime, room, idempotency, dna_repair, limits).", "write_mode": null}, {"action": "script.publish", "aliases": ["stackscript.publish"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": true, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.publish", "mutation_risk": "low", "related_tools": ["script.versions", "script.dry_run", "script.rollback", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Publish", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "budget_exceeded": "Fabric budget — wait retry_after_ms or narrow publish batch", "caps_approval_required": "approve_caps or config.agent_can_approve_caps — see caps_diff", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before publish", "index_update_failed": "DNA index patch failed — verify generation_env_uuid anchor", "preflight_blocked": "Run preflight.check action=script.publish first", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "public_run_no_eligible_exports": "No export has approve_public_run — owner script.publish with approve_public_run=true", "script_not_found": "script.put on resolved_env_uuid — verify script.versions", "script_publish_failed": "Unexpected publish failure — inspect data", "server_busy": "Publish lane saturated — retry after retry_after_ms", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "version_not_found": "Check script.versions"}, "when_to_use": "Requires stackscript_admin (or project write + caps). After auth.switch_project in the same execute batch, rely on batch_session_promote so preflight sees the tenant pid. Promote version to live/stagi"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": true, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.publish", "mutation_risk": "low", "related_tools": ["script.versions", "script.dry_run", "script.rollback", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Publish", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "budget_exceeded": "Fabric budget — wait retry_after_ms or narrow publish batch", "caps_approval_required": "approve_caps or config.agent_can_approve_caps — see caps_diff", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before publish", "index_update_failed": "DNA index patch failed — verify generation_env_uuid anchor", "preflight_blocked": "Run preflight.check action=script.publish first", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "public_run_no_eligible_exports": "No export has approve_public_run — owner script.publish with approve_public_run=true", "script_not_found": "script.put on resolved_env_uuid — verify script.versions", "script_publish_failed": "Unexpected publish failure — inspect data", "server_busy": "Publish lane saturated — retry after retry_after_ms", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "version_not_found": "Check script.versions"}, "when_to_use": "Requires stackscript_admin (or project write + caps). After auth.switch_project in the same execute batch, rely on batch_session_promote so preflight sees the tenant pid. Promote version to live/stagi"}, "do_not_use_when": "Not for sandbox verification — dry_run/test under generation_env_uuid first. Does not run exports; only moves live/staging alias after caps preflight.", "domain": "script", "effect": {"conditional_mutate": "Mutates script alias leaf in project DNA.", "effect_depends_on_params": true, "execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "budget_exceeded": "Fabric budget — wait retry_after_ms or narrow publish batch", "caps_approval_required": "approve_caps or config.agent_can_approve_caps — see caps_diff", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before publish", "index_update_failed": "DNA index patch failed — verify generation_env_uuid anchor", "preflight_blocked": "Run preflight.check action=script.publish first", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "public_run_no_eligible_exports": "No export has approve_public_run — owner script.publish with approve_public_run=true", "script_not_found": "script.put on resolved_env_uuid — verify script.versions", "script_publish_failed": "Unexpected publish failure — inspect data", "server_busy": "Publish lane saturated — retry after retry_after_ms", "version_not_found": "Check script.versions"}, "examples": [{"name": "Promote version to live", "request": {"params": {"alias": "live", "approve_caps": true, "script_id": "demo-counter", "version": 2}, "tool": "script.publish"}, "response": {"data": {"alias": "live", "ok": true, "version": 2}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Requires stackscript_admin (or project write + caps). After auth.switch_project in the same execute…", "language": "typescript", "mutation_kind": "entity", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"alias": {"description": "live or staging alias updated", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "error": {"description": "Machine error code when ok is false", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "instruction_slice": {"description": "Optional operator hints from enrich_stackscript_instruction_slice", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "language": {"description": "Always typescript for script.put sources (TS subset, not JSON logic)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "ok": {"description": "True when the service operation completed successfully", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "previous_version": {"description": "Prior alias version when rolled forward", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "script_id": {"description": "StackScript identifier in project scope", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "source_file_extension": {"description": "Use .ts paths in files[] (e.g. main.ts)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "version": {"description": "Target version bound to the alias", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "preflight_action": "preflight.check", "related_tools": ["script.versions", "script.dry_run", "script.rollback", "preflight.check"], "required_cap": "stackscript_admin", "requires_preflight": true, "risk_class": "production_publish", "rollback": ["script.rollback"], "safe_action": "script_publish", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Move alias live/staging to a version.", "title": "Script Publish", "verification": ["script.versions", "script.get"], "verify": [{"action": "script.versions", "predicate": "named resource is visible"}, {"action": "script.get", "predicate": "named resource is visible"}], "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "budget_exceeded": "Fabric budget — wait retry_after_ms or narrow publish batch", "caps_approval_required": "approve_caps or config.agent_can_approve_caps — see caps_diff", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before publish", "index_update_failed": "DNA index patch failed — verify generation_env_uuid anchor", "preflight_blocked": "Run preflight.check action=script.publish first", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "public_run_no_eligible_exports": "No export has approve_public_run — owner script.publish with approve_public_run=true", "script_not_found": "script.put on resolved_env_uuid — verify script.versions", "script_publish_failed": "Unexpected publish failure — inspect data", "server_busy": "Publish lane saturated — retry after retry_after_ms", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "version_not_found": "Check script.versions"}, "when_not_to_use": "Not for sandbox verification — dry_run/test under generation_env_uuid first. Does not run exports; only moves live/staging alias after caps preflight.", "when_to_use": "Requires stackscript_admin (or project write + caps). After auth.switch_project in the same execute batch, rely on batch_session_promote so preflight sees the tenant pid. Promote version to live/stagi", "workflow_ladder": ["script.docs?topic=syntax — TypeScript export shapes before script.put", "script.put validate_only=true — compile receipt only (persisted=false)", "script.put persist — version + code_hash from receipt", "script.test (version=latest) on the same script_id — before publish", "script.dry_run with export + input — inspect write_set and cost.fuel", "preflight.check action=script.publish — caps / approval preview", "script.publish alias live after caps approval if caps_diff.requires_approval", "script.run on prod only after generation.promote when using sandbox", "logic.attach_template tpl_stackscript_trigger_shell (field_values from put receipt)", "logic.dry_run — verify nested_stackscript trace on script_processor steps"], "write_mode": null}, {"action": "script.rollback", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.rollback", "mutation_risk": "low", "related_tools": ["script.versions", "script.publish"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Rollback", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "caps_approval_required": "approve_caps=true on script.rollback", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before rollback", "index_update_failed": "Same as script.publish — index patch failed", "preflight_blocked": "Run preflight.check action=script.publish first", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_rollback_failed": "Unexpected rollback failure — inspect data", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "version_not_found": "Target version missing"}, "when_to_use": "Point live alias at prior version — script.versions first. Same preflight/caps gates as script.publish."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.rollback", "mutation_risk": "low", "related_tools": ["script.versions", "script.publish"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Rollback", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "caps_approval_required": "approve_caps=true on script.rollback", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before rollback", "index_update_failed": "Same as script.publish — index patch failed", "preflight_blocked": "Run preflight.check action=script.publish first", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_rollback_failed": "Unexpected rollback failure — inspect data", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "version_not_found": "Target version missing"}, "when_to_use": "Point live alias at prior version — script.versions first. Same preflight/caps gates as script.publish."}, "do_not_use_when": "Alias move only — does not fix broken exports; recompile or script.put after rollback.", "domain": "script", "effect": {"conditional_mutate": "Repoints live script alias via publish; not a read.", "effect_depends_on_params": true, "execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "caps_approval_required": "approve_caps=true on script.rollback", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before rollback", "index_update_failed": "Same as script.publish — index patch failed", "preflight_blocked": "Run preflight.check action=script.publish first", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_rollback_failed": "Unexpected rollback failure — inspect data", "version_not_found": "Target version missing"}, "execution_class": "cheap", "instruction_hint": "Point live alias at prior version — script.versions first. Same preflight/caps gates as script.publ…", "language": "typescript", "mutation_kind": "none", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"alias": {"description": "Alias rolled back (typically live)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "error": {"description": "Machine error code when ok is false", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "instruction_slice": {"description": "Optional operator hints from enrich_stackscript_instruction_slice", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "language": {"description": "Always typescript for script.put sources (TS subset, not JSON logic)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "ok": {"description": "True when the service operation completed successfully", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "reason": {"description": "Operator reason echoed from params", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "script_id": {"description": "StackScript identifier in project scope", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "source_file_extension": {"description": "Use .ts paths in files[] (e.g. main.ts)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "version": {"description": "Version now bound after rollback", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "preflight_action": "preflight.check", "related_tools": ["script.versions", "script.publish"], "required_cap": "stackscript_admin", "requires_preflight": true, "risk_class": "low_write", "rollback": [], "safe_action": "script_rollback", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Rollback live alias to a prior version.", "title": "Script Rollback", "verification": ["script.versions", "script.get"], "verify": [{"action": "script.versions", "predicate": "named resource is visible"}, {"action": "script.get", "predicate": "named resource is visible"}], "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "caps_approval_required": "approve_caps=true on script.rollback", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before rollback", "index_update_failed": "Same as script.publish — index patch failed", "preflight_blocked": "Run preflight.check action=script.publish first", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_rollback_failed": "Unexpected rollback failure — inspect data", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "version_not_found": "Target version missing"}, "when_not_to_use": "Alias move only — does not fix broken exports; recompile or script.put after rollback.", "when_to_use": "Point live alias at prior version — script.versions first. Same preflight/caps gates as script.publish.", "write_mode": null}, {"action": "script.versions", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.versions", "mutation_risk": "low", "related_tools": ["script.get", "script.publish"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Versions", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "not_found": "Unknown script_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_not_found": "Unknown script_id — script.list or script.put first"}, "when_to_use": "List versions before publish or rollback."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.versions", "mutation_risk": "low", "related_tools": ["script.get", "script.publish"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Versions", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "not_found": "Unknown script_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_not_found": "Unknown script_id — script.list or script.put first"}, "when_to_use": "List versions before publish or rollback."}, "do_not_use_when": "Index metadata — not source bodies; use script.get with version= or studio_bundle.", "domain": "script", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Reads resolve against generation_env_uuid when set in MCP context (sandbox anchor); otherwise production project slice", "effect_depends_on_params": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "not_found": "Unknown script_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_not_found": "Unknown script_id — script.list or script.put first"}, "execution_class": "plain_read", "instruction_hint": "List versions before publish or rollback.", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.get", "script.publish"], "required_cap": "stackscript_read", "requires_preflight": false, "risk_class": "read", "safe_action": "script_versions", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "List versions and aliases for a script.", "title": "Script Versions", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "not_found": "Unknown script_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_not_found": "Unknown script_id — script.list or script.put first"}, "when_not_to_use": "Index metadata — not source bodies; use script.get with version= or studio_bundle.", "when_to_use": "List versions before publish or rollback.", "write_mode": null}, {"action": "script.recompile_version", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.recompile_version", "mutation_risk": "low", "related_tools": ["script.versions", "script.dry_run", "script.put"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Recompile Version", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Version meta missing code_hash", "cap_not_implemented": "Same as script.put — ctx.dna.cas is compile fail-closed; see script.docs topic=host", "compile_failed": "Fix diagnostics[] then recompile", "export_body_stubbed_p1": "P1 body unsupported — script.docs topic=syntax", "generation_fork_required": "Bind generation_env_uuid before recompile", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_recompile_failed": "Unexpected recompile failure — inspect diagnostics", "sources_missing": "No retained sources on version — script.put again", "ssbc_blob_unreadable": "Storage upload failed — check storage.get_quota", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "version_not_found": "script.versions — pick numeric version"}, "when_to_use": "Refresh SSBC + meta.exports from retained sources for an existing version (legacy entry_pc heal without allocating a new version)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.recompile_version", "mutation_risk": "low", "related_tools": ["script.versions", "script.dry_run", "script.put"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Recompile Version", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Version meta missing code_hash", "cap_not_implemented": "Same as script.put — ctx.dna.cas is compile fail-closed; see script.docs topic=host", "compile_failed": "Fix diagnostics[] then recompile", "export_body_stubbed_p1": "P1 body unsupported — script.docs topic=syntax", "generation_fork_required": "Bind generation_env_uuid before recompile", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_recompile_failed": "Unexpected recompile failure — inspect diagnostics", "sources_missing": "No retained sources on version — script.put again", "ssbc_blob_unreadable": "Storage upload failed — check storage.get_quota", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "version_not_found": "script.versions — pick numeric version"}, "when_to_use": "Refresh SSBC + meta.exports from retained sources for an existing version (legacy entry_pc heal without allocating a new version)."}, "do_not_use_when": "Not for new semver — script.put allocates versions. Does not publish live alias.", "domain": "script", "effect": {"execution_class": "heavy", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Version meta missing code_hash", "cap_not_implemented": "Same as script.put — ctx.dna.cas is compile fail-closed; see script.docs topic=host", "compile_failed": "Fix diagnostics[] then recompile", "export_body_stubbed_p1": "P1 body unsupported — script.docs topic=syntax", "generation_fork_required": "Bind generation_env_uuid before recompile", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_recompile_failed": "Unexpected recompile failure — inspect diagnostics", "sources_missing": "No retained sources on version — script.put again", "ssbc_blob_unreadable": "Storage upload failed — check storage.get_quota", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "version_not_found": "script.versions — pick numeric version"}, "execution_class": "heavy", "instruction_hint": "Refresh SSBC + meta.exports from retained sources for an existing version (legacy entry_pc heal wit…", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.versions", "script.dry_run", "script.put"], "required_cap": "stackscript_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "script_recompile_version", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Re-compile retained sources for a version; refresh SSBC blob and meta.exports (heal legacy entry_pc without script.put bump).", "title": "Script Recompile Version", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Version meta missing code_hash", "cap_not_implemented": "Same as script.put — ctx.dna.cas is compile fail-closed; see script.docs topic=host", "compile_failed": "Fix diagnostics[] then recompile", "export_body_stubbed_p1": "P1 body unsupported — script.docs topic=syntax", "generation_fork_required": "Bind generation_env_uuid before recompile", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_recompile_failed": "Unexpected recompile failure — inspect diagnostics", "sources_missing": "No retained sources on version — script.put again", "ssbc_blob_unreadable": "Storage upload failed — check storage.get_quota", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "version_not_found": "script.versions — pick numeric version"}, "when_not_to_use": "Not for new semver — script.put allocates versions. Does not publish live alias.", "when_to_use": "Refresh SSBC + meta.exports from retained sources for an existing version (legacy entry_pc heal without allocating a new version).", "write_mode": null}, {"action": "script.profile", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.profile", "mutation_risk": "low", "related_tools": ["script.run", "script.dry_run", "script.versions"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Profile", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_not_found": "Unknown script_id for this generation_env_uuid slice"}, "when_to_use": "Invocation fuel + optrace rollup for script_id — scoped with generation_env_uuid when set."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.profile", "mutation_risk": "low", "related_tools": ["script.run", "script.dry_run", "script.versions"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Profile", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_not_found": "Unknown script_id for this generation_env_uuid slice"}, "when_to_use": "Invocation fuel + optrace rollup for script_id — scoped with generation_env_uuid when set."}, "do_not_use_when": "Read-only aggregates — not DNA repair; use stackscript.dna.replay / wallet.replay with paths from a failed script.run.", "domain": "script", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Reads resolve against generation_env_uuid when set in MCP context (sandbox anchor); otherwise production project slice", "effect_depends_on_params": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_not_found": "Unknown script_id for this generation_env_uuid slice"}, "execution_class": "plain_read", "instruction_hint": "Invocation fuel + optrace rollup for script_id — scoped with generation_env_uuid when set.", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.run", "script.dry_run", "script.versions"], "required_cap": "stackscript_read", "requires_preflight": false, "risk_class": "read", "safe_action": "script_profile", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Execution aggregates and hot lines.", "title": "Script Profile", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_not_found": "Unknown script_id for this generation_env_uuid slice"}, "when_not_to_use": "Read-only aggregates — not DNA repair; use stackscript.dna.replay / wallet.replay with paths from a failed script.run.", "when_to_use": "Invocation fuel + optrace rollup for script_id — scoped with generation_env_uuid when set.", "write_mode": null}, {"action": "script.archive", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.archive", "mutation_risk": "low", "related_tools": ["script.list", "script.delete", "script.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Archive", "when_blocked": {"archive_failed": "Index leaf write failed — bind generation_env_uuid in sandbox", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "not_found": "Unknown script_id — script.list or script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_id_required": "params.script_id required", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "when_to_use": "Retire script from default flows without purging SSBC — reversible in sandbox."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.archive", "mutation_risk": "low", "related_tools": ["script.list", "script.delete", "script.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Archive", "when_blocked": {"archive_failed": "Index leaf write failed — bind generation_env_uuid in sandbox", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "not_found": "Unknown script_id — script.list or script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_id_required": "params.script_id required", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "when_to_use": "Retire script from default flows without purging SSBC — reversible in sandbox."}, "do_not_use_when": "Soft-hide listing — does not delete bytecode; script.delete for removal.", "domain": "script", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Retires script from Studio index; SSBC versions remain. Prefer archive over script.delete; tenant DNA via generation.promote after sandbox", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"archive_failed": "Index leaf write failed — bind generation_env_uuid in sandbox", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "not_found": "Unknown script_id — script.list or script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_id_required": "params.script_id required", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "execution_class": "cheap", "instruction_hint": "Retire script from default flows without purging SSBC — reversible in sandbox.", "language": "typescript", "mutation_kind": "entity", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.list", "script.delete", "script.get"], "required_cap": "stackscript_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "script_archive", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Archive a script index entry (reversible via script.put index patch in sandbox). Does not delete SSBC versions — use script.delete for tombstone.", "title": "Script Archive", "when_blocked": {"archive_failed": "Index leaf write failed — bind generation_env_uuid in sandbox", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "not_found": "Unknown script_id — script.list or script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_id_required": "params.script_id required", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "when_not_to_use": "Soft-hide listing — does not delete bytecode; script.delete for removal.", "when_to_use": "Retire script from default flows without purging SSBC — reversible in sandbox.", "write_mode": null}, {"action": "script.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.delete", "mutation_risk": "low", "related_tools": ["script.archive", "script.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Delete", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "delete_failed": "Index tombstone failed — sandbox + generation.promote for tenants", "not_found": "Unknown script_id — script.list", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_id_required": "params.script_id required", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "when_to_use": "Tombstone script index (destructive). Prefer script.archive; tenant DNA via generation.promote after sandbox script.delete."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.delete", "mutation_risk": "low", "related_tools": ["script.archive", "script.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Delete", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "delete_failed": "Index tombstone failed — sandbox + generation.promote for tenants", "not_found": "Unknown script_id — script.list", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_id_required": "params.script_id required", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "when_to_use": "Tombstone script index (destructive). Prefer script.archive; tenant DNA via generation.promote after sandbox script.delete."}, "do_not_use_when": "Destructive — not reversible via MCP. Not for sandbox experiments (generation.promote path instead).", "domain": "script", "effect": {"conditional_mutate": "Tombstones script index (destructive). Use generation_env_uuid + promote; preflight.check when batching with other script.* mutates", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "delete_failed": "Index tombstone failed — sandbox + generation.promote for tenants", "not_found": "Unknown script_id — script.list", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_id_required": "params.script_id required", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "execution_class": "cheap", "instruction_hint": "Tombstone script index (destructive). Prefer script.archive; tenant DNA via generation.promote afte…", "language": "typescript", "mutation_kind": "entity", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "preflight_action": "preflight.check", "related_tools": ["script.archive", "script.list"], "required_cap": "stackscript_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "script_delete", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Tombstone script index (destructive). SSBC blobs may remain for audit — prefer script.archive when retiring from Studio.", "title": "Script Delete", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "delete_failed": "Index tombstone failed — sandbox + generation.promote for tenants", "not_found": "Unknown script_id — script.list", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_id_required": "params.script_id required", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "when_not_to_use": "Destructive — not reversible via MCP. Not for sandbox experiments (generation.promote path instead).", "when_to_use": "Tombstone script index (destructive). Prefer script.archive; tenant DNA via generation.promote after sandbox script.delete.", "write_mode": null}, {"action": "script.room.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.room.status", "mutation_risk": "low", "related_tools": ["script.room.create", "script.room.join", "script.room.leave", "script.room.tick"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Script Room Status", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name (or name) required", "service_cap_denied": "Operator session needs mcp_read — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "when_to_use": "In-process script.room table — read exists/player_count before join/tick smoke."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.room.status", "mutation_risk": "low", "related_tools": ["script.room.create", "script.room.join", "script.room.leave", "script.room.tick"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Script Room Status", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name (or name) required", "service_cap_denied": "Operator session needs mcp_read — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "when_to_use": "In-process script.room table — read exists/player_count before join/tick smoke."}, "do_not_use_when": "In-process table only — not cross-worker SoT; create on the same worker that ticks. Not authoritative board/revision — poll DNA runtime.{matchId}.* or journal CAS.", "domain": "script", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name (or name) required", "service_cap_denied": "Operator session needs mcp_read — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "execution_class": "plain_read", "instruction_hint": "In-process script.room table — read exists/player_count before join/tick smoke.", "language": "typescript", "mutation_kind": "none", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"error": {"description": "Machine error code when ok is false", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "exists": {"description": "False when no in-process room for project_id:name", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "instruction_slice": {"description": "Optional operator hints from enrich_stackscript_instruction_slice", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "language": {"description": "Always typescript for script.put sources (TS subset, not JSON logic)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "last_tick_at": {"description": "Unix timestamp of last successful tick when exists is true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "name": {"description": "Room name (params.room_name or name)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "ok": {"description": "True when the service operation completed successfully", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "player_count": {"description": "Joined user_ids count when exists is true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Project scope for the room table key", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "script_id": {"description": "StackScript identifier in project scope", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "source_file_extension": {"description": "Use .ts paths in files[] (e.g. main.ts)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "tick_count": {"description": "Ticks advanced when exists is true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "tick_hz": {"description": "Configured tick rate (default 20) when exists is true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.room.create", "script.room.join", "script.room.leave", "script.room.tick"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "script_room_status", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Read in-process StackScript room runtime state (script.room.* table; no defineRoom TS API).", "title": "Script Room Status", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name (or name) required", "service_cap_denied": "Operator session needs mcp_read — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "when_not_to_use": "In-process table only — not cross-worker SoT; create on the same worker that ticks. Not authoritative board/revision — poll DNA runtime.{matchId}.* or journal CAS.", "when_to_use": "In-process script.room table — read exists/player_count before join/tick smoke.", "write_mode": null}, {"action": "script.room.create", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.room.create", "mutation_risk": "low", "related_tools": ["script.room.join", "script.room.leave", "script.room.status", "script.docs"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Script Room Create", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "auth_required_to_host": "Anonymous hosted guest — quick_match/join/solo OK; sign in to host custom room (TG 2177)", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name required — MCP script.room.create", "room_table_full": "Process room table full with seated rooms — script.room.status, leave idle rooms, or retry on another worker", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "when_to_use": "Host a custom in-process room (defineRoom lab). Anonymous guests: rooms.quick_match or script.room.join — not create."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.room.create", "mutation_risk": "low", "related_tools": ["script.room.join", "script.room.leave", "script.room.status", "script.docs"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Script Room Create", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "auth_required_to_host": "Anonymous hosted guest — quick_match/join/solo OK; sign in to host custom room (TG 2177)", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name required — MCP script.room.create", "room_table_full": "Process room table full with seated rooms — script.room.status, leave idle rooms, or retry on another worker", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "when_to_use": "Host a custom in-process room (defineRoom lab). Anonymous guests: rooms.quick_match or script.room.join — not create."}, "do_not_use_when": "Not persistent multi-host rooms — same-process demo; not DNA-backed lobbies.", "domain": "script", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "auth_required_to_host": "Anonymous hosted guest — quick_match/join/solo OK; sign in to host custom room (TG 2177)", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name required — MCP script.room.create", "room_table_full": "Process room table full with seated rooms — script.room.status, leave idle rooms, or retry on another worker", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "execution_class": "cheap", "instruction_hint": "Host a custom in-process room (defineRoom lab). Anonymous guests: rooms.quick_match or script.room.…", "language": "typescript", "mutation_kind": "entity", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"error": {"description": "Machine error code when ok is false", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "exists": {"description": "False when no in-process room for project_id:name", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "instruction_slice": {"description": "Optional operator hints from enrich_stackscript_instruction_slice", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "language": {"description": "Always typescript for script.put sources (TS subset, not JSON logic)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "last_tick_at": {"description": "Unix timestamp of last successful tick when exists is true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "name": {"description": "Room name (params.room_name or name)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "ok": {"description": "True when the service operation completed successfully", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "player_count": {"description": "Joined user_ids count when exists is true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Project scope for the room table key", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "script_id": {"description": "StackScript identifier in project scope", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "source_file_extension": {"description": "Use .ts paths in files[] (e.g. main.ts)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "tick_count": {"description": "Ticks advanced when exists is true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "tick_hz": {"description": "Configured tick rate (default 20) when exists is true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.room.join", "script.room.leave", "script.room.status", "script.docs"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "script_room_create", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Create in-process StackScript room (MCP script.room.create — not a TS defineRoom export).", "title": "Script Room Create", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "auth_required_to_host": "Anonymous hosted guest — quick_match/join/solo OK; sign in to host custom room (TG 2177)", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name required — MCP script.room.create", "room_table_full": "Process room table full with seated rooms — script.room.status, leave idle rooms, or retry on another worker", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "when_not_to_use": "Not persistent multi-host rooms — same-process demo; not DNA-backed lobbies.", "when_to_use": "Host a custom in-process room (defineRoom lab). Anonymous guests: rooms.quick_match or script.room.join — not create.", "write_mode": null}, {"action": "script.room.join", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.room.join", "mutation_risk": "low", "related_tools": ["script.room.create", "script.room.leave", "script.room.status", "script.room.tick"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Script Room Join", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_full": "Seat cap reached — leave players or create another room_name", "room_name_required": "params.room_name required", "room_not_found": "script.room.create first — join does not create rooms", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "wallet_user_required": "MCP session user_id required — params.user_id cannot impersonate", "workflow_scope_leak": "params.user_id must match session user_id — body cannot override principal"}, "when_to_use": "Join authenticated operator to in-process room table (mcp_write). Uses MCP context user_id; params.user_id must match or be omitted (no defineRoom — rooms are script.room.* only)."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.room.join", "mutation_risk": "low", "related_tools": ["script.room.create", "script.room.leave", "script.room.status", "script.room.tick"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Script Room Join", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_full": "Seat cap reached — leave players or create another room_name", "room_name_required": "params.room_name required", "room_not_found": "script.room.create first — join does not create rooms", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "wallet_user_required": "MCP session user_id required — params.user_id cannot impersonate", "workflow_scope_leak": "params.user_id must match session user_id — body cannot override principal"}, "when_to_use": "Join authenticated operator to in-process room table (mcp_write). Uses MCP context user_id; params.user_id must match or be omitted (no defineRoom — rooms are script.room.* only)."}, "do_not_use_when": "Not account provisioning — requires wallet user_id; room must exist (script.room.create).", "domain": "script", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_full": "Seat cap reached — leave players or create another room_name", "room_name_required": "params.room_name required", "room_not_found": "script.room.create first — join does not create rooms", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "wallet_user_required": "MCP session user_id required — params.user_id cannot impersonate", "workflow_scope_leak": "params.user_id must match session user_id — body cannot override principal"}, "execution_class": "cheap", "instruction_hint": "Join authenticated operator to in-process room table (mcp_write). Uses MCP context user_id; params.…", "language": "typescript", "mutation_kind": "entity", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"error": {"description": "Machine error code when ok is false", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "exists": {"description": "False when no in-process room for project_id:name", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "instruction_slice": {"description": "Optional operator hints from enrich_stackscript_instruction_slice", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "language": {"description": "Always typescript for script.put sources (TS subset, not JSON logic)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "last_tick_at": {"description": "Unix timestamp of last successful tick when exists is true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "name": {"description": "Room name (params.room_name or name)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "ok": {"description": "True when the service operation completed successfully", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "player_count": {"description": "Joined user_ids count when exists is true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Project scope for the room table key", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "script_id": {"description": "StackScript identifier in project scope", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "source_file_extension": {"description": "Use .ts paths in files[] (e.g. main.ts)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "tick_count": {"description": "Ticks advanced when exists is true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "tick_hz": {"description": "Configured tick rate (default 20) when exists is true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.room.create", "script.room.leave", "script.room.status", "script.room.tick"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "script_room_join", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Join player to in-process room table.", "title": "Script Room Join", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_full": "Seat cap reached — leave players or create another room_name", "room_name_required": "params.room_name required", "room_not_found": "script.room.create first — join does not create rooms", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "wallet_user_required": "MCP session user_id required — params.user_id cannot impersonate", "workflow_scope_leak": "params.user_id must match session user_id — body cannot override principal"}, "when_not_to_use": "Not account provisioning — requires wallet user_id; room must exist (script.room.create).", "when_to_use": "Join authenticated operator to in-process room table (mcp_write). Uses MCP context user_id; params.user_id must match or be omitted (no defineRoom — rooms are script.room.* only).", "write_mode": null}, {"action": "script.room.leave", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.room.leave", "mutation_risk": "low", "related_tools": ["script.room.join", "script.room.status", "script.room.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Script Room Leave", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name required", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "wallet_user_required": "MCP session user_id required — params.user_id cannot impersonate", "workflow_scope_leak": "params.user_id must match session user_id — body cannot override principal"}, "when_to_use": "Remove authenticated operator seat from in-process room table; empty rooms close (GC / room_table_full relief). Not rooms.leave quick-match — use script.room.* for StackScript lobby smoke."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.room.leave", "mutation_risk": "low", "related_tools": ["script.room.join", "script.room.status", "script.room.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Script Room Leave", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name required", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "wallet_user_required": "MCP session user_id required — params.user_id cannot impersonate", "workflow_scope_leak": "params.user_id must match session user_id — body cannot override principal"}, "when_to_use": "Remove authenticated operator seat from in-process room table; empty rooms close (GC / room_table_full relief). Not rooms.leave quick-match — use script.room.* for StackScript lobby smoke."}, "do_not_use_when": "Not quick-match lifecycle — use rooms.leave for QM seats; idempotent when room already gone.", "domain": "script", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name required", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "wallet_user_required": "MCP session user_id required — params.user_id cannot impersonate", "workflow_scope_leak": "params.user_id must match session user_id — body cannot override principal"}, "execution_class": "cheap", "instruction_hint": "Remove authenticated operator seat from in-process room table; empty rooms close (GC / room_table_f…", "language": "typescript", "mutation_kind": "entity", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"closed": {"description": "True when the room row was removed because player_count reached zero", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "error": {"description": "Machine error code when ok is false", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "exists": {"description": "False when no in-process room for project_id:name", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "instruction_slice": {"description": "Optional operator hints from enrich_stackscript_instruction_slice", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "language": {"description": "Always typescript for script.put sources (TS subset, not JSON logic)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "last_tick_at": {"description": "Unix timestamp of last successful tick when exists is true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "left": {"description": "True when the session user was removed from the seat set (or room already gone)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "name": {"description": "Room name (params.room_name or name)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "ok": {"description": "True when the service operation completed successfully", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "player_count": {"description": "Joined user_ids count when exists is true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "project_id": {"description": "Project scope for the room table key", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "script_id": {"description": "StackScript identifier in project scope", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "source_file_extension": {"description": "Use .ts paths in files[] (e.g. main.ts)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "tick_count": {"description": "Ticks advanced when exists is true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "tick_hz": {"description": "Configured tick rate (default 20) when exists is true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.room.join", "script.room.status", "script.room.create"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "script_room_leave", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Leave in-process StackScript room seat; empty rooms close.", "title": "Script Room Leave", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name required", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "wallet_user_required": "MCP session user_id required — params.user_id cannot impersonate", "workflow_scope_leak": "params.user_id must match session user_id — body cannot override principal"}, "when_not_to_use": "Not quick-match lifecycle — use rooms.leave for QM seats; idempotent when room already gone.", "when_to_use": "Remove authenticated operator seat from in-process room table; empty rooms close (GC / room_table_full relief). Not rooms.leave quick-match — use script.room.* for StackScript lobby smoke.", "write_mode": null}, {"action": "script.room.tick", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.room.tick", "mutation_risk": "low", "related_tools": ["script.room.status", "script.publish", "script.get", "script.profile"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Script Room Tick", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Live SSBC unreadable — script.recompile_version or script.put on host script", "bytecode_stale": "Live SSBC compiler_version mismatch — script.recompile_version before script.room.tick", "commit_failed": "DNA commit failed after VM — retry same tick idempotency key or dna.replay", "db_unavailable": "Postgres blip — retry same tick idempotency key after pool healthy", "dna_path_binding_invalid": "Path binding has characters outside [A-Za-z0-9_.:-] — shorten room_name", "dna_path_binding_missing": "Room export DNA path uses $matchId or $room_id but tick input has no binding", "dna_prefetch_failed": "DNA prefetch before room tick failed — narrow read_paths on defineRoom export", "dna_repair_pending": "Prior room tick left dna_repair_path — stackscript.dna.replay before next tick", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "rate_limited": "ok with skipped:true — wait until last_tick_at + 1/tick_hz or poll script.room.status", "read_paths_prefetch_exceeded": "Too many read_paths on room export — split DNA reads across smaller exports", "revision_conflict": "Runtime revision moved. Retry script.room.tick with the same idempotency room:{pid}:{room_name}:{tick}. Do not script.run the room export.", "revision_prefetch_failed": "Runtime revision leaf probe failed before tick VM — fix project DNA slice / room bind; transient pool errors return db_unavailable with same idempotency key", "revision_required": "Reserved for non–room_host commits. script.room.tick uses caller_kind=room_host: prefetched revision_gate + in-txn CAS — clients do not pass expected_revision on ticks. Co-op / player turns use script.run with input.expected_revision instead.", "room_host_run_failed": "Room VM tick failed — see diagnostics and fuel_used", "room_name_required": "params.room_name required", "room_not_bound": "No live defineRoom export — script.put + script.publish live with kind=room or script.room.create with matching room_name", "room_not_found": "script.room.create first — tick does not create the room", "run_in_progress": "Concurrent retry for same tick — idempotency room:{pid}:{room_name}:{tick}; wait retry_after_ms", "run_lock_timeout": "Concurrent tick for same idempotency key — wait retry_after_ms or use room:{pid}:{name}:{tick}", "run_timeout": "Room tick VM exceeded STACKSCRIPT_ROOM_TICK_VM_SEC (default 2s) — shrink onTick", "script_not_found": "room host script_id missing from index — script.publish live after defineRoom", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_fuel_quota_exceeded": "Monthly fuel cap exceeded — top up or lower tick_hz", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "Legacy SSBC dispatch layout — script.recompile_version off the room tick hot path", "tick_failed": "Unexpected tick failure — room missing returns room_not_found (not ok:false skip)", "wallet_commit_failed": "Room tick ledger step failed — stackscript.wallet.replay with wallet_repair_path or retry tick after balances fixed", "wallet_insufficient_funds": "Top up commerce wallet before wallet.debit in room onTick export", "wallet_partial_state": "Room tick ledger partial — stackscript.wallet.replay before next script.room.tick", "wallet_user_required": "MCP session must include operator user_id for room tick wallet caps"}, "when_to_use": "Server authority tick (≤20 Hz), not a client frame — commits the live defineRoom export. Clients send inputs via script.run; do not write the board over relay. idempotency_key room:{pid}:{room_name}:{"}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.room.tick", "mutation_risk": "low", "related_tools": ["script.room.status", "script.publish", "script.get", "script.profile"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Script Room Tick", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Live SSBC unreadable — script.recompile_version or script.put on host script", "bytecode_stale": "Live SSBC compiler_version mismatch — script.recompile_version before script.room.tick", "commit_failed": "DNA commit failed after VM — retry same tick idempotency key or dna.replay", "db_unavailable": "Postgres blip — retry same tick idempotency key after pool healthy", "dna_path_binding_invalid": "Path binding has characters outside [A-Za-z0-9_.:-] — shorten room_name", "dna_path_binding_missing": "Room export DNA path uses $matchId or $room_id but tick input has no binding", "dna_prefetch_failed": "DNA prefetch before room tick failed — narrow read_paths on defineRoom export", "dna_repair_pending": "Prior room tick left dna_repair_path — stackscript.dna.replay before next tick", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "rate_limited": "ok with skipped:true — wait until last_tick_at + 1/tick_hz or poll script.room.status", "read_paths_prefetch_exceeded": "Too many read_paths on room export — split DNA reads across smaller exports", "revision_conflict": "Runtime revision moved. Retry script.room.tick with the same idempotency room:{pid}:{room_name}:{tick}. Do not script.run the room export.", "revision_prefetch_failed": "Runtime revision leaf probe failed before tick VM — fix project DNA slice / room bind; transient pool errors return db_unavailable with same idempotency key", "revision_required": "Reserved for non–room_host commits. script.room.tick uses caller_kind=room_host: prefetched revision_gate + in-txn CAS — clients do not pass expected_revision on ticks. Co-op / player turns use script.run with input.expected_revision instead.", "room_host_run_failed": "Room VM tick failed — see diagnostics and fuel_used", "room_name_required": "params.room_name required", "room_not_bound": "No live defineRoom export — script.put + script.publish live with kind=room or script.room.create with matching room_name", "room_not_found": "script.room.create first — tick does not create the room", "run_in_progress": "Concurrent retry for same tick — idempotency room:{pid}:{room_name}:{tick}; wait retry_after_ms", "run_lock_timeout": "Concurrent tick for same idempotency key — wait retry_after_ms or use room:{pid}:{name}:{tick}", "run_timeout": "Room tick VM exceeded STACKSCRIPT_ROOM_TICK_VM_SEC (default 2s) — shrink onTick", "script_not_found": "room host script_id missing from index — script.publish live after defineRoom", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_fuel_quota_exceeded": "Monthly fuel cap exceeded — top up or lower tick_hz", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "Legacy SSBC dispatch layout — script.recompile_version off the room tick hot path", "tick_failed": "Unexpected tick failure — room missing returns room_not_found (not ok:false skip)", "wallet_commit_failed": "Room tick ledger step failed — stackscript.wallet.replay with wallet_repair_path or retry tick after balances fixed", "wallet_insufficient_funds": "Top up commerce wallet before wallet.debit in room onTick export", "wallet_partial_state": "Room tick ledger partial — stackscript.wallet.replay before next script.room.tick", "wallet_user_required": "MCP session must include operator user_id for room tick wallet caps"}, "when_to_use": "Server authority tick (≤20 Hz), not a client frame — commits the live defineRoom export. Clients send inputs via script.run; do not write the board over relay. idempotency_key room:{pid}:{room_name}:{"}, "do_not_use_when": "Not cron/scheduler — client must poll; not write-set preview — script.dry_run. Unbound room_name fails closed with room_not_bound (no ok:true skip).", "domain": "script", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Live SSBC unreadable — script.recompile_version or script.put on host script", "bytecode_stale": "Live SSBC compiler_version mismatch — script.recompile_version before script.room.tick", "commit_failed": "DNA commit failed after VM — retry same tick idempotency key or dna.replay", "db_unavailable": "Postgres blip — retry same tick idempotency key after pool healthy", "dna_path_binding_invalid": "Path binding has characters outside [A-Za-z0-9_.:-] — shorten room_name", "dna_path_binding_missing": "Room export DNA path uses $matchId or $room_id but tick input has no binding", "dna_prefetch_failed": "DNA prefetch before room tick failed — narrow read_paths on defineRoom export", "dna_repair_pending": "Prior room tick left dna_repair_path — stackscript.dna.replay before next tick", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "rate_limited": "ok with skipped:true — wait until last_tick_at + 1/tick_hz or poll script.room.status", "read_paths_prefetch_exceeded": "Too many read_paths on room export — split DNA reads across smaller exports", "revision_conflict": "Runtime revision moved. Retry script.room.tick with the same idempotency room:{pid}:{room_name}:{tick}. Do not script.run the room export.", "revision_prefetch_failed": "Runtime revision leaf probe failed before tick VM — fix project DNA slice / room bind; transient pool errors return db_unavailable with same idempotency key", "revision_required": "Reserved for non–room_host commits. script.room.tick uses caller_kind=room_host: prefetched revision_gate + in-txn CAS — clients do not pass expected_revision on ticks. Co-op / player turns use script.run with input.expected_revision instead.", "room_host_run_failed": "Room VM tick failed — see diagnostics and fuel_used", "room_name_required": "params.room_name required", "room_not_bound": "No live defineRoom export — script.put + script.publish live with kind=room or script.room.create with matching room_name", "room_not_found": "script.room.create first — tick does not create the room", "run_in_progress": "Concurrent retry for same tick — idempotency room:{pid}:{room_name}:{tick}; wait retry_after_ms", "run_lock_timeout": "Concurrent tick for same idempotency key — wait retry_after_ms or use room:{pid}:{name}:{tick}", "run_timeout": "Room tick VM exceeded STACKSCRIPT_ROOM_TICK_VM_SEC (default 2s) — shrink onTick", "script_not_found": "room host script_id missing from index — script.publish live after defineRoom", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_fuel_quota_exceeded": "Monthly fuel cap exceeded — top up or lower tick_hz", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "Legacy SSBC dispatch layout — script.recompile_version off the room tick hot path", "tick_failed": "Unexpected tick failure — room missing returns room_not_found (not ok:false skip)", "wallet_commit_failed": "Room tick ledger step failed — stackscript.wallet.replay with wallet_repair_path or retry tick after balances fixed", "wallet_insufficient_funds": "Top up commerce wallet before wallet.debit in room onTick export", "wallet_partial_state": "Room tick ledger partial — stackscript.wallet.replay before next script.room.tick", "wallet_user_required": "MCP session must include operator user_id for room tick wallet caps"}, "execution_class": "cheap", "instruction_hint": "Server authority tick (≤20 Hz), not a client frame — commits the live defineRoom export. Clients se…", "language": "typescript", "mutation_kind": "entity", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"dna_committed": {"description": "True when write_set applied to production DNA", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "dna_persisted": {"description": "False while neural-staged only; True after full PG commit", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "error": {"description": "Machine error code when ok is false", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "fuel_used": {"description": "VM fuel consumed on room_host tick (when room_host_bound)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "idempotency_key": {"description": "Derived room:{project_id}:{room_name}:{tick} on DNA commit path", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "idempotent_replay": {"description": "True when tick idempotency matched prior commit", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "instruction_hint": {"description": "When skipped — operator copy from when_blocked rate_limited", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "instruction_slice": {"description": "Optional operator hints from enrich_stackscript_instruction_slice", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "language": {"description": "Always typescript for script.put sources (TS subset, not JSON logic)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "ok": {"description": "True when the service operation completed successfully", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "reason": {"description": "rate_limited when skipped is true — honor tick_hz; poll script.room.status", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "relay_events_sent": {"description": "QM relay WS hints fan-out count when VM emitted events", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "room_host_bound": {"description": "True when invoke_room_tick ran bound defineRoom export", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "room_host_error": {"description": "Removed — unbound defineRoom is error_code room_not_bound (ok false)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "room_host_value": {"description": "defineRoom export return payload value when bound", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "runtime_neural_staged": {"description": "True when room_host runtime leaves are L1-hot; PG flush debounced (timings.neural_defer=true)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "script_id": {"description": "StackScript identifier in project scope", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "skipped": {"description": "True when tick was rate-limited (ok still true)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "source_file_extension": {"description": "Use .ts paths in files[] (e.g. main.ts)", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "tick": {"description": "Monotonic tick counter when tick advanced; absent when skipped:true", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "timings": {"description": "Phase ms: vm_ms, commit_ms; hosted adds neural_defer, neural_flush_backlog, neural_pending_paths when present", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "vm_ms": {"description": "VM wall time ms from timings.vm_ms on successful tick", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}, "write_set_applied": {"description": "Count of DNA paths applied on tick commit", "type": ["string", "number", "integer", "boolean", "object", "array", "null"]}}, "type": "object"}, "error": {"description": "Error message if operation failed", "type": ["string", "null"]}, "error_code": {"description": "Error code for programmatic error handling", "type": ["string", "null"]}, "execution_time_ms": {"description": "Execution time in milliseconds", "type": ["number", "null"]}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "type": ["string", "null"]}}, "type": "object"}, "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.room.status", "script.publish", "script.get", "script.profile"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "script_room_tick", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Advance one room tick (≤20 Hz) and commit bound defineRoom export (idempotency room:{pid}:{room_name}:{tick}).", "title": "Script Room Tick", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Live SSBC unreadable — script.recompile_version or script.put on host script", "bytecode_stale": "Live SSBC compiler_version mismatch — script.recompile_version before script.room.tick", "commit_failed": "DNA commit failed after VM — retry same tick idempotency key or dna.replay", "db_unavailable": "Postgres blip — retry same tick idempotency key after pool healthy", "dna_path_binding_invalid": "Path binding has characters outside [A-Za-z0-9_.:-] — shorten room_name", "dna_path_binding_missing": "Room export DNA path uses $matchId or $room_id but tick input has no binding", "dna_prefetch_failed": "DNA prefetch before room tick failed — narrow read_paths on defineRoom export", "dna_repair_pending": "Prior room tick left dna_repair_path — stackscript.dna.replay before next tick", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "rate_limited": "ok with skipped:true — wait until last_tick_at + 1/tick_hz or poll script.room.status", "read_paths_prefetch_exceeded": "Too many read_paths on room export — split DNA reads across smaller exports", "revision_conflict": "Runtime revision moved. Retry script.room.tick with the same idempotency room:{pid}:{room_name}:{tick}. Do not script.run the room export.", "revision_prefetch_failed": "Runtime revision leaf probe failed before tick VM — fix project DNA slice / room bind; transient pool errors return db_unavailable with same idempotency key", "revision_required": "Reserved for non–room_host commits. script.room.tick uses caller_kind=room_host: prefetched revision_gate + in-txn CAS — clients do not pass expected_revision on ticks. Co-op / player turns use script.run with input.expected_revision instead.", "room_host_run_failed": "Room VM tick failed — see diagnostics and fuel_used", "room_name_required": "params.room_name required", "room_not_bound": "No live defineRoom export — script.put + script.publish live with kind=room or script.room.create with matching room_name", "room_not_found": "script.room.create first — tick does not create the room", "run_in_progress": "Concurrent retry for same tick — idempotency room:{pid}:{room_name}:{tick}; wait retry_after_ms", "run_lock_timeout": "Concurrent tick for same idempotency key — wait retry_after_ms or use room:{pid}:{name}:{tick}", "run_timeout": "Room tick VM exceeded STACKSCRIPT_ROOM_TICK_VM_SEC (default 2s) — shrink onTick", "script_not_found": "room host script_id missing from index — script.publish live after defineRoom", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_fuel_quota_exceeded": "Monthly fuel cap exceeded — top up or lower tick_hz", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "Legacy SSBC dispatch layout — script.recompile_version off the room tick hot path", "tick_failed": "Unexpected tick failure — room missing returns room_not_found (not ok:false skip)", "wallet_commit_failed": "Room tick ledger step failed — stackscript.wallet.replay with wallet_repair_path or retry tick after balances fixed", "wallet_insufficient_funds": "Top up commerce wallet before wallet.debit in room onTick export", "wallet_partial_state": "Room tick ledger partial — stackscript.wallet.replay before next script.room.tick", "wallet_user_required": "MCP session must include operator user_id for room tick wallet caps"}, "when_not_to_use": "Not cron/scheduler — client must poll; not write-set preview — script.dry_run. Unbound room_name fails closed with room_not_bound (no ok:true skip).", "when_to_use": "Server authority tick (≤20 Hz), not a client frame — commits the live defineRoom export. Clients send inputs via script.run; do not write the board over relay. idempotency_key room:{pid}:{room_name}:{", "write_mode": null}, {"action": "stackscript.fuel.quote", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1"], "id": "stackscript.fuel.quote", "mutation_risk": "low", "related_tools": ["stackscript.fuel.purchase", "finance.pay.execute", "script.profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stackscript Fuel Quote", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "buyer_mismatch": "buyer_user_id must match the MCP session user_id", "fuel_units_invalid": "fuel_units must be a positive integer", "invalid_parameters": "Check fuel_units (positive integer) and context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id"}, "when_to_use": "Quote prepaid StackScript VM fuel (ecosystem.metrics prepaid balance) — not LLM compute_credits. Pair with finance.pay intent stackscript_fuel_pack or stackscript.fuel.purchase after settlement."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1"], "id": "stackscript.fuel.quote", "mutation_risk": "low", "related_tools": ["stackscript.fuel.purchase", "finance.pay.execute", "script.profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stackscript Fuel Quote", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "buyer_mismatch": "buyer_user_id must match the MCP session user_id", "fuel_units_invalid": "fuel_units must be a positive integer", "invalid_parameters": "Check fuel_units (positive integer) and context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id"}, "when_to_use": "Quote prepaid StackScript VM fuel (ecosystem.metrics prepaid balance) — not LLM compute_credits. Pair with finance.pay intent stackscript_fuel_pack or stackscript.fuel.purchase after settlement."}, "do_not_use_when": "Quote only — does not grant fuel; stackscript.fuel.purchase or finance.pay after quote.", "domain": "stackscript", "domain_title": "Stackscript MCP domain", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Tariff + buffs + prepaid balance preview — no wallet debit", "effect_depends_on_params": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "buyer_mismatch": "buyer_user_id must match the MCP session user_id", "fuel_units_invalid": "fuel_units must be a positive integer", "invalid_parameters": "Check fuel_units (positive integer) and context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.stackscript.gen1"], "instruction_hint": "Quote prepaid StackScript VM fuel (ecosystem.metrics prepaid balance) — not LLM compute_credits. Pa…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.stackscript", "owner_gene": "core.mcp.stackscript.gen1", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_stackscript"], "related_tools": ["stackscript.fuel.purchase", "finance.pay.execute", "script.profile"], "required_cap": "stackscript_read", "requires_preflight": false, "risk_class": "read", "safe_action": "stackscript_fuel_quote", "semantic_input_mode": "inherit_workflow", "summary": "Quote a StackScript fuel top-up pack (prepaid VM fuel, not LLM compute credits).", "title": "Stackscript Fuel Quote", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "buyer_mismatch": "buyer_user_id must match the MCP session user_id", "fuel_units_invalid": "fuel_units must be a positive integer", "invalid_parameters": "Check fuel_units (positive integer) and context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id"}, "when_not_to_use": "Quote only — does not grant fuel; stackscript.fuel.purchase or finance.pay after quote.", "when_to_use": "Quote prepaid StackScript VM fuel (ecosystem.metrics prepaid balance) — not LLM compute_credits. Pair with finance.pay intent stackscript_fuel_pack or stackscript.fuel.purchase after settlement.", "write_mode": null}, {"action": "stackscript.fuel.purchase", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1"], "id": "stackscript.fuel.purchase", "mutation_risk": "low", "related_tools": ["stackscript.fuel.quote", "script.profile", "buffs.get_effective_limits"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stackscript Fuel Purchase", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "buyer_mismatch": "buyer_user_id must match the MCP session user_id and the quote buyer", "fuel_grant_failed": "Quote consumed but prepaid grant failed — support with quote_id", "fuel_units_mismatch": "fuel_units must match quoted pack size", "invalid_parameters": "Pass quote_id, quote_hash, and fuel_units from stackscript.fuel.quote", "project_id_mismatch": "quote project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "quote_expired": "Re-run stackscript.fuel.quote", "quote_hash_mismatch": "Pass quote_hash from stackscript.fuel.quote response", "quote_not_found": "Re-run stackscript.fuel.quote — quote expired or wrong worker"}, "when_to_use": "Grant quoted fuel_units to prepaid balance — prefer finance.pay.execute with intent stackscript_fuel_pack; use this when wallet/card rail already settled."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1"], "id": "stackscript.fuel.purchase", "mutation_risk": "low", "related_tools": ["stackscript.fuel.quote", "script.profile", "buffs.get_effective_limits"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stackscript Fuel Purchase", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "buyer_mismatch": "buyer_user_id must match the MCP session user_id and the quote buyer", "fuel_grant_failed": "Quote consumed but prepaid grant failed — support with quote_id", "fuel_units_mismatch": "fuel_units must match quoted pack size", "invalid_parameters": "Pass quote_id, quote_hash, and fuel_units from stackscript.fuel.quote", "project_id_mismatch": "quote project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "quote_expired": "Re-run stackscript.fuel.quote", "quote_hash_mismatch": "Pass quote_hash from stackscript.fuel.quote response", "quote_not_found": "Re-run stackscript.fuel.quote — quote expired or wrong worker"}, "when_to_use": "Grant quoted fuel_units to prepaid balance — prefer finance.pay.execute with intent stackscript_fuel_pack; use this when wallet/card rail already settled."}, "do_not_use_when": "Not for monthly tier upgrade — buffs/commerce rails; quote first via stackscript.fuel.quote.", "domain": "stackscript", "domain_title": "Stackscript MCP domain", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Commerce rail top-up for VM fuel — mutates wallet; use stackscript.fuel.quote before purchase in agent loops", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "buyer_mismatch": "buyer_user_id must match the MCP session user_id and the quote buyer", "fuel_grant_failed": "Quote consumed but prepaid grant failed — support with quote_id", "fuel_units_mismatch": "fuel_units must match quoted pack size", "invalid_parameters": "Pass quote_id, quote_hash, and fuel_units from stackscript.fuel.quote", "project_id_mismatch": "quote project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "quote_expired": "Re-run stackscript.fuel.quote", "quote_hash_mismatch": "Pass quote_hash from stackscript.fuel.quote response", "quote_not_found": "Re-run stackscript.fuel.quote — quote expired or wrong worker"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.stackscript.gen1"], "instruction_hint": "Grant quoted fuel_units to prepaid balance — prefer finance.pay.execute with intent stackscript_fue…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.stackscript", "owner_gene": "core.mcp.stackscript.gen1", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_stackscript"], "related_tools": ["stackscript.fuel.quote", "script.profile", "buffs.get_effective_limits"], "required_cap": "stackscript_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "stackscript_fuel_purchase", "semantic_input_mode": "inherit_workflow", "summary": "Apply a quoted StackScript fuel pack to project prepaid balance.", "title": "Stackscript Fuel Purchase", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "buyer_mismatch": "buyer_user_id must match the MCP session user_id and the quote buyer", "fuel_grant_failed": "Quote consumed but prepaid grant failed — support with quote_id", "fuel_units_mismatch": "fuel_units must match quoted pack size", "invalid_parameters": "Pass quote_id, quote_hash, and fuel_units from stackscript.fuel.quote", "project_id_mismatch": "quote project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "quote_expired": "Re-run stackscript.fuel.quote", "quote_hash_mismatch": "Pass quote_hash from stackscript.fuel.quote response", "quote_not_found": "Re-run stackscript.fuel.quote — quote expired or wrong worker"}, "when_not_to_use": "Not for monthly tier upgrade — buffs/commerce rails; quote first via stackscript.fuel.quote.", "when_to_use": "Grant quoted fuel_units to prepaid balance — prefer finance.pay.execute with intent stackscript_fuel_pack; use this when wallet/card rail already settled.", "write_mode": null}, {"action": "stackscript.wallet.replay", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "stackscript.wallet.replay", "mutation_risk": "low", "related_tools": ["script.run", "script.profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stackscript Wallet Replay", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "ledger_apply_failed": "Ledger still rejected wallet_ops — fix balances then retry", "project_id_mismatch": "Repair leaf project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "repair_not_found": "Pass wallet_repair_path from legacy script.run wallet_commit_failed response", "repair_not_pending": "Leaf status is not pending — may already be completed", "wallet_commit_failed": "Ledger rejected ops — inspect commerce ledger", "wallet_insufficient_funds": "Top up balances before replaying wallet_ops", "wallet_replay_failed": "Repair leaf has no wallet_ops to replay", "wallet_user_required": "Repair row missing user_id — replay with operator session"}, "when_to_use": "Legacy only: replay wallet_ops from wallet_repair_path when that leaf exists. Ledger-first script.run does not enqueue wallet repair — use script.profile + retry."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "stackscript.wallet.replay", "mutation_risk": "low", "related_tools": ["script.run", "script.profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stackscript Wallet Replay", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "ledger_apply_failed": "Ledger still rejected wallet_ops — fix balances then retry", "project_id_mismatch": "Repair leaf project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "repair_not_found": "Pass wallet_repair_path from legacy script.run wallet_commit_failed response", "repair_not_pending": "Leaf status is not pending — may already be completed", "wallet_commit_failed": "Ledger rejected ops — inspect commerce ledger", "wallet_insufficient_funds": "Top up balances before replaying wallet_ops", "wallet_replay_failed": "Repair leaf has no wallet_ops to replay", "wallet_user_required": "Repair row missing user_id — replay with operator session"}, "when_to_use": "Legacy only: replay wallet_ops from wallet_repair_path when that leaf exists. Ledger-first script.run does not enqueue wallet repair — use script.profile + retry."}, "do_not_use_when": "Only when script.run returned wallet_repair_path — not for normal script.run recovery.", "domain": "stackscript", "domain_title": "Stackscript MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "ledger_apply_failed": "Ledger still rejected wallet_ops — fix balances then retry", "project_id_mismatch": "Repair leaf project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "repair_not_found": "Pass wallet_repair_path from legacy script.run wallet_commit_failed response", "repair_not_pending": "Leaf status is not pending — may already be completed", "wallet_commit_failed": "Ledger rejected ops — inspect commerce ledger", "wallet_insufficient_funds": "Top up balances before replaying wallet_ops", "wallet_replay_failed": "Repair leaf has no wallet_ops to replay", "wallet_user_required": "Repair row missing user_id — replay with operator session"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.stackscript.gen1"], "instruction_hint": "Legacy only: replay wallet_ops from wallet_repair_path when that leaf exists. Ledger-first script.r…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.stackscript", "owner_gene": "core.mcp.stackscript.gen1", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_stackscript"], "related_tools": ["script.run", "script.profile"], "required_cap": "stackscript_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "stackscript_wallet_replay", "semantic_input_mode": "inherit_workflow", "summary": "Replay pending wallet_ops from a wallet_repair DNA leaf after script.run wallet_commit_failed.", "title": "Stackscript Wallet Replay", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "ledger_apply_failed": "Ledger still rejected wallet_ops — fix balances then retry", "project_id_mismatch": "Repair leaf project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "repair_not_found": "Pass wallet_repair_path from legacy script.run wallet_commit_failed response", "repair_not_pending": "Leaf status is not pending — may already be completed", "wallet_commit_failed": "Ledger rejected ops — inspect commerce ledger", "wallet_insufficient_funds": "Top up balances before replaying wallet_ops", "wallet_replay_failed": "Repair leaf has no wallet_ops to replay", "wallet_user_required": "Repair row missing user_id — replay with operator session"}, "when_not_to_use": "Only when script.run returned wallet_repair_path — not for normal script.run recovery.", "when_to_use": "Legacy only: replay wallet_ops from wallet_repair_path when that leaf exists. Ledger-first script.run does not enqueue wallet repair — use script.profile + retry.", "write_mode": null}, {"action": "stackscript.dna.replay", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "stackscript.dna.replay", "mutation_risk": "low", "related_tools": ["script.run", "script.profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stackscript Dna Replay", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "db_unavailable": "Retry after retry_after_ms — DNA repair leaf read hit a pool blip", "dna_replay_failed": "Repair leaf has no write_set to replay", "project_id_mismatch": "Repair leaf project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "repair_not_found": "Pass dna_repair_path from script.run commit_failed response", "repair_not_pending": "Leaf status is not pending — may already be completed"}, "when_to_use": "After script.run commit_failed when ledger already applied — replay write_set from dna_repair_path leaf (no wallet ops). Then script.profile and retry script.run with a new idempotency_key if needed."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "stackscript.dna.replay", "mutation_risk": "low", "related_tools": ["script.run", "script.profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stackscript Dna Replay", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "db_unavailable": "Retry after retry_after_ms — DNA repair leaf read hit a pool blip", "dna_replay_failed": "Repair leaf has no write_set to replay", "project_id_mismatch": "Repair leaf project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "repair_not_found": "Pass dna_repair_path from script.run commit_failed response", "repair_not_pending": "Leaf status is not pending — may already be completed"}, "when_to_use": "After script.run commit_failed when ledger already applied — replay write_set from dna_repair_path leaf (no wallet ops). Then script.profile and retry script.run with a new idempotency_key if needed."}, "do_not_use_when": "Only when commit_failed / db_unavailable returned dna_repair_path — not for routine edits (projects.patch_data / generation cycle).", "domain": "stackscript", "domain_title": "Stackscript MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "db_unavailable": "Retry after retry_after_ms — DNA repair leaf read hit a pool blip", "dna_replay_failed": "Repair leaf has no write_set to replay", "project_id_mismatch": "Repair leaf project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "repair_not_found": "Pass dna_repair_path from script.run commit_failed response", "repair_not_pending": "Leaf status is not pending — may already be completed"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.stackscript.gen1"], "instruction_hint": "After script.run commit_failed when ledger already applied — replay write_set from dna_repair_path …", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.stackscript", "owner_gene": "core.mcp.stackscript.gen1", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_stackscript"], "related_tools": ["script.run", "script.profile"], "required_cap": "stackscript_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "stackscript_dna_replay", "semantic_input_mode": "inherit_workflow", "summary": "Replay pending write_set from a dna_repair DNA leaf after script.run commit_failed.", "title": "Stackscript Dna Replay", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "db_unavailable": "Retry after retry_after_ms — DNA repair leaf read hit a pool blip", "dna_replay_failed": "Repair leaf has no write_set to replay", "project_id_mismatch": "Repair leaf project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "repair_not_found": "Pass dna_repair_path from script.run commit_failed response", "repair_not_pending": "Leaf status is not pending — may already be completed"}, "when_not_to_use": "Only when commit_failed / db_unavailable returned dna_repair_path — not for routine edits (projects.patch_data / generation cycle).", "when_to_use": "After script.run commit_failed when ledger already applied — replay write_set from dna_repair_path leaf (no wallet ops). Then script.profile and retry script.run with a new idempotency_key if needed.", "write_mode": null}, {"action": "services.diagnostic_sow_draft", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "services", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.services.gen1"], "id": "services.diagnostic_sow_draft", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Services Diagnostic Sow Draft", "when_blocked": {"persist_failed": "CRM activity append failed after SoW render", "sku_required": "sku parameter required", "unknown_sku": "SKU not in public services catalog"}, "when_to_use": "Staff kickoff after guest POST /api/public/services/inquiry (202, notify_pending). Draft diagnostic SoW; optional contact_id from inquiry response."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "services", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.services.gen1"], "id": "services.diagnostic_sow_draft", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Services Diagnostic Sow Draft", "when_blocked": {"persist_failed": "CRM activity append failed after SoW render", "sku_required": "sku parameter required", "unknown_sku": "SKU not in public services catalog"}, "when_to_use": "Staff kickoff after guest POST /api/public/services/inquiry (202, notify_pending). Draft diagnostic SoW; optional contact_id from inquiry response."}, "do_not_use_when": "Guest lead capture — use POST /api/public/services/inquiry (202), not this tool.", "domain": "services", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"persist_failed": "CRM activity append failed after SoW render", "sku_required": "sku parameter required", "unknown_sku": "SKU not in public services catalog"}, "execution_class": "plain_read", "genetic_tag": "frontend.public.services_offers.gen1", "instruction_hint": "Staff kickoff after guest POST /api/public/services/inquiry (202, notify_pending). Draft diagnostic…", "mutation_kind": "none", "next_actions": ["crm.get_contact_360", "services.kickoff_slot_status", "GET /api/public/services/kickoff-preflight"], "required_cap": "mcp_read", "requires_preflight": false, "rest_bridge": {"genetic_tag": "frontend.public.services_offers.gen1", "method": "POST", "response": "202", "rest_path": "/api/public/services/inquiry", "when_blocked": {"inquiry_unavailable": {"hint": "CRM persist failed — retry in a minute; do not double-charge kickoff.", "next": "GET /api/public/services/catalog"}, "rate_limit_exceeded": {"hint": "10 inquiries/hour per client — wait or email studio directly.", "next": "POST /api/public/services/inquiry"}, "unknown_sku": {"hint": "sku must match services_offers_v1 listed id (shop.enablement unrelated).", "next": "GET /api/public/services/catalog"}}, "when_to_use": "POST /api/public/services/inquiry — guest CRM lead (ecosystem pid=1). Returns 202 with inquiry_id + notify_pending; email/Telegram fan-out is async. Fields: sku (listed catalog id), name, email, message (≥10), optional company, locale, source (e.g. investors_portal, services_spa), format_pick. Honeypot: website non-empty → 202 accepted, no CRM. Errors: 400 unknown_sku, 422 validation, 429 rate_limit, 503 inquiry_unavailable. Not checkout — paid kickoff: GET /api/public/services/kickoff-preflight."}, "risk_class": "read", "safe_action": "services_diagnostic_sow_draft", "semantic_input_mode": "inherit_workflow", "summary": "Render a studio diagnostic (kickoff) SoW markdown from the services catalog fixture. Staff-only on ecosystem project 1.", "title": "Services Diagnostic Sow Draft", "when_blocked": {"persist_failed": "CRM activity append failed after SoW render", "sku_required": "sku parameter required", "unknown_sku": "SKU not in public services catalog"}, "when_not_to_use": "Guest lead capture — use POST /api/public/services/inquiry (202), not this tool.", "when_to_use": "Staff kickoff after guest POST /api/public/services/inquiry (202, notify_pending). Draft diagnostic SoW; optional contact_id from inquiry response.", "write_mode": null}, {"action": "services.kickoff_slot_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "services", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.services.gen1"], "id": "services.kickoff_slot_status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Services Kickoff Slot Status", "when_blocked": {"validation_failed": "sku and contact_id required"}, "when_to_use": "Preflight kickoff slot/buff state before scheduling or applying delivery."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "services", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.services.gen1"], "id": "services.kickoff_slot_status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Services Kickoff Slot Status", "when_blocked": {"validation_failed": "sku and contact_id required"}, "when_to_use": "Preflight kickoff slot/buff state before scheduling or applying delivery."}, "domain": "services", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"validation_failed": "sku and contact_id required"}, "execution_class": "plain_read", "genetic_tag": "frontend.public.services_offers.gen1", "instruction_hint": "Preflight kickoff slot/buff state before scheduling or applying delivery.", "mutation_kind": "none", "required_cap": "mcp_read", "requires_preflight": false, "rest_bridge": {"method": "GET", "rest_path": "/api/public/services/kickoff-preflight", "when_to_use": "Guest-visible kickoff gate — same preflight as SPA after inquiry."}, "risk_class": "read", "safe_action": "services_kickoff_slot_status", "semantic_input_mode": "inherit_workflow", "summary": "Read kickoff slot status for CRM contact (optional payer user buff merge).", "title": "Services Kickoff Slot Status", "when_blocked": {"validation_failed": "sku and contact_id required"}, "when_to_use": "Preflight kickoff slot/buff state before scheduling or applying delivery.", "write_mode": null}, {"action": "services.apply_delivery_slot", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "services", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.services.gen1"], "id": "services.apply_delivery_slot", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Services Apply Delivery Slot", "when_blocked": {"apply_failed": "delivery slot grant failed", "unknown_sku": "SKU not in catalog", "validation_failed": "head_project_id and sku required"}, "when_to_use": "After signed SoW — reserve phase-1 delivery slot on tenant head project."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "services", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.services.gen1"], "id": "services.apply_delivery_slot", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Services Apply Delivery Slot", "when_blocked": {"apply_failed": "delivery slot grant failed", "unknown_sku": "SKU not in catalog", "validation_failed": "head_project_id and sku required"}, "when_to_use": "After signed SoW — reserve phase-1 delivery slot on tenant head project."}, "domain": "services", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"apply_failed": "delivery slot grant failed", "unknown_sku": "SKU not in catalog", "validation_failed": "head_project_id and sku required"}, "execution_class": "cheap", "genetic_tag": "frontend.public.services_offers.gen1", "instruction_hint": "After signed SoW — reserve phase-1 delivery slot on tenant head project.", "mutation_kind": "entity", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "services_apply_delivery_slot", "semantic_input_mode": "inherit_workflow", "summary": "Grant phase-1 studio delivery slot on tenant head project (data.ecosystem.buffs[] protected). After signed main SoW.", "title": "Services Apply Delivery Slot", "when_blocked": {"apply_failed": "delivery slot grant failed", "unknown_sku": "SKU not in catalog", "validation_failed": "head_project_id and sku required"}, "when_to_use": "After signed SoW — reserve phase-1 delivery slot on tenant head project.", "write_mode": null}, {"action": "time.log", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "time", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.time.gen1"], "id": "time.log", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Time Log", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Record billable or internal minutes on a deal or project."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "time", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.time.gen1"], "id": "time.log", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Time Log", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Record billable or internal minutes on a deal or project."}, "domain": "time", "domain_title": "Time MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.time.gen1"], "instruction_hint": "Record billable or internal minutes on a deal or project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.time", "owner_gene": "core.mcp.time.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "requires_preflight": false, "risk_class": "low_write", "safe_action": "time_log", "semantic_input_mode": "inherit_workflow", "summary": "Log a time entry (minutes) optionally linked to crm_deal.", "title": "Time Log", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Record billable or internal minutes on a deal or project.", "write_mode": null}, {"action": "time.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "time", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.time.gen1"], "id": "time.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Time List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit recent time logs before time.report."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "time", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.time.gen1"], "id": "time.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Time List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit recent time logs before time.report."}, "domain": "time", "domain_title": "Time MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.time.gen1"], "instruction_hint": "Audit recent time logs before time.report.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.time", "owner_gene": "core.mcp.time.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "requires_preflight": false, "risk_class": "read", "safe_action": "time_list", "semantic_input_mode": "inherit_workflow", "summary": "List recent time entries.", "title": "Time List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit recent time logs before time.report.", "write_mode": null}, {"action": "time.report", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "time", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.time.gen1"], "id": "time.report", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Time Report", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Summarize billable minutes for invoicing or goals.progress."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "time", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.time.gen1"], "id": "time.report", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Time Report", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Summarize billable minutes for invoicing or goals.progress."}, "domain": "time", "domain_title": "Time MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.time.gen1"], "instruction_hint": "Summarize billable minutes for invoicing or goals.progress.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.time", "owner_gene": "core.mcp.time.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "requires_preflight": false, "risk_class": "read", "safe_action": "time_report", "semantic_input_mode": "inherit_workflow", "summary": "Aggregate time report for project.", "title": "Time Report", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Summarize billable minutes for invoicing or goals.progress.", "write_mode": null}, {"action": "user.apikeys.create", "aliases": ["apikeys.create_user"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "user.apikeys.create", "mutation_risk": "low", "related_tools": ["user.apikeys.list", "user.apikeys.revoke", "apikeys.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "User Apikeys Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "limit_exceeded": "max_user_api_keys", "project_required": "agent PAT needs project_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user on the credential", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mint a user or agent PAT for REST/MCP. Prefer agent + agent_runner for Cursor."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "user.apikeys.create", "mutation_risk": "low", "related_tools": ["user.apikeys.list", "user.apikeys.revoke", "apikeys.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "User Apikeys Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "limit_exceeded": "max_user_api_keys", "project_required": "agent PAT needs project_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user on the credential", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mint a user or agent PAT for REST/MCP. Prefer agent + agent_runner for Cursor."}, "domain": "user", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"limit_exceeded": "max_user_api_keys", "project_required": "agent PAT needs project_id", "unauthorized": "No user on the credential"}, "execution_class": "cheap", "instruction_hint": "Mint a user or agent PAT for REST/MCP. Prefer agent + agent_runner for Cursor.", "mutation_kind": "entity", "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "related_tools": ["user.apikeys.list", "user.apikeys.revoke", "apikeys.create"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "user_apikeys_create", "semantic_input_mode": "inherit_workflow", "summary": "Create a personal AgentStack PAT on the signed-in user (ecosystem identity).", "title": "User Apikeys Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "limit_exceeded": "max_user_api_keys", "project_required": "agent PAT needs project_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user on the credential", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mint a user or agent PAT for REST/MCP. Prefer agent + agent_runner for Cursor.", "write_mode": null}, {"action": "user.apikeys.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "user.apikeys.list", "related_tools": ["user.apikeys.create", "user.apikeys.revoke"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "User Apikeys List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user on the credential", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit personal and agent PATs."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "user.apikeys.list", "related_tools": ["user.apikeys.create", "user.apikeys.revoke"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "User Apikeys List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user on the credential", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit personal and agent PATs."}, "domain": "user", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"unauthorized": "No user on the credential"}, "execution_class": "plain_read", "instruction_hint": "Audit personal and agent PATs.", "mutation_kind": "none", "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "related_tools": ["user.apikeys.create", "user.apikeys.revoke"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "user_apikeys_list", "semantic_input_mode": "inherit_workflow", "summary": "List personal PATs (metadata only). Optional project_id filters agent keys scoped to that project.", "title": "User Apikeys List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user on the credential", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit personal and agent PATs.", "write_mode": null}, {"action": "user.apikeys.revoke", "aliases": ["user.apikeys.delete"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "user.apikeys.revoke", "mutation_risk": "high", "related_tools": ["user.apikeys.create", "user.apikeys.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "User Apikeys Revoke", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_not_found": "Unknown key_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke a leaked or unused PAT."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "user.apikeys.revoke", "mutation_risk": "high", "related_tools": ["user.apikeys.create", "user.apikeys.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "User Apikeys Revoke", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_not_found": "Unknown key_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke a leaked or unused PAT."}, "domain": "user", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "errors": {"key_not_found": "Unknown key_id", "unauthorized": "No user"}, "execution_class": "cheap", "instruction_hint": "Revoke a leaked or unused PAT.", "mutation_kind": "entity", "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_tools": ["user.apikeys.create", "user.apikeys.list"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "user_apikeys_revoke", "semantic_input_mode": "inherit_workflow", "summary": "Revoke (soft-delete) a personal PAT by key_id.", "title": "User Apikeys Revoke", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_not_found": "Unknown key_id", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke a leaked or unused PAT.", "write_mode": null}, {"action": "user.apikeys.rotate", "aliases": ["apikeys.rotate"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "user.apikeys.rotate", "related_tools": ["user.apikeys.create", "user.apikeys.revoke"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "User Apikeys Rotate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_not_found": "Unknown key_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rotate a PAT without changing scope/caps."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "user.apikeys.rotate", "related_tools": ["user.apikeys.create", "user.apikeys.revoke"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "User Apikeys Rotate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_not_found": "Unknown key_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rotate a PAT without changing scope/caps."}, "domain": "user", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "errors": {"key_not_found": "Unknown key_id", "unauthorized": "No user"}, "execution_class": "cheap", "instruction_hint": "Rotate a PAT without changing scope/caps.", "mutation_kind": "none", "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_tools": ["user.apikeys.create", "user.apikeys.revoke"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "user_apikeys_rotate", "semantic_input_mode": "inherit_workflow", "summary": "Rotate a personal PAT; returns a new secret once.", "title": "User Apikeys Rotate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_not_found": "Unknown key_id", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rotate a PAT without changing scope/caps.", "write_mode": null}, {"action": "user.apikeys.update", "aliases": ["apikeys.update"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.user.gen1"], "id": "user.apikeys.update", "related_tools": ["user.apikeys.list", "user.apikeys.rotate"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "User Apikeys Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_not_found": "Unknown key_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rename or deactivate a PAT without rotating the secret."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.user.gen1"], "id": "user.apikeys.update", "related_tools": ["user.apikeys.list", "user.apikeys.rotate"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "User Apikeys Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_not_found": "Unknown key_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rename or deactivate a PAT without rotating the secret."}, "domain": "user", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"key_not_found": "Unknown key_id", "unauthorized": "No user"}, "execution_class": "cheap", "instruction_hint": "Rename or deactivate a PAT without rotating the secret.", "mutation_kind": "entity", "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "related_tools": ["user.apikeys.list", "user.apikeys.rotate"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "user_apikeys_update", "semantic_input_mode": "inherit_workflow", "summary": "Update PAT metadata (name and/or status). Caps change requires rotate or create.", "title": "User Apikeys Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_not_found": "Unknown key_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rename or deactivate a PAT without rotating the secret.", "write_mode": null}, {"action": "vertical_demo.seed_plan", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "vertical_demo", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "id": "vertical_demo.seed_plan", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vertical Demo Seed Plan", "when_to_use": "Preview demo CRM/expense seed before vertical_demo.seed_apply."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "vertical_demo", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "id": "vertical_demo.seed_plan", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vertical Demo Seed Plan", "when_to_use": "Preview demo CRM/expense seed before vertical_demo.seed_apply."}, "domain": "vertical_demo", "domain_title": "Vertical Demo MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "instruction_hint": "Preview demo CRM/expense seed before vertical_demo.seed_apply.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vertical_demo", "owner_gene": "core.mcp.vertical_demo.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "vertical_demo_seed_plan", "semantic_input_mode": "inherit_workflow", "summary": "Dry-run demo seed for vertical workspace.", "title": "Vertical Demo Seed Plan", "when_to_use": "Preview demo CRM/expense seed before vertical_demo.seed_apply.", "write_mode": null}, {"action": "vertical_demo.seed_apply", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "vertical_demo", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "id": "vertical_demo.seed_apply", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vertical Demo Seed Apply", "when_to_use": "Populate showcase demo data after vertical_demo.seed_plan."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "vertical_demo", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "id": "vertical_demo.seed_apply", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vertical Demo Seed Apply", "when_to_use": "Populate showcase demo data after vertical_demo.seed_plan."}, "domain": "vertical_demo", "domain_title": "Vertical Demo MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "instruction_hint": "Populate showcase demo data after vertical_demo.seed_plan.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vertical_demo", "owner_gene": "core.mcp.vertical_demo.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "vertical_demo_seed_apply", "semantic_input_mode": "inherit_workflow", "summary": "Apply demo CRM deals, contacts, expenses, goals.", "title": "Vertical Demo Seed Apply", "when_to_use": "Populate showcase demo data after vertical_demo.seed_plan.", "write_mode": null}, {"action": "vertical_demo.seed_clear", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "vertical_demo", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "id": "vertical_demo.seed_clear", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vertical Demo Seed Clear", "when_to_use": "Reset demo seed data before re-applying vertical_demo.seed_apply."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "vertical_demo", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "id": "vertical_demo.seed_clear", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vertical Demo Seed Clear", "when_to_use": "Reset demo seed data before re-applying vertical_demo.seed_apply."}, "domain": "vertical_demo", "domain_title": "Vertical Demo MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "instruction_hint": "Reset demo seed data before re-applying vertical_demo.seed_apply.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vertical_demo", "owner_gene": "core.mcp.vertical_demo.gen1", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "vertical_demo_seed_clear", "semantic_input_mode": "inherit_workflow", "summary": "Remove demo-tagged entities.", "title": "Vertical Demo Seed Clear", "when_blocked": {"preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps)."}, "when_to_use": "Reset demo seed data before re-applying vertical_demo.seed_apply.", "write_mode": null}, {"action": "vertical_demo.repair_due_dates", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "vertical_demo", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "id": "vertical_demo.repair_due_dates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vertical Demo Repair Due Dates", "when_to_use": "Heal hosted vertical dashboard when projects exist but due-soon is empty."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "vertical_demo", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "id": "vertical_demo.repair_due_dates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vertical Demo Repair Due Dates", "when_to_use": "Heal hosted vertical dashboard when projects exist but due-soon is empty."}, "domain": "vertical_demo", "domain_title": "Vertical Demo MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "instruction_hint": "Heal hosted vertical dashboard when projects exist but due-soon is empty.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vertical_demo", "owner_gene": "core.mcp.vertical_demo.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "vertical_demo_repair_due_dates", "semantic_input_mode": "inherit_workflow", "summary": "Set stage-based due_at on CRM deals missing a deadline (idempotent).", "title": "Vertical Demo Repair Due Dates", "when_to_use": "Heal hosted vertical dashboard when projects exist but due-soon is empty.", "write_mode": null}, {"action": "vertical_workspace.bootstrap", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "vertical_workspace", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_workspace.gen1"], "id": "vertical_workspace.bootstrap", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vertical Workspace Bootstrap", "when_to_use": "One-shot freelancer ops setup right after project create."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "vertical_workspace", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_workspace.gen1"], "id": "vertical_workspace.bootstrap", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vertical Workspace Bootstrap", "when_to_use": "One-shot freelancer ops setup right after project create."}, "domain": "vertical_workspace", "domain_title": "Vertical Workspace MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_workspace.gen1"], "instruction_hint": "One-shot freelancer ops setup right after project create.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vertical_workspace", "owner_gene": "core.mcp.vertical_workspace.gen1", "related_prompts": ["agentstack_hosted_vertical"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "vertical_workspace_bootstrap", "semantic_input_mode": "inherit_workflow", "summary": "Bootstrap vertical workspace after register: CRM pipeline preset, persona leaf, freelancer logic templates (idempotent).", "title": "Vertical Workspace Bootstrap", "when_to_use": "One-shot freelancer ops setup right after project create.", "write_mode": null}, {"action": "vision.inspect", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "vision", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.vision.domain.gen1"], "id": "vision.inspect", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vision Inspect", "when_blocked": {"https_fetch_disabled": "Enable project policy allow_https or use storage.upload + vision.inspect source=storage.", "ssrf_blocked": "Private/metadata hosts blocked — use storage blob or approved CDN URL.", "storage_id_required": "Pass storage_id from storage.upload — no raw file:// paths.", "vision_worker_unavailable": "Start vision-worker profile or set VISION_INLINE_STUB=1 for stub metrics."}, "when_to_use": "OpenCV-style metrics for one image; prefer storage.upload blob over raw URL."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "vision", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.vision.domain.gen1"], "id": "vision.inspect", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vision Inspect", "when_blocked": {"https_fetch_disabled": "Enable project policy allow_https or use storage.upload + vision.inspect source=storage.", "ssrf_blocked": "Private/metadata hosts blocked — use storage blob or approved CDN URL.", "storage_id_required": "Pass storage_id from storage.upload — no raw file:// paths.", "vision_worker_unavailable": "Start vision-worker profile or set VISION_INLINE_STUB=1 for stub metrics."}, "when_to_use": "OpenCV-style metrics for one image; prefer storage.upload blob over raw URL."}, "domain": "vision", "domain_title": "Vision MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"https_fetch_disabled": "Enable project policy allow_https or use storage.upload + vision.inspect source=storage.", "ssrf_blocked": "Private/metadata hosts blocked — use storage blob or approved CDN URL.", "storage_id_required": "Pass storage_id from storage.upload — no raw file:// paths.", "vision_worker_unavailable": "Start vision-worker profile or set VISION_INLINE_STUB=1 for stub metrics."}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.vision.gen1", "core.vision.domain.gen1"], "instruction_hint": "OpenCV-style metrics for one image; prefer storage.upload blob over raw URL.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vision", "owner_gene": "core.mcp.vision.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "vision_inspect", "semantic_input_mode": "inherit_workflow", "summary": "Inspect one image (metrics envelope). storage_id preferred over https.", "title": "Vision Inspect", "when_blocked": {"https_fetch_disabled": "Enable project policy allow_https or use storage.upload + vision.inspect source=storage.", "ssrf_blocked": "Private/metadata hosts blocked — use storage blob or approved CDN URL.", "storage_id_required": "Pass storage_id from storage.upload — no raw file:// paths.", "vision_worker_unavailable": "Start vision-worker profile or set VISION_INLINE_STUB=1 for stub metrics."}, "when_to_use": "OpenCV-style metrics for one image; prefer storage.upload blob over raw URL.", "write_mode": null}, {"action": "vision.extract", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "vision", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.vision.domain.gen1"], "id": "vision.extract", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vision Extract", "when_blocked": {"trace_not_found": "Run vision.inspect or vision.pipeline.run first — trace_id expires with worker memory."}, "when_to_use": "Run after vision.inspect; dry_run before live."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "vision", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.vision.domain.gen1"], "id": "vision.extract", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vision Extract", "when_blocked": {"trace_not_found": "Run vision.inspect or vision.pipeline.run first — trace_id expires with worker memory."}, "when_to_use": "Run after vision.inspect; dry_run before live."}, "domain": "vision", "domain_title": "Vision MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"trace_not_found": "Run vision.inspect or vision.pipeline.run first — trace_id expires with worker memory."}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.vision.gen1", "core.vision.domain.gen1"], "instruction_hint": "Run after vision.inspect; dry_run before live.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vision", "owner_gene": "core.mcp.vision.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "vision_extract", "semantic_input_mode": "inherit_workflow", "summary": "Extract structured fields (product_photo.v1) from an inspected asset.", "title": "Vision Extract", "when_blocked": {"trace_not_found": "Run vision.inspect or vision.pipeline.run first — trace_id expires with worker memory."}, "when_to_use": "Run after vision.inspect; dry_run before live.", "write_mode": null}, {"action": "vision.trace.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "vision", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.vision.domain.gen1"], "id": "vision.trace.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vision Trace Get", "when_blocked": {"trace_not_found": "Run vision.inspect or vision.pipeline.run first — trace_id expires with worker memory."}, "when_to_use": "Fetch trace steps + decisions for a pipeline run."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "vision", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.vision.domain.gen1"], "id": "vision.trace.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vision Trace Get", "when_blocked": {"trace_not_found": "Run vision.inspect or vision.pipeline.run first — trace_id expires with worker memory."}, "when_to_use": "Fetch trace steps + decisions for a pipeline run."}, "domain": "vision", "domain_title": "Vision MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"trace_not_found": "Run vision.inspect or vision.pipeline.run first — trace_id expires with worker memory."}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.vision.gen1", "core.vision.domain.gen1"], "instruction_hint": "Fetch trace steps + decisions for a pipeline run.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vision", "owner_gene": "core.mcp.vision.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "vision_trace_get", "semantic_input_mode": "inherit_workflow", "summary": "Return vision pipeline trace steps.", "title": "Vision Trace Get", "when_blocked": {"trace_not_found": "Run vision.inspect or vision.pipeline.run first — trace_id expires with worker memory."}, "when_to_use": "Fetch trace steps + decisions for a pipeline run.", "write_mode": null}, {"action": "vision.pipeline.run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "vision", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.vision.domain.gen1"], "id": "vision.pipeline.run", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vision Pipeline Run", "when_blocked": {"storage_id_required": "Pass storage_id from storage.upload — no raw file:// paths.", "vision_worker_unavailable": "Start vision-worker profile or set VISION_INLINE_STUB=1 for stub metrics."}, "when_to_use": "Always dry_run=true before billing live perceive steps."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "vision", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.vision.domain.gen1"], "id": "vision.pipeline.run", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vision Pipeline Run", "when_blocked": {"storage_id_required": "Pass storage_id from storage.upload — no raw file:// paths.", "vision_worker_unavailable": "Start vision-worker profile or set VISION_INLINE_STUB=1 for stub metrics."}, "when_to_use": "Always dry_run=true before billing live perceive steps."}, "domain": "vision", "domain_title": "Vision MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"storage_id_required": "Pass storage_id from storage.upload — no raw file:// paths.", "vision_worker_unavailable": "Start vision-worker profile or set VISION_INLINE_STUB=1 for stub metrics."}, "execution_class": "cheap", "genetic_tags": ["core.mcp.vision.gen1", "core.vision.domain.gen1"], "instruction_hint": "Always dry_run=true before billing live perceive steps.", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["vision.trace.get", "vision.inspect"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.vision", "owner_gene": "core.mcp.vision.gen1", "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "vision_pipeline_run", "semantic_input_mode": "inherit_workflow", "summary": "Run a named vision pipeline (dry_run recommended).", "title": "Vision Pipeline Run", "when_blocked": {"storage_id_required": "Pass storage_id from storage.upload — no raw file:// paths.", "vision_worker_unavailable": "Start vision-worker profile or set VISION_INLINE_STUB=1 for stub metrics."}, "when_to_use": "Always dry_run=true before billing live perceive steps.", "write_mode": null}, {"action": "vision.ask", "ai_tips": "Human-in-the-loop question — delivers notification (mutate, not read-only). Pair with agents.approve_run when gated.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "vision", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.vision.domain.gen1"], "id": "vision.ask", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vision Ask", "when_blocked": {"auth_required": "Operator Bearer session required before vision.ask can notify.", "channel_not_linked": "Target user has no linked bot channel — use in_app or enroll via bots.go_live.", "invalid_parameters": "question and project_id are required; use dry_run to preview deliver eligibility.", "operator_notify_failed": "notifications.deliver failed — check projects.get_notify_policy and channel prefs."}, "when_to_use": "Delivers operator notification — not read-only; pair with agents.approve_run when gated."}, "capability_descriptor_slim": {"complexity": "intermediate", "domain": "vision", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.vision.domain.gen1"], "id": "vision.ask", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vision Ask", "when_blocked": {"auth_required": "Operator Bearer session required before vision.ask can notify.", "channel_not_linked": "Target user has no linked bot channel — use in_app or enroll via bots.go_live.", "invalid_parameters": "question and project_id are required; use dry_run to preview deliver eligibility.", "operator_notify_failed": "notifications.deliver failed — check projects.get_notify_policy and channel prefs."}, "when_to_use": "Delivers operator notification — not read-only; pair with agents.approve_run when gated."}, "domain": "vision", "domain_title": "Vision MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "Operator Bearer session required before vision.ask can notify.", "channel_not_linked": "Target user has no linked bot channel — use in_app or enroll via bots.go_live.", "invalid_parameters": "question and project_id are required; use dry_run to preview deliver eligibility.", "operator_notify_failed": "notifications.deliver failed — check projects.get_notify_policy and channel prefs."}, "execution_class": "cheap", "genetic_tags": ["core.mcp.vision.gen1", "core.vision.domain.gen1"], "instruction_hint": "Delivers operator notification — not read-only; pair with agents.approve_run when gated.", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vision", "owner_gene": "core.mcp.vision.gen1", "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "vision_ask", "semantic_input_mode": "inherit_workflow", "summary": "Ask human operator a vision question (notification + optional agents.approve_run).", "title": "Vision Ask", "when_blocked": {"auth_required": "Operator Bearer session required before vision.ask can notify.", "channel_not_linked": "Target user has no linked bot channel — use in_app or enroll via bots.go_live.", "invalid_parameters": "question and project_id are required; use dry_run to preview deliver eligibility.", "operator_notify_failed": "notifications.deliver failed — check projects.get_notify_policy and channel prefs."}, "when_to_use": "Delivers operator notification — not read-only; pair with agents.approve_run when gated.", "write_mode": null}, {"action": "rest.marketplace.create_listing", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.storefront.seed_plan", "path": "POST /api/marketplace/listings", "related_tools": ["commerce.storefront.seed_plan", "preflight.check"], "safe_action": "rest_marketplace_create_listing", "summary": "Create listing (types: sale, buy, exchange, auction). Not an MCP action.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.marketplace.list_listings", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.storefront.list", "path": "GET /api/marketplace/listings", "related_tools": ["commerce.storefront.list", "preflight.check"], "safe_action": "rest_marketplace_list_listings", "summary": "List marketplace listings with filters.", "surface": "rest", "when_blocked": {"insufficient_permissions": "Project membership or cap required for seller catalog", "invalid_parameters": "Listing filters must match commerce.storefront.list params", "unauthorized": "Authenticate before marketplace browse REST"}}, {"action": "rest.marketplace.place_bid", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/marketplace/listings/{listing_id}/bids", "safe_action": "rest_marketplace_place_bid", "summary": "Place bid on auction listing. Body: amount, currency (USD→USDT), optional expected_revision. Header Idempotency-Key (scoped; mismatch 409). X-Project-ID via resolve_commerce_project_id for wallet lane", "surface": "rest"}, {"action": "rest.marketplace.list_bids", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/marketplace/listings/{listing_id}/bids", "safe_action": "rest_marketplace_list_bids", "summary": "Public bid ladder (bidder_label only). 404 when listing missing (not empty ladder).", "surface": "rest"}, {"action": "rest.commerce.storefront.list_global", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.storefront.list", "path": "GET /api/commerce/storefront/listings?scope=global", "related_tools": ["commerce.storefront.list", "preflight.check"], "safe_action": "rest_commerce_storefront_list_global", "summary": "Guest marketplace browse (TG 1810). Filters: project_id=seller, type, search, sort=ending. Prefer over GET /api/marketplace/listings for catalog.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.marketplace.accept_listing", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "finance.pay.execute", "path": "POST /api/marketplace/listings/{listing_id}/accept", "related_tools": ["finance.pay.execute", "preflight.check"], "safe_action": "rest_marketplace_accept_listing", "summary": "Accept deal / settle listing. X-Project-ID for buyer_project_id. 409 listing_has_active_deal for other buyer; same buyer 200 resumed. Terminal executed/cancelled deals allow re-accept.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.marketplace.close_auction", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/marketplace/listings/{listing_id}/close-auction", "safe_action": "rest_marketplace_close_auction", "summary": "Seller or worker closes auction after ends_at. Bridges winning bid lock into deal escrow, confirms, execute_deal. REST-only (no MCP parity).", "surface": "rest"}, {"action": "rest.commerce.scheduler.close_expired_auctions", "domain": "commerce_rest", "mcp_executable": false, "path": "scheduler action commerce.close_expired_auctions", "safe_action": "rest_commerce_scheduler_close_expired_auctions", "summary": "Worker batch: scan global auction index, authoritative DNA ends_at check, close_auction. Interval COMMERCE_CLOSE_AUCTIONS_INTERVAL_S (default 300s).", "surface": "rest"}, {"action": "rest.commerce.merchant.dashboard", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.sell.activate", "path": "GET /api/commerce/merchant/dashboard", "related_tools": ["commerce.sell.activate", "preflight.check"], "safe_action": "rest_commerce_merchant_dashboard", "summary": "Seller Command Center KPIs and recommended actions.", "surface": "rest", "when_blocked": {"forbidden": "Tenant operator — commerce.sell.activate vs buffs.grant; buyers use commerce.checkout.session", "invalid_parameters": "SKU / activation payload from storefront list", "service_cap_denied": "Project write + commerce cap — not buyer marketplace checkout session"}}, {"action": "rest.commerce.merchant.list_listings", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.storefront.list", "path": "GET /api/commerce/merchant/listings", "related_tools": ["commerce.storefront.list", "preflight.check"], "safe_action": "rest_commerce_merchant_list_listings", "summary": "Admin listings table for seller project (all statuses).", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller PID", "service_cap_denied": "Project write + payments cap for merchant admin BFF", "unauthorized": "Seller operator session — auth.get_profile before merchant REST"}}, {"action": "rest.commerce.merchant.incoming_orders", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.sell.activate", "path": "GET /api/commerce/merchant/orders-incoming", "related_tools": ["commerce.sell.activate", "preflight.check"], "safe_action": "rest_commerce_merchant_incoming_orders", "summary": "Incoming sales for seller project.", "surface": "rest", "when_blocked": {"forbidden": "Tenant operator — commerce.sell.activate vs buffs.grant; buyers use commerce.checkout.session", "invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.merchant.update_listing", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "assets.update", "path": "PUT /api/commerce/merchant/listings/{listing_uuid}", "related_tools": ["assets.update", "preflight.check"], "safe_action": "rest_commerce_merchant_update_listing", "summary": "Update listing status or price (seller admin).", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.merchant.sync_price", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "assets.update", "path": "POST /api/commerce/merchant/listings/{listing_uuid}/sync-price", "related_tools": ["assets.update", "preflight.check"], "safe_action": "rest_commerce_merchant_sync_price", "summary": "Sync listing price from catalog asset.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.merchant.reindex", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "assets.reindex", "path": "POST /api/commerce/merchant/listings/{listing_uuid}/reindex", "related_tools": ["assets.reindex", "preflight.check"], "safe_action": "rest_commerce_merchant_reindex", "summary": "Rebuild shop index row for one listing.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.merchant.bulk_sync_prices", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "assets.bulk_update", "path": "POST /api/commerce/merchant/listings/bulk-sync-prices", "related_tools": ["assets.bulk_update", "preflight.check"], "safe_action": "rest_commerce_merchant_bulk_sync_prices", "summary": "Sync all stale listing prices for project.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.merchant.bulk_deactivate", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "assets.bulk_update", "path": "POST /api/commerce/merchant/listings/bulk-deactivate", "related_tools": ["assets.bulk_update", "preflight.check"], "safe_action": "rest_commerce_merchant_bulk_deactivate", "summary": "Deactivate multiple listings.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.guidance.checklist", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/commerce/guidance/checklist", "safe_action": "rest_commerce_guidance_checklist", "summary": "Operator shop setup checklist (catalog + shelf).", "surface": "rest"}, {"action": "rest.commerce.guidance.catalog_hints", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/commerce/guidance/catalog-hints", "safe_action": "rest_commerce_guidance_catalog_hints", "summary": "Per-asset listing eligibility and stale price hints.", "surface": "rest"}, {"action": "rest.commerce.guidance.listing_draft", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/commerce/guidance/listing-draft", "safe_action": "rest_commerce_guidance_listing_draft", "summary": "Suggested listing draft defaults for one asset.", "surface": "rest"}, {"action": "rest.commerce.participant.holdings", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/commerce/participant/holdings", "safe_action": "rest_commerce_participant_holdings", "summary": "User holdings in a project (participant plane, not catalog).", "surface": "rest"}, {"action": "rest.commerce.participant.grant_holding", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/commerce/participant/grant-holding", "safe_action": "rest_commerce_participant_grant_holding", "summary": "Operator grant inventory to project member (requires write).", "surface": "rest"}, {"action": "rest.commerce.merchant.featured", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.storefront.list", "path": "GET|PUT /api/commerce/merchant/featured", "related_tools": ["commerce.storefront.list", "preflight.check"], "safe_action": "rest_commerce_merchant_featured", "summary": "Project featured listing UUIDs in 8DNA storefront config.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.merchant.coupons", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.coupon.list", "path": "GET|POST /api/commerce/merchant/coupons", "related_tools": ["commerce.coupon.list", "preflight.check"], "safe_action": "rest_commerce_merchant_coupons", "summary": "List or create project promo codes (8DNA commerce.coupon_registry).", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.merchant.coupon_by_code", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.coupon.update", "path": "PUT|DELETE /api/commerce/merchant/coupons/{code}", "related_tools": ["commerce.coupon.update", "preflight.check"], "safe_action": "rest_commerce_merchant_coupon_by_code", "summary": "Update or delete a project promo code.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.cart.apply_coupon", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/commerce/cart/apply-coupon", "safe_action": "rest_commerce_cart_apply_coupon", "summary": "Apply or clear coupon on authenticated cart (listing scope enforced).", "surface": "rest"}, {"action": "rest.commerce.cart.checkout", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/commerce/cart/checkout", "safe_action": "rest_commerce_cart_checkout", "summary": "Create checkout session from cart (wallet_internal or payments_fiat rail).", "surface": "rest"}, {"action": "rest.commerce.my_purchases", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/commerce/my-purchases", "safe_action": "rest_commerce_my_purchases", "summary": "Buyer purchases BFF — orders merged with active entitlements and delivery URLs.", "surface": "rest"}, {"action": "rest.commerce.delivery.refresh", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/commerce/delivery/refresh", "safe_action": "rest_commerce_delivery_refresh", "summary": "Re-issue signed delivery download token for a fulfilled order line.", "surface": "rest"}, {"action": "rest.commerce.orders.refund_request", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/commerce/orders/refund-request", "safe_action": "rest_commerce_orders_refund_request", "summary": "Request refund; wallet rail auto-compensates USDT. Fiat (payments_fiat) skips wallet credit — manual ops via admin manual-refunds.", "surface": "rest"}, {"action": "rest.commerce.orders.refund_status", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/commerce/orders/{order_id}/refund-request", "safe_action": "rest_commerce_orders_refund_status", "summary": "Poll refund request status and compensation snapshot for an order.", "surface": "rest"}, {"action": "rest.commerce.events.refund_stream", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/commerce/events/refund-stream", "safe_action": "rest_commerce_events_refund_stream", "summary": "SSE stream for refund lifecycle (commerce.refund.updated) — buyer/merchant cache refresh.", "surface": "rest"}, {"action": "rest.admin.commerce.refund_sse_health", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/admin/commerce/refund-sse-health", "safe_action": "rest_admin_commerce_refund_sse_health", "summary": "Ops: in-process refund SSE subscriber counts on this worker (connection_count, pg_bus_enabled).", "surface": "rest"}, {"action": "rest.admin.commerce.metrics_scrape", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/admin/commerce/metrics/scrape", "safe_action": "rest_admin_commerce_metrics_scrape", "summary": "Prometheus scrape for commerce funnel gauges (header X-Metrics-Token, env COMMERCE_METRICS_SCRAPE_TOKEN).", "surface": "rest"}, {"action": "rest.admin.commerce.settlement_funnel", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/admin/commerce/settlement-funnel", "safe_action": "rest_admin_commerce_settlement_funnel", "summary": "Ops: stuck escrow scan + checkout funnel OpTrace + refund_sse_health snapshot.", "surface": "rest"}, {"action": "rest.exchange.quote", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/exchange/quote", "safe_action": "rest_exchange_quote", "summary": "Cross-project exchange quote (not protein command_type exchange).", "surface": "rest"}, {"action": "rest.exchange.execute", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/exchange/execute", "safe_action": "rest_exchange_execute", "summary": "Execute cross-project currency/asset exchange.", "surface": "rest"}, {"action": "rest.commerce.checkout.create_session", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/commerce/checkout/sessions", "safe_action": "rest_commerce_checkout_create_session", "summary": "Create checkout session for listing or cart lines. Send Idempotency-Key header for safe retries.", "surface": "rest"}, {"action": "rest.commerce.checkout.confirm_session", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/commerce/checkout/sessions/{session_id}/confirm", "safe_action": "rest_commerce_checkout_confirm_session", "summary": "Confirm checkout session (wallet_internal or payments_fiat rail). 402 insufficient_balance, 409 partial_failure — use Idempotency-Key.", "surface": "rest"}, {"action": "rest.commerce.checkout.get_session", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/commerce/checkout/sessions/{session_id}", "safe_action": "rest_commerce_checkout_get_session", "summary": "Poll checkout session status until completed/failed/expired.", "surface": "rest"}, {"action": "rest.admin.commerce.manual_refunds_list", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/admin/commerce/manual-refunds", "safe_action": "rest_admin_commerce_manual_refunds_list", "summary": "Ops: list refund_requested orders awaiting manual compensation for a buyer slice.", "surface": "rest"}, {"action": "rest.admin.commerce.manual_refunds_complete", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/admin/commerce/manual-refunds/complete", "safe_action": "rest_admin_commerce_manual_refunds_complete", "summary": "Ops: mark fiat/manual refund compensated — revoke entitlements, set order refunded.", "surface": "rest"}, {"action": "rest.commerce.reconcile_escrow", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/admin/commerce/reconcile-escrow?dry_run=true", "safe_action": "rest_commerce_reconcile_escrow", "summary": "Ops: find deals confirmed without completed transfer (nightly gate).", "surface": "rest"}, {"action": "rest.auth.hosted_app_session", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/hosted-apps/{project_id}/session", "safe_action": "rest_auth_hosted_app_session", "summary": "Mint hosted_app cookie after REST login — required before /s/{project_id}/mcp (not operator Bearer).", "surface": "rest"}, {"action": "rest.projects.get_my_data", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/projects/{project_id}/users/me/data", "safe_action": "rest_projects_get_my_data", "summary": "Member-private project data read (hosted cloud save; MCP projects.get_my_data).", "surface": "rest"}, {"action": "rest.commerce.iap.entitlements", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.entitlements.list", "path": "GET /api/commerce/iap/entitlements?project_id={project_id}&include_sandbox=true (operator; ignored on hosted_app cookie)", "related_tools": ["shop.entitlements.list", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_entitlements", "summary": "Buyer IAP entitlements for hosted /s/{pid}/ (parity shop.entitlements.list).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login", "forbidden": "Cross-user list requires project_admin", "include_sandbox_ignored_on_hosted": "Hosted plane returns live entitlements only — operator use include_sandbox=true", "project_scope_mismatch": "params.project_id must match hosted session project"}}, {"action": "rest.commerce.iap.enablement", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.enablement.status", "path": "GET /api/commerce/iap/enablement?project_id={project_id}", "related_tools": ["shop.enablement.status", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_enablement", "summary": "Visitor sell gate + blockers (parity shop.enablement.status; hosted cookie).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "catalog_auth_required": "Guest cannot read sell gate when iap_public_catalog=false.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.checkout_resume", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.orders.get", "path": "GET /api/commerce/iap/checkout/resume?project_id={project_id}&payment_id={payment_id}", "related_tools": ["shop.orders.get", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_checkout_resume", "summary": "Stripe Payment Element resume after ?iap_checkout=1 redirect (hosted cookie).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "order_not_found": "Resume only after shop.checkout.create — pass payment_id from redirect.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.products", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.products.list", "path": "GET /api/commerce/iap/products?project_id={project_id}", "related_tools": ["shop.products.list", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_products", "summary": "Visitor SKU catalog (parity shop.products.list).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "catalog_auth_required": "iap_public_catalog=false — sign in or enable public catalog.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "sell_disabled": "Owner sell gate off — shop.enablement.status before listing SKUs.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.checkout", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.checkout.create", "path": "POST /api/commerce/iap/checkout", "related_tools": ["shop.checkout.create", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_checkout", "summary": "Start hosted checkout (parity shop.checkout.create).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "client_amount_forbidden": "Never pass amount_minor — price comes from SKU server-side.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "sell_disabled": "Sell gate off — shop.enablement.status; fix blockers before checkout.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.order_cancel", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.orders.cancel", "path": "POST /api/commerce/iap/orders/{order_id}/cancel?project_id={project_id}", "related_tools": ["shop.orders.cancel", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_order_cancel", "summary": "Cancel buyer pending_payment order (parity shop.orders.cancel).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "order_not_cancelable": "Only pending_payment orders cancel; poll shop.orders.get first.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.balances", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "wallets.balance", "path": "GET /api/commerce/iap/balances?project_id={project_id}", "related_tools": ["wallets.balance", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_balances", "summary": "Player soft-currency balances (parity wallets.balance).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "forbidden_for_visitor": "Soft-currency balance requires player or operator session.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.order_get", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.orders.get", "path": "GET /api/commerce/iap/orders/{order_id}?project_id={project_id}", "related_tools": ["shop.orders.get", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_order_get", "summary": "Poll buyer order (parity shop.orders.get; hosted cookie).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "invalid_order_id": "Order id must be a UUID owned by the buyer cookie scope.", "order_not_found": "Unknown order — confirm id from shop.checkout.create response.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.payment_methods", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "payments.list_methods", "path": "GET /api/commerce/iap/payment-methods?project_id={project_id}", "related_tools": ["payments.list_methods", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_payment_methods", "summary": "Checkout payment methods (parity payments.list_methods).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.spend", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "wallets.spend", "path": "POST /api/commerce/iap/spend?project_id={project_id}", "related_tools": ["wallets.spend", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_spend", "summary": "Spend soft currency in-game (parity wallets.spend).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "insufficient_funds": "Top up via shop.checkout.create before wallets.spend parity.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.ledger", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "wallets.ledger.list", "path": "GET /api/commerce/iap/ledger?project_id={project_id}", "related_tools": ["wallets.ledger.list", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_ledger", "summary": "Wallet ledger tail (parity wallets.ledger.list).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.owner_orders", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.orders.list", "path": "GET /api/commerce/iap/owner/orders?project_id={project_id}&status={status}&attention_only=1", "related_tools": ["shop.orders.list", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_owner_orders", "summary": "Owner order tail; attention_only=1 filters grant_pending and metadata.fulfillment_phase=invites_pending plus fulfilled channel_pass invite gaps (parity shop.orders.list attention_only).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.buyer_orders", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.orders.list", "path": "GET /api/commerce/iap/orders?project_id={project_id}", "related_tools": ["shop.orders.list", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_buyer_orders", "summary": "Buyer purchase history (parity shop.orders.list hosted scope).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.owner_enablement", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.enablement.status", "path": "GET /api/commerce/iap/owner/enablement?project_id={project_id}", "related_tools": ["shop.enablement.status", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_owner_enablement", "summary": "Owner sell gate + blockers (parity shop.enablement.status; project read).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.public_session", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.orders.get", "path": "GET /api/commerce/iap/checkout/public-session?project_id={project_id}&payment_id={payment_id}", "related_tools": ["shop.orders.get", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_public_session", "summary": "Bot deep-link pay session without buyer cookie (parity shop.orders.get enrich; not payments.get).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}], "catalog_actions_public": 752, "catalog_etag": "91de991772e1acd9", "catalog_scope": "authenticated", "catalog_served_total": 982, "domain_count": 75, "domains": {"admin": [{"action": "admin.data.health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.data.health", "related_tools": ["admin.data.people", "admin.data.dna_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Data Health"}, "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Diagnose empty admin lists vs live DB without opening the SPA.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "plane_chooser": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "related_tools": ["admin.data.people", "admin.data.dna_list"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "admin_data_health", "semantic_input_mode": "inherit_workflow", "summary": "Cheap counts for platform admin data plane (projects/users DNA slices).", "title": "Admin Data Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Diagnose empty admin lists vs live DB without opening the SPA.", "write_mode": null}, {"action": "admin.data.people", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.data.people", "related_tools": ["admin.data.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Data People"}, "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Verify Access hub users/projects payloads for ecosystem owner.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "plane_chooser": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "related_tools": ["admin.data.health"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "admin_data_people", "semantic_input_mode": "inherit_workflow", "summary": "Admin people bundle: projects (list shape) + users for a project.", "title": "Admin Data People", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify Access hub users/projects payloads for ecosystem owner.", "write_mode": null}, {"action": "admin.data.dna_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.data.dna_list", "related_tools": ["admin.data.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Data Dna List"}, "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Compare dna-list totals with UI table row counts.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "plane_chooser": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "related_tools": ["admin.data.health"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "admin_data_dna_list", "semantic_input_mode": "inherit_workflow", "summary": "Paginated DNA list with unified_8dna_role filters for admin Data hub.", "title": "Admin Data Dna List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compare dna-list totals with UI table row counts.", "write_mode": null}, {"action": "admin.database.schema_inventory", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.database.schema_inventory", "related_tools": ["admin.database.integrity_8dna", "admin.database.migrations_ledger"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Database Schema Inventory"}, "doc_audience": "operator", "domain_title": "Admin Database MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_database.gen1"], "instruction_hint": "Diagnose canonical drift without opening Ops database tab.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_database", "owner_gene": "core.mcp.admin_database.gen1", "plane": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "plane_chooser": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "related_tools": ["admin.database.integrity_8dna", "admin.database.migrations_ledger"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "admin_database_schema_inventory", "semantic_input_mode": "inherit_workflow", "summary": "Full schema health report (static drift + live inventory + registry).", "title": "Admin Database Schema Inventory", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Diagnose canonical drift without opening Ops database tab.", "write_mode": null}, {"action": "admin.database.integrity_8dna", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.database.integrity_8dna", "related_tools": ["admin.database.schema_inventory"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Database Integrity 8Dna"}, "domain_title": "Admin Database MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_database.gen1"], "instruction_hint": "Verify unified 8DNA graph health after migrations.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_database", "owner_gene": "core.mcp.admin_database.gen1", "plane": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "plane_chooser": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "related_tools": ["admin.database.schema_inventory"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "admin_database_integrity_8dna", "semantic_input_mode": "inherit_workflow", "summary": "Live 8DNA integrity scan (orphans, cycles, legacy parity).", "title": "Admin Database Integrity 8Dna", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify unified 8DNA graph health after migrations.", "write_mode": null}, {"action": "admin.database.migration_flags", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.database.migration_flags", "related_tools": ["admin.database.schema_inventory", "admin.database.migrations_ledger"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Database Migration Flags"}, "domain_title": "Admin Database MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_database.gen1"], "instruction_hint": "Check migrate_013 / migrate_018 toggles before schema sync.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_database", "owner_gene": "core.mcp.admin_database.gen1", "plane": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "plane_chooser": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "related_tools": ["admin.database.schema_inventory", "admin.database.migrations_ledger"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "admin_database_migration_flags", "semantic_input_mode": "inherit_workflow", "summary": "Read opt-in platform_db_init flags from data.config.database_migrations.", "title": "Admin Database Migration Flags", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Check migrate_013 / migrate_018 toggles before schema sync.", "write_mode": null}, {"action": "admin.database.migrations_ledger", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.database.migrations_ledger", "related_tools": ["admin.database.schema_inventory"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Admin Database Migrations Ledger"}, "domain_title": "Admin Database MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_database.gen1"], "instruction_hint": "Confirm which migrate_* steps applied on this environment.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_database", "owner_gene": "core.mcp.admin_database.gen1", "plane": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "plane_chooser": "Operator hub: admin.data.health — ecosystem jurisdiction, not tenant app edits.", "related_tools": ["admin.database.schema_inventory"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "admin_database_migrations_ledger", "semantic_input_mode": "inherit_workflow", "summary": "Recent platform_schema_migrations ledger rows.", "title": "Admin Database Migrations Ledger", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Confirm which migrate_* steps applied on this environment.", "write_mode": null}], "agents": [{"action": "agents.graph_health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not mutate task_list via projects.patch_data — use plan_heal_leaf / plan_patch archive ladder."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.graph_health", "related_tools": ["diagnostics.consistency.scan", "agents.plan_get", "agents.work_next", "agents.plan_compaction_preview", "agents.plan_heal_leaf"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Graph Health"}, "do_not_use_when": "Do not mutate task_list via projects.patch_data — use plan_heal_leaf / plan_patch archive ladder.", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Project graph health before plan_execute", "request": {"params": {"home": "project", "project_id": 1}, "tool": "agents.graph_health"}, "response": {"data": {"finding_count": 0, "health_ok": true}, "success": true}}, {"description": "When needs_leaf_heal or spill_incomplete: plan_compaction_preview → plan_heal_leaf dry_run then apply; manual prose via graph_file_put", "name": "Community hub spill advisory", "request": {"params": {"home": "project_self", "project_id": 1}, "tool": "agents.graph_health"}, "response": {"data": {"finding_count": 1, "graph_limits": {"body_read_chunk_seal": "agents.plan_get detail=body node_id", "body_read_storage_ref": "agents.graph_file_get", "bytes_estimate": 520000, "chunk_spill_target_bytes": 400000, "needs_leaf_heal": true, "spill_incomplete": true}, "health_ok": true}, "success": true}}], "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Read-only graph health before plan_execute on risky leaves or after verification_failed — follow re…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_compaction_preview", "agents.plan_heal_leaf"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.consistency.scan", "agents.plan_get", "agents.work_next", "agents.plan_compaction_preview", "agents.plan_heal_leaf"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_graph_health", "semantic_input_mode": "inherit_workflow", "summary": "Work Graph health snapshot (loop compliance, blocked ratio, structural cycle). Thin read wrapper over diagnostics.consistency.scan graph_health block.", "title": "Agents Graph Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not mutate task_list via projects.patch_data — use plan_heal_leaf / plan_patch archive ladder.", "when_to_use": "Read-only graph health before plan_execute on risky leaves or after verification_failed — follow recommended_follow_up; does not mutate DNA. First step when graph_limits.spill_incomplete, advisories p", "write_mode": null}, {"action": "agents.list", "aliases": ["agents.catalog", "agents.fleet", "agents.list_agents"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.list", "related_tools": ["agents.get", "agents.create", "agents.run", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents List"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Fleet index cards", "request": {"params": {"project_id": 1, "projection": "summary"}, "tool": "agents.list"}, "response": {"data": {"agents": [], "projection": "summary"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Discover fleet rows before get/run. Read projection on the response — summary is not full spec. hom…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.get", "agents.create", "agents.run", "discovery.describe"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_list", "semantic_input_mode": "inherit_workflow", "summary": "List Agents Fleet rows. Default projection=summary reads the fleet index card (uuid, title, status), not agent_spec. projection=full loads the agent row.", "title": "Agents List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover fleet rows before get/run. Read projection on the response — summary is not full spec. home=project (default) | self | project_self — env_uuid only when home=project. owner=user lists persona", "write_mode": null}, {"action": "agents.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.get", "related_tools": ["agents.list", "agents.update", "agents.run", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Get"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Full AgentSpec", "request": {"params": {"agent_id": "<uuid>", "project_id": 1, "projection": "full"}, "tool": "agents.get"}, "response": {"data": {"agent": {}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Load full agent_spec for edit or run. home=project | self | project_self — env_uuid only when home=…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.list", "agents.update", "agents.run", "discovery.describe"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_get", "semantic_input_mode": "inherit_workflow", "summary": "Get a single agent by UUID (default owner=project; personal rows need owner=user).", "title": "Agents Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load full agent_spec for edit or run. home=project | self | project_self — env_uuid only when home=project (sandbox overlay). owner=user for personal rows. Omit env for production read.", "write_mode": null}, {"action": "agents.workflow_compile_preview", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.workflow_compile_preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Workflow Compile Preview"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Validate workflow graph compile without persisting AgentSpec (read-only).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_workflow_compile_preview", "semantic_input_mode": "inherit_workflow", "summary": "Validate workflow graph compile without persisting AgentSpec (read-only).", "title": "Agents Workflow Compile Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Validate workflow graph compile without persisting AgentSpec (read-only).", "write_mode": null}, {"action": "agents.create", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.create", "mutation_risk": "low", "related_tools": ["agents.get", "agents.update"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Create"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"description": "example_string", "home": "example_string", "name": "example_string", "owner": "example_string", "project_id": 123}, "example_request": {"action": "agents.create", "params": {"description": "example_string", "home": "example_string", "name": "example_string", "owner": "example_string", "project_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Provision a fleet agent.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.get", "agents.update"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["agents.delete"], "safe_action": "agents_create", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a new agent row (draft AgentSpec).", "title": "Agents Create", "verification": ["agents.get", "agents.list"], "verify": [{"action": "agents.get", "predicate": "named resource is visible"}, {"action": "agents.list", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be created under an open sandbox head without diff-child bootstrap (AA-10b). Fork generation env or clear head; then use scoped create overlay.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Provision a fleet agent.", "write_mode": null}, {"action": "agents.update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Sending a partial agent_spec without section or path_updates — that replaces the whole spec.", "anti_patterns": ["Sending a partial agent_spec without section or path_updates — that replaces the whole spec.", "Passing write_mode=merge with a partial agent_spec (use section or path_updates).", "Setting state to active — the lifecycle has no such value; use ready or live.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.update", "mutation_risk": "low", "related_tools": ["agents.get", "agents.run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Update"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Persist one section or leaf. Merge keeps sibling fields. Workflow, reactions, and schedule compile …", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.get", "agents.run"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_update", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Update an agent. `section`+`section_value` or `path_updates` load the current AgentSpec, merge objects (lists replace), validate, then `update_agent_spec` (Logic sync for workflow, reactions, schedule", "title": "Agents Update", "when_blocked": {"content_shrink_blocked": "Refusing a truncated string leaf.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "unified_diff did not apply to that string leaf.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "replacement_not_found": "find is not in that agent_spec string leaf.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "use_path_updates": "write_mode=merge requires section or path_updates"}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Persist one section or leaf. Merge keeps sibling fields. Workflow, reactions, and schedule compile because the write uses update_agent_spec. Bind generation_env_uuid (or rely on MCP sandbox head). Pos", "write_mode": ["patch", "merge", "replace", "write"], "write_mode_note": "section and path_updates default to merge (objects merge, lists replace). write_mode=replace sets the section or leaf wholesale. A full agent_spec without section/path_updates is a replace. write_mode=merge with only a partial agent_spec is rejected."}, {"action": "agents.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.delete", "mutation_risk": "low", "related_tools": ["agents.list", "agents.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Delete"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "example_params": {"agent_id": "example_string", "home": "example_string", "owner": "example_string", "project_id": 123}, "example_request": {"action": "agents.delete", "params": {"agent_id": "example_string", "home": "example_string", "owner": "example_string", "project_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Remove an agent from the fleet.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.list", "agents.get"], "required_cap": "agents_admin", "requires_preflight": true, "risk_class": "destructive", "rollback": [], "safe_action": "agents_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete an agent row.", "title": "Agents Delete", "verification": ["agents.list"], "verify": [{"action": "agents.list", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be deleted/archived under an open sandbox head. Use diff-child tombstone (AA-11b) or clear generation env.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Remove an agent from the fleet.", "write_mode": null}, {"action": "agents.provider_preflight", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not treat provider_preflight as a billed LLM completion — no energy debit.", "anti_patterns": ["Do not treat provider_preflight as a billed LLM completion — no energy debit.", "Do not skip force_probe when quota is unknown and a live check is required.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1", "core.economy.llm_energy.gen1"], "id": "agents.provider_preflight", "related_tools": ["ai.providers.probe", "ai.providers.connect", "ai.providers.list", "agents.run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Provider Preflight"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "errors": {"agent_not_found": "Unknown agent_id; omit agent_id to probe orchestrator", "auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "project_id required", "key_missing": "No BYOK for provider — ai.providers.connect with api_key (ecosystem or project). Next: ai.providers.connect.", "not_found": "Agent spec missing — reconcile orchestrator binding", "probe_failed": "Credential/quota probe failed — reconnect key or pick another provider. Next: ai.providers.connect.", "provider_quota_exceeded": "Upstream quota/rate limit — wait, switch provider, or check energy.get_balance. Next: energy.get_balance.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "examples": [{"agent_id": "<uuid>", "force_probe": false, "project_id": 1}, {"force_probe": true, "project_id": 1}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1", "core.llm.partner_providers.gen1", "core.economy.llm_energy.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Before agents.run or agents.orchestrate when AgentSpec.llm.preflight_required is set. Live probe wh…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["ai.providers.probe", "ai.providers.connect", "energy.get_balance", "agents.run"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["ai.providers.probe", "ai.providers.connect", "ai.providers.list", "agents.run"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_provider_preflight", "semantic_input_mode": "inherit_workflow", "summary": "Read-only LLM provider snapshot for an agent before enqueue (quota hints, fallbacks).", "title": "Agents Provider Preflight", "when_blocked": {"agent_not_found": "Unknown agent_id; omit agent_id to probe orchestrator", "auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_missing": "No BYOK for provider — ai.providers.connect with api_key (ecosystem or project). Next: ai.providers.connect.", "not_found": "Agent spec missing — reconcile orchestrator binding", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "probe_failed": "Credential/quota probe failed — reconnect key or pick another provider. Next: ai.providers.connect.", "provider_quota_exceeded": "Upstream quota/rate limit — wait, switch provider, or check energy.get_balance. Next: energy.get_balance.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "when_to_use": "Before agents.run or agents.orchestrate when AgentSpec.llm.preflight_required is set. Live probe when required or force_probe=true; else metadata_only (no energy debit).", "write_mode": null}, {"action": "agents.orchestrate", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not use for business.assistant.setup — execute mcp_tenant_business_assistant_v1 (see WORK_GRAPH_TOOL_WHEN[business.assistant.setup]).", "anti_patterns": ["Do not use for business.assistant.setup — execute mcp_tenant_business_assistant_v1 (see WORK_GRAPH_TOOL_WHEN[business.as", "Do not treat data.error_code chat_limit_reached or chat_ai_limit as orchestrate_failed — tune ai.chat.settings (limits, ", "Do not bypass daily cap with on_limit=fallback — fallback provider does not skip messages_per_user_day."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "heavy_llm", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"wait": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.orchestrate", "mutates_when": {"wait": true}, "mutation_risk": "low", "related_tools": ["projects.orchestrator.get", "projects.orchestrator.patch", "agents.work_next", "agents.run_get", "agents.traces", "agents.reconcile_binding"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Orchestrate"}, "do_not_use_when": "Do not use for business.assistant.setup — execute mcp_tenant_business_assistant_v1 (see WORK_GRAPH_TOOL_WHEN[business.assistant.setup]).", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "wait=true (default on some clients) counts as one heavy_llm sync step — use wait=false + agents.run_get or options.async=true + discovery.job_status", "effect_depends_on_params": true, "execution_class": "heavy", "generation": false, "kind": "mutate", "mutates_when": {"wait": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Project operator via resolve_and_run — channel workspace|messenger|bot|mcp|api (default mcp). home=…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.work_next", "agents.run_get", "agents.reconcile_binding", "projects.orchestrator.get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["projects.orchestrator.get", "projects.orchestrator.patch", "agents.work_next", "agents.run_get", "agents.traces", "agents.reconcile_binding"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_orchestrate", "semantic_input_mode": "inherit_workflow", "summary": "Run the project AI orchestrator for a channel (workspace|messenger|bot|mcp|api).", "title": "Agents Orchestrate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not use for business.assistant.setup — execute mcp_tenant_business_assistant_v1 (see WORK_GRAPH_TOOL_WHEN[business.assistant.setup]).", "when_to_use": "Project operator via resolve_and_run — channel workspace|messenger|bot|mcp|api (default mcp). home=project|self|project_self; env_uuid only with home=project (sandbox slice never auto-provisions). wai", "write_mode": null}, {"action": "agents.run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "async_execute": {"enable": "options.async=true", "poll_action": "discovery.job_status", "poll_rest": "GET /mcp/jobs/{job_id}", "single_heavy_lane_ms": 180000, "sync_lane_ms": 120000}, "budget_note": "wait=false (default) enqueues without holding the sync batch; poll agents.run_get or GET /api/projects/{project_id}/agents/{agent_id}/runs/{run_id}. wait=true counts as heavy_llm (ai_stream, max wait_timeout_s 30) — one per sync execute; long work: options.async=true then discovery.job_status.", "cancel_action": "agents.stop", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "heavy_llm", "budget_note": "wait=false (default) enqueues without holding the sync batch; poll agents.run_get or GET /api/projects/{project_id}/agents/{agent_id}/runs/{run_id}. wait=true counts as heavy_llm (ai_stream, max wait_timeout_s 30) — one per sync execute; long work: options.async=true then discovery.job_status.", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"wait": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.mcp.agents.gen1", "core.economy.llm_energy.gen1"], "id": "agents.run", "mutates_when": {"wait": true}, "mutation_risk": "low", "related_tools": ["agents.run_get", "agents.provider_preflight", "energy.get_balance", "ai.providers.probe", "agents.approve_run", "agents.traces", "storage.upload"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Run"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "budget_note": "wait=false (default) enqueues without holding the sync batch; poll agents.run_get or GET /api/projects/{project_id}/agents/{agent_id}/runs/{run_id}. wait=true counts as heavy_llm (ai_stream, max wait_timeout_s 30) — one per sync execute; long work: options.async=true then discovery.job_status.", "conditional_mutate": "wait=true holds ai_stream up to wait_timeout_s (max 30) — one heavy_llm per sync batch. wait=false enqueues; poll agents.run_get or GET /api/projects/{project_id}/agents/{agent_id}/runs/{run_id}. Long suites: options.async=true + discovery.job_status.", "effect_depends_on_params": true, "execution_class": "heavy", "generation": false, "kind": "mutate", "mutates_when": {"wait": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"agent_id": "example_string", "attachments": [], "handoff_reason": "example_string", "handoff_to_agent_id": "example_string", "home": "example_string", "idempotency_key": "example_string", "input": {}, "message": "example_string", "owner": "example_string", "parent_run_id": "example_string", "project_id": 123, "root_run_id": "example_string", "wait": true, "wait_timeout_s": 123.45}, "example_request": {"action": "agents.run", "params": {"agent_id": "example_string", "attachments": [], "handoff_reason": "example_string", "handoff_to_agent_id": "example_string", "home": "example_string", "idempotency_key": "example_string", "input": {}, "message": "example_string", "owner": "example_string", "parent_run_id": "example_string", "project_id": 123, "root_run_id": "example_string", "wait": true, "wait_timeout_s": 123.45}}, "examples": [{"name": "Enqueue then poll", "request": {"params": {"agent_id": "<uuid>", "message": "Summarize fleet health", "project_id": 1, "wait": false}, "tool": "agents.run"}, "response": {"data": {"run_succeeded": null, "run_uuid": "<uuid>"}, "success": true}}, {"name": "Plan-focus on personal leaf", "request": {"params": {"agent_id": "<uuid>", "home": "project_self", "input": {"focus_node_id": "task-a", "message": "Execute leaf"}, "project_id": 1, "wait": false}, "tool": "agents.run"}, "response": {"data": {"run_succeeded": null, "run_uuid": "<uuid>"}, "success": true}}], "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Execute agent with policy caps; poll via agents.run_get (not discovery.job_status). Energy: peek en…", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": [{"action": "agents.run_get", "note": "Poll terminal status; do not re-run agents.run to check progress.", "params": {"run_id": "<run_uuid from agents.run>"}}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.run_get", "agents.provider_preflight", "energy.get_balance", "ai.providers.probe", "agents.approve_run", "agents.traces", "storage.upload", "bots.conversations"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "agents_run", "semantic_input_mode": "inherit_workflow", "summary": "Enqueue an agent run (durable work queue). instruction_slice and recovery_hint use context.locale / instruction_locale.", "title": "Agents Run", "verification": ["agents.run_get", "agents.list"], "verify": [{"action": "agents.run_get", "predicate": "named resource is visible"}, {"action": "agents.list", "predicate": "named resource is visible"}], "when_blocked": {"agent_daily_cap": "Agent per_day_cap reached — raise cap in AgentSpec energy budget or wait UTC day", "agent_not_found": "Unknown agent_id in this project", "attachment_validation_failed": "Fix output.attachments[] (kind + storage_file_id or https url) before commit", "channel_media_unsupported": "Channel or attachment shape cannot send that media — check bots.health caps", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "energy_denied": "Insufficient builder_energy — energy.get_balance then payments.create intent=energy_pack (subscription pool via buffs); BYOK: ai.providers.list + project AI keys; not AGNT demo rail", "env_uuid_project_only": "env_uuid is only valid for home=project on plan-focus runs", "graph_home_unknown": "home must be project, self, or project_self", "idempotency_key_too_short": "idempotency_key must be at least 8 characters", "insufficient_energy": "Pool reserve peek failed — energy.get_balance; top up or lower per_run_estimate", "invalid_parameters": "project_id and agent_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "agents_run capability required", "provider_preflight_blocked": "LLM preflight blocked enqueue — agents.provider_preflight, ai.providers.probe, ai.providers.connect, energy.get_balance", "provider_quota_exceeded": "Provider quota — use agents.provider_preflight or avoid wait=true in cert batches", "run_failed": "agents.work_next detail=compact — inspect run traces; repair_plan or reclaim before retry", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_file_not_found": "Outbound attachment storage_file_id missing — REST storage.upload to bots__outbound first", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "waiting_for_approval": "Poll agents.run_get then agents.approve_run"}, "when_to_use": "Execute agent with policy caps; poll via agents.run_get (not discovery.job_status). Energy: peek energy.get_balance before run (no hold); each LLM step debits builder_energy (platform_supply). When Ag", "write_mode": null}, {"action": "agents.run_with_agnt_credits", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.run_with_agnt_credits", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Run With Agnt Credits"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Quote-bound demo run", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "credits_atomic": 1000, "idempotency_key": "demo-run-001", "input": {"message": "Hello"}, "project_id": 1, "quote_hash": "hash-demo", "quote_id": "quote-demo"}, "tool": "agents.run_with_agnt_credits"}, "response": {"data": {"purchase": {}, "run": {}, "success": true}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Autonomous demo: fund runtime energy from AGNT ledger credits, then start a Fleet run. For JSON wal…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_run_with_agnt_credits", "semantic_input_mode": "inherit_workflow", "summary": "Demo orchestration: purchase compute credits (AGNT ledger) then enqueue an agent run.", "title": "Agents Run With Agnt Credits", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Autonomous demo: fund runtime energy from AGNT ledger credits, then start a Fleet run. For JSON wallet balances or fiat-first deploys use wallets.* / payments — not this demo path.", "write_mode": null}, {"action": "agents.fork", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Forking without env_uuid on an open generation head when editing fleet in sandbox.", "anti_patterns": ["Forking without env_uuid on an open generation head when editing fleet in sandbox.", "Passing env_uuid when home is project_self or self.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.fork", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Fork"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Draft generation", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "project_id": 1}, "tool": "agents.fork"}, "response": {"data": {"agent_spec": {}, "uuid": "00000000-0000-4000-8000-000000000002"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Create a draft child generation for experimentation. Under home=project + env_uuid, fork materializ…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_fork", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Fork an agent to a new generation (DNA row).", "title": "Agents Fork", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Create a draft child generation for experimentation. Under home=project + env_uuid, fork materializes a sandbox diff-child row (not prod INSERT); then generation.diff_vs_prod → promote.", "write_mode": null}, {"action": "agents.stop", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.stop", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Stop"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Cancel run", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "project_id": 1, "run_id": "00000000-0000-4000-8000-000000000002"}, "tool": "agents.stop"}, "response": {"data": {"stopped": true}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Stop an in-flight run from automation or ops.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_stop", "semantic_input_mode": "inherit_workflow", "summary": "Cancel a running / queued agent run.", "title": "Agents Stop", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Stop an in-flight run from automation or ops.", "write_mode": null}, {"action": "agents.kill", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.kill", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Kill"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "examples": [{"name": "Kill agent", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "project_id": 1}, "tool": "agents.kill"}, "response": {"data": {"agent_spec": {}, "uuid": "00000000-0000-4000-8000-000000000001"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Emergency stop for a misbehaving agent.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "agents_kill", "semantic_input_mode": "inherit_workflow", "summary": "Set agent lifecycle state to killed (hard stop for new runs).", "title": "Agents Kill", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Emergency stop for a misbehaving agent.", "write_mode": null}, {"action": "agents.promote", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.promote", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Promote"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Auto-promotion gates", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "project_id": 1}, "tool": "agents.promote"}, "response": {"data": {"gates": [], "success": true}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "After soak / canary, attempt promotion.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_promote", "semantic_input_mode": "inherit_workflow", "summary": "Run auto-promotion gates; may set state to live when metrics pass.", "title": "Agents Promote", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "After soak / canary, attempt promotion.", "write_mode": null}, {"action": "agents.rollout_advance", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.rollout_advance", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Rollout Advance"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Advance canary step", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "project_id": 1}, "tool": "agents.rollout_advance"}, "response": {"data": {"agent_spec": {}, "uuid": "00000000-0000-4000-8000-000000000001"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Progressive traffic shift for agent versions.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_rollout_advance", "semantic_input_mode": "inherit_workflow", "summary": "Advance canary rollout step (5→20→50→100).", "title": "Agents Rollout Advance", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Progressive traffic shift for agent versions.", "write_mode": null}, {"action": "agents.metrics", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.metrics", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Metrics"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Rollup snapshot", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "project_id": 1}, "tool": "agents.metrics"}, "response": {"data": {"metrics": {}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Diagnostics and dashboards (rollup is prod-plane; home/env scope agent access). Agent row existence…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_metrics", "semantic_input_mode": "inherit_workflow", "summary": "Read rollup metrics for an agent (ecosystem.agents_metrics).", "title": "Agents Metrics", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Diagnostics and dashboards (rollup is prod-plane; home/env scope agent access). Agent row existence respects X-AgentStack-Env / env_uuid (sandbox overlay). Metrics rollup and promotion gate evaluation", "write_mode": null}, {"action": "agents.gates", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.gates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Gates"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "examples": [{"name": "Pre-promotion gates", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "project_id": 1}, "tool": "agents.gates"}, "response": {"data": {"all_passed": false, "gates": []}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Pre-promotion verification (metrics gates use prod rollup; agent row respects env_uuid). Agent row …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_gates", "semantic_input_mode": "inherit_workflow", "summary": "Evaluate promotion gates for an agent.", "title": "Agents Gates", "when_blocked": {"agent_not_found": "Unknown agent_id in this project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "economy_crypto_disabled": "AGNT demo path disabled on this deployment", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown agent_id or owner scope mismatch (project vs user)", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pre-promotion verification (metrics gates use prod rollup; agent row respects env_uuid). Agent row existence respects X-AgentStack-Env / env_uuid (sandbox overlay). Metrics rollup and promotion gate e", "write_mode": null}, {"action": "agents.traces", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.traces", "related_tools": ["agents.run_get", "agents.approve_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Traces"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Debug slice of spec.events. Prefer agents.run_get for cockpit timeline (same SoT).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.run_get", "agents.approve_run"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_traces", "semantic_input_mode": "inherit_workflow", "summary": "Return stored run events (trace buffer) for a run.", "title": "Agents Traces", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Debug slice of spec.events. Prefer agents.run_get for cockpit timeline (same SoT).", "write_mode": null}, {"action": "agents.timeline", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.timeline", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Timeline"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Recent runs", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "limit": 20, "project_id": 1}, "tool": "agents.timeline"}, "response": {"data": {"runs": []}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Inspect execution history before approve or debug.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_timeline", "semantic_input_mode": "inherit_workflow", "summary": "List recent runs for an agent (uuid + status + timestamps).", "title": "Agents Timeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect execution history before approve or debug.", "write_mode": null}, {"action": "agents.version_timeline", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.version_timeline", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Version Timeline"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Generation lineage", "request": {"params": {"agent_id": "00000000-0000-4000-8000-000000000001", "project_id": 1}, "tool": "agents.version_timeline"}, "response": {"data": {"versions": []}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Inspect fork/promote lineage before rollout or rollback.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_version_timeline", "semantic_input_mode": "inherit_workflow", "summary": "List agent version lineage (generation tree — REST GET /timeline parity).", "title": "Agents Version Timeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect fork/promote lineage before rollout or rollback.", "write_mode": null}, {"action": "agents.list_pending_approvals", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.list_pending_approvals", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents List Pending Approvals"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Operator queue before calling agents.approve_run with artifact hash.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_list_pending_approvals", "semantic_input_mode": "inherit_workflow", "summary": "List runs waiting for approval across project or personal agent scope.", "title": "Agents List Pending Approvals", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator queue before calling agents.approve_run with artifact hash.", "write_mode": null}, {"action": "agents.runs_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not omit agent_id when debugging one agent — pass agent_id from work_next / ensure_agent.", "anti_patterns": ["Do not omit agent_id when debugging one agent — pass agent_id from work_next / ensure_agent.", "Do not use runs_list as the work loop — agents.work_next + packet.next_action.", "Do not expect full event traces — uuid/status only; agents.run_get for bodies.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.runs_list", "related_tools": ["agents.run_get", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Runs List"}, "do_not_use_when": "Do not omit agent_id when debugging one agent — pass agent_id from work_next / ensure_agent.", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Per-agent history when agent_id is set. Omit agent_id for project-wide skim (scope=project; each ro…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.run_get", "agents.work_next"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.run_get", "agents.work_next"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_runs_list", "semantic_input_mode": "inherit_workflow", "summary": "Rows are uuid, status, event_count, and timestamps. Event bodies stay on agents.run_get. Status and the event count are read in SQL.", "title": "Agents Runs List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not omit agent_id when debugging one agent — pass agent_id from work_next / ensure_agent.", "when_to_use": "Per-agent history when agent_id is set. Omit agent_id for project-wide skim (scope=project; each row includes agent_id; default ≤25 runs per agent via SQL window). Event bodies: agents.run_get. Queue/", "write_mode": null}, {"action": "agents.plan_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not scan full task_list when agents.work_next suffices for next-leaf selection.", "anti_patterns": ["Do not scan full task_list when agents.work_next suffices for next-leaf selection.", "Prefer detail=cards + node_id/max_depth; detail=full is bodies inside the slice only.", "Without node_id, cards/body/full default limit=50; wide body/full downgrades to cards."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_get", "related_tools": ["agents.work_next", "agents.plan_patch", "agents.plan_claim", "agents.graph_file_put", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Plan Get"}, "do_not_use_when": "Do not scan full task_list when agents.work_next suffices for next-leaf selection.", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"detail": "compact", "home": "project", "limit": 8, "max_depth": 1, "node_id": "plan_leaf_example"}, "example_request": {"action": "agents.plan_get", "params": {"detail": "compact", "home": "project", "limit": 8, "max_depth": 1, "node_id": "plan_leaf_example"}}, "examples": [{"description": "Default loop: metrics + revision only — no full graph or fleet scan.", "name": "Compact revision poll (hot path)", "request": {"params": {"detail": "compact", "limit": 32, "project_id": 1}, "tool": "agents.plan_get"}, "response": {"data": {"metrics": {"dependency_ready_leaves": 2, "revision": 12}, "scope": "project"}, "success": true}}, {"description": "Hydrate nodes from task_list.cold_pages or archive without opening the full graph.", "name": "Cold page slice", "request": {"params": {"detail": "cards", "limit": 32, "page_id": "0123456789abcdef", "project_id": 1}, "tool": "agents.plan_get"}, "response": {"data": {"scope": "project", "shape": {"page_slice": true}}, "success": true}}, {"description": "env_uuid reads the same generation slice as plan_patch/propose. Use detail=compact and node_id + max_depth when scoping eligibility.", "name": "Sandbox read with execution eligibility", "request": {"params": {"detail": "compact", "env_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "include_execution_eligibility": true, "max_depth": 1, "node_id": "task-a", "project_id": 1}, "tool": "agents.plan_get"}, "response": {"data": {"execution_eligibility": {"dependency_ready_count": 2, "execution_ready_count": 1, "leaves": [{"dependency_ready": true, "execution_ready": true, "id": "task-a", "resolution": "existing_agent"}, {"blocked_reason": "no_compatible_agent", "dependency_ready": true, "execution_ready": false, "id": "task-b"}]}, "metrics": {"dependency_ready_leaves": 2, "execution_ready_leaves": 1, "revision": 12}, "scope": "project"}, "success": true}}], "execution_class": "plain_read", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Follow packet.next_action. Default detail=compact (flat rows + revision; no task tree). Prod matrix…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.work_next", "agents.plan_claim"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.work_next", "agents.plan_patch", "agents.plan_claim", "agents.graph_file_put", "preflight.check"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_plan_get", "semantic_input_mode": "inherit_workflow", "summary": "Read the Work Graph (8DNA ecosystem.orchestrator.task_list). Default compact slice (revision + flat rows); fleet rollup metrics are opt-in via include_metrics or expand=metrics. Same MCP execute batch", "title": "Get Plan Graph", "wave_xix_atoms": {"WG_CLAIM_PREVIEW_SINGLE": "plan_get include_claimable=true — each claim preview row.execution from one canonical execution-resolver pass (execution_resolver SoT).", "WG_CLOSED_LOOP_EXECUTABLE": "state=actionable (alias executable) and execution_ready — next_action agents.plan_claim with if_match_revision from plan_get.", "WG_CLOSED_LOOP_STALE_CLAIM": "blocked_reason=expired_claim — next_action agents.plan_reclaim_stale; beats downstream dependency_blocked when no executable leaf.", "WG_DEPENDENCY_VS_EXECUTION_READY": "dependency_ready is structural (deps/status/decomposition); execution_ready is fleet (live agent or provision path) — never collapse the two gates.", "WG_DISCOVERY_ROUTE": "Discovery naming: intent_id (taxonomy) ≠ primary_action (router verb) ≠ agents.work_next (fleet pick) — do not treat a route phrase as an MCP action name. discovery.describe requires param action=<catalog action id> (not optional).", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_EXECUTION_SUMMARY_ONLY": "Read execution_summary.missing_requirements — missing_roles is legacy; do not infer fleet gaps from validation.missing_roles when execution_summary is present."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_detail": "detail/projection/limit validation — see problem.field in error payload", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "join_not_allowed": "Project is not open-join — request invite or projects.add_user from an owner.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "membership_required": "Open community hub: call projects.join on context.project_id, then agents.work_next with home=project_self (recipe mcp_community_hub_v1).", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "personal_home_agent_scope_conflict": "Use home=project with scope=agent for an agent private plan leaf, or use home=self|project_self without scope=agent for the session graph.", "plan_focus_invalid": "agents.work_next detail=compact — refresh focus_node_id from packet next_action", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "plan_slice_failed": "Narrow node_id, use projection=summary, or lower max_depth — slice could not be built", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wire_budget_exceeded": "Slice too large — narrow node_id, max_depth, or use detail=cards (detail=body|full past wire budget)"}, "when_not_to_use": "Do not scan full task_list when agents.work_next suffices for next-leaf selection.", "when_to_use": "Follow packet.next_action. Default detail=compact (flat rows + revision; no task tree). Prod matrix and deploy smoke use compact + limit≤32 for eligibility/metrics probes — not detail=full. Use detail", "write_mode": null}, {"action": "agents.plan_preview_affinities", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_preview_affinities", "related_tools": ["agents.plan_apply_affinities", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Preview Affinities"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Read-only gene/skill affinity hints on plan nodes — no DNA pin. home=project|self|project_self; sco…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_apply_affinities", "agents.work_next"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_plan_preview_affinities", "semantic_input_mode": "inherit_workflow", "summary": "Preview suggested gene/skill hints on plan nodes (read-only, no DNA pin).", "title": "Agents Plan Preview Affinities", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only gene/skill affinity hints on plan nodes — no DNA pin. home=project|self|project_self; scope=agent forbidden on personal home.", "write_mode": null}, {"action": "agents.plan_apply_affinities", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_apply_affinities", "mutation_risk": "low", "related_tools": ["agents.plan_preview_affinities", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Apply Affinities"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Pin skill_ids/gene_tags after preview. home=project|self|project_self; requires pin_skills and/or p…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_preview_affinities", "agents.work_next"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_apply_affinities", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Pin affinity hints onto plan DNA. Pass pin_skills and/or pin_genes; at least one must be true. When scope is agent, pass agent_id.", "title": "Agents Plan Apply Affinities", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pin skill_ids/gene_tags after preview. home=project|self|project_self; requires pin_skills and/or pin_genes; scope=agent needs home=project.", "write_mode": null}, {"action": "agents.plan_refresh_affinities", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_refresh_affinities", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Refresh Affinities"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Legacy alias — prefer plan_preview_affinities / plan_apply_affinities.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_refresh_affinities", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Deprecated alias: use plan_preview_affinities or plan_apply_affinities.", "title": "Agents Plan Refresh Affinities", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Legacy alias — prefer plan_preview_affinities / plan_apply_affinities.", "write_mode": null}, {"action": "agents.plan_patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not set return_task_list=true — response is revision + changed[]; refresh via work_next compact.", "anti_patterns": ["Do not set return_task_list=true — response is revision + changed[]; refresh via work_next compact.", "Node blockers use op link + dependencies, not description/prompt text.", "Do not full-set long prompt/detail bodies — use patch_text search_replace."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_patch", "mutation_risk": "low", "related_tools": ["agents.plan_get", "agents.work_next", "agents.plan_propose", "agents.graph_file_put", "agents.graph_file_get"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Plan Patch"}, "do_not_use_when": "Do not set return_task_list=true — response is revision + changed[]; refresh via work_next compact.", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"if_match_revision": 1, "ops": [{"node": {"id": "plan_child_example", "kind": "task", "status": "pending", "title": "Example child"}, "op": "add_child", "parent_id": "plan_leaf_example"}]}, "example_request": {"action": "agents.plan_patch", "params": {"if_match_revision": 1, "ops": [{"node": {"id": "plan_child_example", "kind": "task", "status": "pending", "title": "Example child"}, "op": "add_child", "parent_id": "plan_leaf_example"}]}}, "examples": [{"description": "Canonical create; use if_match_revision from plan_get.", "name": "add_child under parent", "request": {"params": {"if_match_revision": 12, "ops": [{"node": {"id": "task-new", "kind": "task", "status": "pending", "title": "New task"}, "op": "add_child", "parent_id": "goal-root"}], "project_id": 1}, "tool": "agents.plan_patch"}, "response": {"data": {"changed": [{"id": "task-new"}], "revision": 13}, "success": true}}, {"description": "Prefer patch_text over full set; if_match_revision from plan_get.", "name": "patch_text on prompt", "request": {"params": {"home": "project", "if_match_revision": 12, "ops": [{"field": "prompt", "id": "task-a", "mode": "search_replace", "op": "patch_text", "replacements": [{"find": "BETA", "replace": "GA"}]}], "project_id": 1}, "tool": "agents.plan_patch"}, "response": {"data": {"changed": [{"id": "task-a"}], "revision": 13}, "success": true}}, {"description": "Reparent a node; equivalent to set {id, parent_id}.", "name": "move subtree", "request": {"params": {"if_match_revision": 12, "ops": [{"id": "task-b", "op": "move", "parent_id": "goal-root"}], "project_id": 1}, "tool": "agents.plan_patch"}, "response": {"data": {"changed": [{"id": "task-b"}, {"id": "goal-root"}], "revision": 13}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Sparse ops with if_match_revision CAS; response is revision + changed[] cards (not full task_list).…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_get", "agents.work_next", "agents.graph_file_put"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plan_graph_validation_errors": {"archive_purge_required": "Read history with agents.plan_get include_archived=true, then send purge_archived=true on agents.plan_patch. Anything else leaves the archive.", "catalog_path_unsupported": "Point meta.external_list.path at a list, or at an object with items, rows, leads, or results, then retry expand_catalog on that same node id.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_address_required": "Personal home needs a resolved session address. Pass home on the tool and ensure the operator session has user_id before patch.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "import_pack_personal_home_unsupported": "Orchestrator import pack requires home=project; personal session graphs use export/read paths only.", "invalid_heal_mode": "mode must be auto|body_only|migrate_archive_pages|cold_pages|archive_pages|none — match graph_limits.heal_recommended_mode or discovery.describe agents.plan_heal_leaf.", "personal_home_agent_scope_conflict": "Use home=project with scope=agent for an agent private plan leaf, or use home=self|project_self without scope=agent for the session graph.", "plan_claim_owner_conflict": "Node is claimed by another agent — agents.work_next handoff=true or agents.plan_reclaim_stale when the lease expired.", "plan_completion_gates": "Completion predicates are not satisfied — finish child work, waive with meta.completion_waived only when policy allows, or agents.plan_propose repair.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_children_exceeded": "Direct children per parent are capped (32). Flat parent_id storage counts siblings under each parent_id — not total graph nodes. Split into sub-groups or use agents.plan_propose decompose_node.", "plan_graph_dep_cycle": "Dependency cycle detected — remove circular depends_on before patch.", "plan_graph_depth_exceeded": "Plan tree depth exceeded — decompose strategic nodes with agents.plan_propose before adding deeper leaves.", "plan_graph_duplicate_id": "Duplicate node id in patch — use unique ids or nodes_to_update instead of recreate.", "plan_graph_empty_overwrite_refused": "Replacing a non-empty plan with an empty graph is refused — call plan_get, then pass allow_empty_graph and empty_graph_confirmed only when you intend to wipe all nodes.", "plan_graph_node_count": "Open plan has more than 1000 nodes. Archive completed nodes with ops {op:archive,id}. Do not copy them into a parent meta.done_or_dropped. Read them back with agents.plan_get include_archived=true. Large lists belong on a catalog node, not as copies in the graph.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_graph_write_failed": "The graph leaf was not updated. Read agents.plan_get and retry the same ops with if_match_revision set to the current revision.", "plan_hierarchy_cycle": "parent_id hierarchy cycle — fix parent_id chain before patch.", "plan_invalid_transition": "Status transition is not allowed for this node kind — read agents.plan_get and use a valid status path (e.g. pending→ready→in_progress→completed).", "plan_ops_duplicate_id": "add_child node.id already exists — pick a new id or update with set/patch_text.", "plan_ops_meta_key": "set_meta needs key + value (one field per op). Wrong: {op:set_meta,id,meta:{k:v}}. Right: {op:set_meta,id,key:k,value:v} or op set with meta:{k:v}. Bulk meta on set_meta is accepted when meta is a flat object.", "plan_ops_move": "move needs id and parent_id (parent must exist). Same as set {id, parent_id}.", "plan_ops_noop": "set op had no fields besides id — send status, title, parent_id, or use op move.", "plan_ops_parent_missing": "add_child parent_id is not in the graph — create the parent first or fix parent_id. On an empty project graph (revision 0, no tasks), omit parent_id and send {op:add_child, node:{id, title, kind}} with if_match_revision:0 from plan_get; do not use op set for new ids.", "plan_ops_unknown": "Unknown plan_patch op — discovery.describe agents.plan_patch; canonical ops: add_child, set, patch_text, reorder_children, archive. Aliases: add|add_node|insert|create → add_child; update → set.", "plan_patch_nodes_missing_from_changed": "Revision moved but new node ids are absent on plan_get — align generation_env_uuid on context and tool params; deploy compaction protect_ids (undated completed purge); run prelude bucket parents before child ingest batches.", "plan_revision_conflict": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal after concurrent plan_patch or graph_file_*.", "plan_slice_failed": "Narrow node_id, use projection=summary, or lower max_depth — slice could not be built", "replace_refused": "replace:true rewrites the whole graph. Pass replace_confirmed=true only for a full rebuild, otherwise send ops (set, set_meta, add_child, link, archive).", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap."}, "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "agents.work_next", "agents.plan_propose", "agents.graph_file_put", "agents.graph_file_get"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["generation.realign_to_prod"], "safe_action": "agents_plan_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Merge plan graph nodes (deep by id). Pass if_match_revision from plan_get for CAS (fleet/autonomous writers must send it). F1: when auto_generation_mode is on, pass env_uuid from sandbox fork; diff pa", "title": "Patch Plan Graph", "verification": ["agents.plan_get", "agents.graph_health"], "verify": [{"action": "agents.plan_get", "predicate": "named resource is visible"}, {"action": "agents.graph_health", "predicate": "named resource is visible"}], "wave_xix_atoms": {"MCP_DOMAIN_ERROR": "Domain denial: tools/call isError=false with structuredContent (ok=false, error_code, failure_kind=domain, recovery). Transport/internal uses isError=true (failure_kind=transport). plan_revision_conflict → agents.plan_get then retry with fresh if_match_revision.", "WG_CAS_RETRY": "plan_revision_conflict → plan_get reload if_match_revision — never apply stale proposal after concurrent plan_patch or backlog apply.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_PLAN_GRAPH_CHILDREN_CAP": "Max 32 direct children per parent_id (not total graph size). Large flat graphs are valid; split siblings across intermediate feature nodes when one parent exceeds the cap."}, "when_blocked": {"ambiguous_anchor": "patch_text search_replace — longer find, set count, or graph_file_get text window", "archive_purge_required": "Read history with agents.plan_get include_archived=true, then send purge_archived=true on agents.plan_patch. Anything else leaves the archive.", "catalog_path_unsupported": "Point meta.external_list.path at a list, or at an object with items, rows, leads, or results, then retry expand_catalog on that same node id.", "content_shrink_blocked": "replace would shrink a plan text field — use search_replace or allow_shrink", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "execution_error": "Unexpected patch failure — inspect message and trace_id", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_address_required": "Personal home needs a resolved session address. Pass home on the tool and ensure the operator session has user_id before patch.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "import_pack_personal_home_unsupported": "Orchestrator import pack requires home=project; personal session graphs use export/read paths only.", "invalid_heal_mode": "mode must be auto|body_only|migrate_archive_pages|cold_pages|archive_pages|none — match graph_limits.heal_recommended_mode or discovery.describe agents.plan_heal_leaf.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "invalid_state_transition": "agents.plan_get node status — legal FSM only; completed↔cancelled retries are no-ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "unified_diff on patch_text did not apply — re-read plan_get", "patch_too_large": "unified_diff exceeds size cap on patch_text", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "personal_home_agent_scope_conflict": "Use home=project with scope=agent for an agent private plan leaf, or use home=self|project_self without scope=agent for the session graph.", "plan_claim_owner_conflict": "agents.work_next handoff=true — another operator holds the lease", "plan_completion_gates": "Completion predicates are not satisfied — finish child work, waive with meta.completion_waived only when policy allows, or agents.plan_propose repair.", "plan_dependency_cycle": "Dependency cycle detected — remove circular depends_on before patch.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_children_exceeded": "Direct children per parent are capped (32). Flat parent_id storage counts siblings under each parent_id — not total graph nodes. Split into sub-groups or use agents.plan_propose decompose_node.", "plan_graph_dep_cycle": "Dependency cycle detected — remove circular depends_on before patch.", "plan_graph_depth_exceeded": "Plan tree depth exceeded — decompose strategic nodes with agents.plan_propose before adding deeper leaves.", "plan_graph_duplicate_id": "Duplicate node id in patch — use unique ids or nodes_to_update instead of recreate.", "plan_graph_empty_overwrite_refused": "Replacing a non-empty plan with an empty graph is refused — call plan_get, then pass allow_empty_graph and empty_graph_confirmed only when you intend to wipe all nodes.", "plan_graph_load_failed": "DNA/graph slice failed to load — plan_get (compact) then retry. If patch used a long title (>256), use patch_text or shorten title; see validation_error + field=title instead of this code when preflight maps PGVE.", "plan_graph_node_count": "Open plan has more than 1000 nodes. Archive completed nodes with ops {op:archive,id}. Do not copy them into a parent meta.done_or_dropped. Read them back with agents.plan_get include_archived=true. Large lists belong on a catalog node, not as copies in the graph.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_graph_write_failed": "The graph leaf was not updated. Read agents.plan_get and retry the same ops with if_match_revision set to the current revision.", "plan_hierarchy_cycle": "parent_id hierarchy cycle — fix parent_id chain before patch.", "plan_invalid_transition": "Status transition is not allowed for this node kind — read agents.plan_get and use a valid status path (e.g. pending→ready→in_progress→completed).", "plan_ops_duplicate_id": "add_child node.id already exists — pick a new id or update with set/patch_text.", "plan_ops_meta_key": "set_meta needs key + value (one field per op). Wrong: {op:set_meta,id,meta:{k:v}}. Right: {op:set_meta,id,key:k,value:v} or op set with meta:{k:v}. Bulk meta on set_meta is accepted when meta is a flat object.", "plan_ops_move": "move needs id and parent_id (parent must exist). Same as set {id, parent_id}.", "plan_ops_noop": "set op had no fields besides id — send status, title, parent_id, or use op move.", "plan_ops_parent_missing": "add_child parent_id is not in the graph — create the parent first or fix parent_id. On an empty project graph (revision 0, no tasks), omit parent_id and send {op:add_child, node:{id, title, kind}} with if_match_revision:0 from plan_get; do not use op set for new ids.", "plan_ops_storage_ref": "append_storage_ref ref invalid", "plan_ops_text_domain": "patch_text id outside domain guard", "plan_ops_text_field": "patch_text field must be prompt|detail|objective|title or meta.*", "plan_ops_text_mode": "Unsupported patch_text mode or empty replacements", "plan_ops_unknown": "Unknown plan_patch op — discovery.describe agents.plan_patch; canonical ops: add_child, set, patch_text, reorder_children, archive. Aliases: add|add_node|insert|create → add_child; update → set.", "plan_patch_inline_body_spill": "Inline prose exceeds chunk seal — agents.graph_file_put; follow spill recovery in error data", "plan_patch_nodes_missing_from_changed": "Revision moved but new node ids are absent on plan_get — align generation_env_uuid on context and tool params; deploy compaction protect_ids (undated completed purge); run prelude bucket parents before child ingest batches.", "plan_patch_ops_limit": "Too many ops[] in one plan_patch — split batches; plan_get between writes (max 50)", "plan_patch_unknown_fields": "strict_schema rejected unknown task fields — use allowed_task_fields list", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "plan_slice_failed": "Narrow node_id, use projection=summary, or lower max_depth — slice could not be built", "replace_refused": "replace:true rewrites the whole graph. Pass replace_confirmed=true only for a full rebuild, otherwise send ops (set, set_meta, add_child, link, archive).", "replacement_not_found": "search_replace find string absent — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "text_anchor_miss": "fuzzy_replace could not locate anchor", "text_revision_conflict": "patch_text — re-read the field from plan_get; refresh expected_text_sha256", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal"}, "when_not_to_use": "Do not set return_task_list=true — response is revision + changed[]; refresh via work_next compact.", "when_to_use": "Sparse ops with if_match_revision CAS; response is revision + changed[] cards (not full task_list). Preflight: agents.plan_get with node_id + detail=compact (see ops_compact.preflight_read / slice_com", "write_mode": null}, {"action": "agents.plan_pin", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not use plan_pin as a claim or heartbeat. It does not set in_progress.", "anti_patterns": ["Do not use plan_pin as a claim or heartbeat. It does not set in_progress."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_pin", "mutation_risk": "low", "related_tools": ["agents.plan_claim", "agents.plan_get", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Pin"}, "do_not_use_when": "Do not use plan_pin as a claim or heartbeat. It does not set in_progress.", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Write goal pin_inventory (pin, unpin, collapse, expand) without a claim lease and without WIP. Use …", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_claim", "agents.plan_get", "agents.work_next"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_claim", "agents.plan_get", "agents.work_next"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_pin", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Write goal pin_inventory without claiming a node or consuming WIP. Same pin/unpin/collapse/expand params as plan_claim heartbeat, minus the lease.", "title": "Agents Plan Pin", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not use plan_pin as a claim or heartbeat. It does not set in_progress.", "when_to_use": "Write goal pin_inventory (pin, unpin, collapse, expand) without a claim lease and without WIP. Use when plan_claim heartbeat is refused because the node is not in_progress or the project is at the WIP", "write_mode": null}, {"action": "agents.plan_claim", "aliases": ["work.claim"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not claim planning_artifact nodes (evidence_only) — attach evidence on parent.", "anti_patterns": ["Do not claim planning_artifact nodes (evidence_only) — attach evidence on parent.", "specialization_mismatch requires handoff, not repeated claim with same agent.", "Do not treat bound agent_id alone as already_claimed — check in_progress lease meta (H11)."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_claim", "mutation_risk": "low", "related_tools": ["agents.plan_get", "agents.plan_execute", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Plan Claim"}, "do_not_use_when": "Do not claim planning_artifact nodes (evidence_only) — attach evidence on parent.", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"agent_id": "agent_example", "if_match_revision": 1, "node_ids": ["plan_leaf_example"], "prefer_agent_id": "agent_example"}, "example_request": {"action": "agents.plan_claim", "params": {"agent_id": "agent_example", "if_match_revision": 1, "node_ids": ["plan_leaf_example"], "prefer_agent_id": "agent_example"}}, "examples": [{"name": "CAS claim one node", "request": {"params": {"agent_id": "619b1939-0000-4000-8000-000000000001", "if_match_revision": 12, "node_ids": ["task-a"], "project_id": 1}, "tool": "agents.plan_claim"}, "response": {"data": {"claimed": ["task-a"], "previous_revision": 12, "revision": 13}, "success": true}}, {"description": "role_mismatch and specialization_mismatch attach recovery_block with agents.work_next handoff=true. This is fleet eligibility, not an API-key cap.", "name": "Role mismatch with recovery_block", "request": {"params": {"agent_id": "619b1939-0000-4000-8000-000000000002", "if_match_revision": 12, "node_ids": ["task-architect"], "project_id": 1}, "tool": "agents.plan_claim"}, "response": {"data": {"recovery_block": {"next_actions": [{"action": "agents.work_next", "params": {"focus_node_id": "task-architect", "handoff": true, "project_id": 1}}], "reason": "role_mismatch"}}, "error_code": "role_mismatch", "success": false}}], "execution_class": "cheap", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Requires mcp_write (hidden from read-only catalog). Read-only keys: follow packet.next_action from …", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_execute", "agents.work_next"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "agents.plan_execute", "agents.work_next"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_claim", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Claim pending plan leaves as in_progress for one agent (parallel work, WIP capped). Server-managed on claim: status, agent_id, meta.claimed_at|lease_until|heartbeat_at. Preserves title/objective/predi", "title": "Claim Plan Node", "wave_xix_atoms": {"MCP_DOMAIN_ERROR": "Domain denial: tools/call isError=false with structuredContent (ok=false, error_code, failure_kind=domain, recovery). Transport/internal uses isError=true (failure_kind=transport). plan_revision_conflict → agents.plan_get then retry with fresh if_match_revision.", "WG_BIND_VS_CLAIM": "node.agent_id binding ≠ active claim lease — already_claimed requires status=in_progress with non-expired lease meta; bound agent on ready/pending is not already_claimed; retry ensure_agent idempotent_replay or plan_claim with if_match_revision.", "WG_BLOCKED_REASON": "blocked_work[].blocked_reason is canonical (block_reason.REASON_PRIORITY); use recovery.next_actions — not validation.missing_roles.", "WG_CAPABILITY_HARD_GATE": "required_capabilities are mandatory — capability_mismatch blocks claim; route agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan; not handoff (capability_hard_gate_v1).", "WG_CAS_RETRY": "plan_revision_conflict → plan_get reload if_match_revision — never apply stale proposal after concurrent plan_patch or backlog apply.", "WG_CLAIM_BEFORE_EXECUTE": "agents.plan_execute requires an active claim lease from agents.plan_claim unless operator policy allows execute-without-claim; pass if_match_revision from plan_get.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_HANDOFF_RECOVERY": "role_mismatch / specialization_mismatch after claim → work_next handoff=true node_id=… — follow recovery.next_actions, do not retry same agent. capability_mismatch is missing required_capabilities: repair_plan or ensure_agent, not handoff.", "WG_PLANNING_ARTIFACT": "meta.planning_artifact nodes are evidence-only (resolution=non_executable_artifact) — attach evidence on parent; plan_process_backlog and claim skip them for execution."}, "when_blocked": {"capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "claim_empty": "agents.work_next handoff=true — no nodes claimed; refresh claimable set", "claim_heartbeat_failed": "No active in_progress lease for node_id — plan_claim the node before heartbeat_only pin ops", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "node_not_eligible": "agents.plan_get on the same home — node failed evaluate_work_eligibility; agents.work_next handoff=true and follow recovery.next_actions", "node_not_found": "agents.plan_get include_claimable=true — node_id absent from graph slice", "not_executable": "kind note and catalog are memory, not work. Do not plan_claim them. Claim a task, step, or issue on the same home.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "pin_inventory_full": "Goal pin inventory at active_max — unpin a slot (plan affinity) then retry agents.plan_claim", "pin_slot_not_found": "No matching goal pin slot for skill_id and agent_id — agents.plan_get pin_slots then retry", "plan_claim_owner_conflict": "agents.work_next handoff=true — another operator holds the lease", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "role_mismatch": "work_next handoff=true node_id=… — do not retry same agent", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "skill_mismatch": "agents.work_next handoff=true — skill_ids mismatch; follow recovery.next_actions", "specialization_mismatch": "work_next handoff=true — follow recovery.next_actions", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wip_full": "Agent WIP cap reached — agents.plan_get then complete/release in_progress claims; retry plan_claim"}, "when_not_to_use": "Do not claim planning_artifact nodes (evidence_only) — attach evidence on parent.", "when_to_use": "Requires mcp_write (hidden from read-only catalog). Read-only keys: follow packet.next_action from agents.work_next — do not call claim unless next_action is agents.plan_claim and the key has mcp_writ", "write_mode": null}, {"action": "agents.plan_release", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.plan_release", "related_tools": ["agents.plan_claim", "agents.plan_get", "agents.plan_reclaim_stale", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Release"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Voluntary release of your own in_progress claim (DNA mutating). Use when wip_full blocks new plan_c…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_claim", "agents.plan_get", "agents.work_next"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_claim", "agents.plan_get", "agents.plan_reclaim_stale", "agents.work_next"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_release", "semantic_input_mode": "inherit_workflow", "summary": "Release your own in_progress plan claim (voluntary). Use when wip_full blocks new work and the lease is still yours.", "title": "Agents Plan Release", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Voluntary release of your own in_progress claim (DNA mutating). Use when wip_full blocks new plan_claim but the lease is still yours — not for expired leases (agents.plan_reclaim_stale). home=project|", "write_mode": null}, {"action": "agents.plan_heal_leaf", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.plan_heal_leaf", "related_tools": ["agents.plan_compaction_preview", "agents.graph_health", "agents.plan_get", "agents.plan_patch", "agents.work_next", "agents.graph_file_put"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Heal Leaf"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Preview spill/compact before apply when graph_health reports spill_incomplete", "request": {"dry_run": true, "home": "project", "project_id": 1}, "response": {"data": {"bytes_after": 95000, "bytes_before": 120000, "dry_run": true, "healed": false, "home": "project", "reason": "leaf_within_budget"}, "success": true}}, {"description": "Archive-only heal when graph_limits.heal_recommended_mode is migrate_archive_pages (alias archive_pages).", "request": {"dry_run": true, "home": "project", "mode": "migrate_archive_pages", "project_id": 1}, "response": {"data": {"archive_migrated": 12, "dry_run": true, "healed": true, "home": "project", "mode": "migrate_archive_pages"}, "success": true}}, {"description": "Apply body spill without cold_page seal when mode=body_only (mcp_community_hub_v1 step 5b)", "request": {"dry_run": false, "home": "project_self", "mode": "body_only", "project_id": 1}, "response": {"data": {"bytes_after": 92000, "bytes_before": 180000, "dry_run": false, "healed": true, "home": "project_self", "mode": "body_only"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Compact aged terminals and spill fat bodies to storage/.../work_graph/chunks (DNA mutating, no sema…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.work_next", "agents.plan_patch", "agents.graph_file_put"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_compaction_preview", "agents.graph_health", "agents.plan_get", "agents.plan_patch", "agents.work_next", "agents.graph_file_put"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_heal_leaf", "semantic_input_mode": "inherit_workflow", "summary": "Compact aged terminals and spill heavy node bodies into work_graph/chunks storage without changing plan semantics. Use when graph_limits.spill_incomplete, plan_graph_bytes_high advisories, or plan_gra", "title": "Agents Plan Heal Leaf", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "execution_error": "Unexpected heal failure — inspect message and trace_id", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_heal_mode": "mode must be auto|body_only|migrate_archive_pages|cold_pages|archive_pages|none — match graph_limits.heal_recommended_mode or discovery.describe agents.plan_heal_leaf.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_load_failed": "DNA/graph slice failed to load — plan_get (compact) then retry. If patch used a long title (>256), use patch_text or shorten title; see validation_error + field=title instead of this code when preflight maps PGVE.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_graph_write_failed": "The graph leaf was not updated. Read agents.plan_get and retry the same ops with if_match_revision set to the current revision.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "plan_slice_failed": "Narrow node_id, use projection=summary, or lower max_depth — slice could not be built", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compact aged terminals and spill fat bodies to storage/.../work_graph/chunks (DNA mutating, no semantic ops). Triggers when graph_limits.needs_leaf_heal (~400KiB+) or spill_incomplete (still over 512K", "write_mode": null}, {"action": "agents.plan_compaction_preview", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.plan_compaction_preview", "related_tools": ["agents.graph_health", "agents.plan_get", "agents.plan_heal_leaf", "agents.plan_patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Compaction Preview"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Read-only aged-terminal drop estimate before agents.plan_heal_leaf apply", "request": {"home": "project", "project_id": 1}, "response": {"data": {"compaction_preview": {"aged_terminal_ids": [], "bytes_saved_estimate": 0}, "home": "project", "project_id": 1}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Read-only aged-terminal + byte-pressure preview — run before agents.plan_heal_leaf (same math as ag…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_heal_leaf", "agents.graph_health"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.graph_health", "agents.plan_get", "agents.plan_heal_leaf", "agents.plan_patch"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_plan_compaction_preview", "semantic_input_mode": "inherit_workflow", "summary": "Read-only preview of aged-terminal compaction (same math as agents.graph_health compaction_preview). No DNA write.", "title": "Agents Plan Compaction Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only aged-terminal + byte-pressure preview — run before agents.plan_heal_leaf (same math as agents.graph_health compaction_preview).", "write_mode": null}, {"action": "agents.plan_archive_branch", "ai_tips": "Archive a subtree by root_id — dry_run=true for archive_ids and bytes_saved_estimate; apply uses plan_patch op archive (id, not node_id). When live_child_count>0 pass reparent_live_to or archive leaves first.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_override": {"conditional_mutate": "dry_run=true returns archive_ids only; dry_run=false applies plan_patch archive.", "effect_depends_on_params": true, "mutates_when": {"dry_run": false}}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.plan_archive_branch", "mutates_when": {"dry_run": false}, "mutation_risk": "low", "related_tools": ["agents.plan_patch", "agents.plan_get", "agents.graph_health", "agents.plan_compaction_preview"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Archive Branch"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true returns archive_ids only; dry_run=false applies plan_patch archive.", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "dry_run=true returns archive_ids only; dry_run=false applies plan_patch archive.", "effect_depends_on_params": true, "mutates_when": {"dry_run": false}}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Archive a subtree by root_id — dry_run=true for archive_ids and bytes_saved_estimate; apply uses pl…", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_patch", "agents.plan_get", "agents.graph_health", "agents.plan_compaction_preview"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_archive_branch", "semantic_input_mode": "inherit_workflow", "summary": "Preview or apply archive for a plan subtree (root_id). dry_run=true returns archive_ids and bytes_saved_estimate; apply sends plan_patch archive ops.", "title": "Agents Plan Archive Branch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Archive a subtree by root_id — dry_run=true for archive_ids and bytes_saved_estimate; apply uses plan_patch op archive (id, not node_id). When live_child_count>0 pass reparent_live_to or archive leave", "write_mode": null}, {"action": "agents.plan_reclaim_stale", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not substitute for plan_recovery_scan (read-only candidates).", "anti_patterns": ["Do not substitute for plan_recovery_scan (read-only candidates).", "Do not use when work_next already routes plan_claim — follow packet next_action."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_reclaim_stale", "mutation_risk": "low", "related_tools": ["agents.plan_get", "agents.plan_claim", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Reclaim Stale"}, "do_not_use_when": "Do not substitute for plan_recovery_scan (read-only candidates).", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Preview stale claims after work_next expired_claim recovery branch", "request": {"dry_run": true, "home": "project_self", "project_id": 1}, "response": {"data": {"dry_run": true, "home": "project_self", "node_ids": ["n-stale-1"], "reclaimed_count": 1}, "success": true}}], "execution_class": "cheap", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Clear expired in_progress plan_claim leases (DNA mutating). Use after expired_claim / stale lease f…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_get", "agents.plan_claim", "agents.work_next"], "onboarding_tier": "domain_playbook", "operator_recovery_template": {"expired_claim": {"claim": {"action": "agents.plan_claim", "params": {"env_uuid": "<env_uuid_if_sandbox>", "home": "project", "if_match_revision": "<revision>", "node_ids": ["<node_id>"]}}, "reclaim": {"action": "agents.plan_reclaim_stale", "params": {"env_uuid": "<env_uuid_if_sandbox>", "home": "project"}}, "refresh": {"action": "agents.plan_get", "params": {"detail": "compact", "env_uuid": "<env_uuid_if_sandbox>", "home": "project", "if_match_revision": "<revision>"}}}}, "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "agents.plan_claim", "agents.work_next"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_reclaim_stale", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Return in_progress plan nodes with expired claim lease to ready (or pending if not eligible). Clears agent_id + lease meta; stamps meta.last_claim. Mutating DNA write — not read-only.", "title": "Reclaim Stale Claims", "wave_xix_atoms": {"MCP_DOMAIN_ERROR": "Domain denial: tools/call isError=false with structuredContent (ok=false, error_code, failure_kind=domain, recovery). Transport/internal uses isError=true (failure_kind=transport). plan_revision_conflict → agents.plan_get then retry with fresh if_match_revision.", "WG_BIND_VS_CLAIM": "node.agent_id binding ≠ active claim lease — already_claimed requires status=in_progress with non-expired lease meta; bound agent on ready/pending is not already_claimed; retry ensure_agent idempotent_replay or plan_claim with if_match_revision.", "WG_CAS_RETRY": "plan_revision_conflict → plan_get reload if_match_revision — never apply stale proposal after concurrent plan_patch or backlog apply.", "WG_CLOSED_LOOP_STALE_CLAIM": "blocked_reason=expired_claim — next_action agents.plan_reclaim_stale; beats downstream dependency_blocked when no executable leaf.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not substitute for plan_recovery_scan (read-only candidates).", "when_to_use": "Clear expired in_progress plan_claim leases (DNA mutating). Use after expired_claim / stale lease from work_next — then plan_get + plan_claim with fresh if_match_revision. Omit env_uuid: reads generat", "write_mode": null}, {"action": "agents.plan_ingest", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_ingest", "mutation_risk": "low", "related_tools": ["agents.plan_get", "agents.plan_execute", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Ingest"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Append diagnostic or work-intake findings as stable graph nodes (no full-blob replace). home=projec…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_get", "agents.plan_execute", "agents.work_next"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "agents.plan_execute", "agents.work_next"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_ingest", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Append diagnostic or work-intake findings as plan/Work Graph tasks. intake_mode=diagnostic (default) or work. Existing claimed nodes are left alone; matching issues bump occurrence_count.", "title": "Ingest Plan Work", "wave_xix_atoms": {"MCP_DOMAIN_ERROR": "Domain denial: tools/call isError=false with structuredContent (ok=false, error_code, failure_kind=domain, recovery). Transport/internal uses isError=true (failure_kind=transport). plan_revision_conflict → agents.plan_get then retry with fresh if_match_revision.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_PLANNING_ARTIFACT": "meta.planning_artifact nodes are evidence-only (resolution=non_executable_artifact) — attach evidence on parent; plan_process_backlog and claim skip them for execution."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append diagnostic or work-intake findings as stable graph nodes (no full-blob replace). home=project|self|project_self selects the leaf; env_uuid only with home=project. Follow with agents.plan_execut", "write_mode": null}, {"action": "agents.run_resume_packet", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.run_resume_packet", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Run Resume Packet"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "User says continue; new MCP client resumes an orchestration run.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_run_resume_packet", "semantic_input_mode": "inherit_workflow", "summary": "Cross-provider continuation: goal, step, packet, skills — no chat transcript.", "title": "Agents Run Resume Packet", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "User says continue; new MCP client resumes an orchestration run.", "write_mode": null}, {"action": "agents.run_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not use discovery.job_status for Agents Fleet runs — use agents.run_get with run_id.", "anti_patterns": ["Do not use discovery.job_status for Agents Fleet runs — use agents.run_get with run_id.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.run_get", "related_tools": ["agents.approve_run", "agents.traces"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Run Get"}, "do_not_use_when": "Do not use discovery.job_status for Agents Fleet runs — use agents.run_get with run_id.", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Inspect one fleet run by run_id (agent_id optional when run_id is set). Poll status here — not disc…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.approve_run", "agents.traces"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.approve_run", "agents.traces"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_run_get", "semantic_input_mode": "inherit_workflow", "summary": "Get a run row plus normalized RunDetailDTO for cockpit/audit views.", "title": "Agents Run Get", "when_blocked": {"agent_not_found": "agent_id not in project fleet — use agents.team or plan_get before run_get.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "run_mismatch": "run_id does not belong to the supplied agent_id — omit agent_id or fix the pair.", "run_not_found": "No run row for run_id in this project — verify run_id from agents.run or traces.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "waiting_for_approval": "Run status waiting_for_approval — agents.approve_run with approval_artifact_hash from run_detail."}, "when_not_to_use": "Do not use discovery.job_status for Agents Fleet runs — use agents.run_get with run_id.", "when_to_use": "Inspect one fleet run by run_id (agent_id optional when run_id is set). Poll status here — not discovery.job_status. waiting_for_approval → agents.approve_run. Read run_detail.output.attachments (and", "write_mode": null}, {"action": "agents.approve_run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.approve_run", "mutation_risk": "low", "related_tools": ["agents.run_get", "agents.traces"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Approve Run"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Human checkpoint after agents.run_get shows waiting_for_approval. Pass the hash from that response.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.run_get", "agents.traces"], "required_cap": "agents_run|agents_approve", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_approve_run", "semantic_input_mode": "inherit_workflow", "summary": "Approve a run stuck in waiting_for_approval and resume execution.", "title": "Agents Approve Run", "when_blocked": {"approval_hash_mismatch": "agents.run_get — approval_artifact_hash must match pending tool call on the run", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "run_not_found": "No run row for run_id in this project — verify run_id from agents.run or traces.", "run_not_waiting_for_approval": "agents.run_get — run is not waiting_for_approval; poll status before approve_run", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Human checkpoint after agents.run_get shows waiting_for_approval. Pass the hash from that response.", "write_mode": null}, {"action": "agents.policy_preview", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.policy_preview", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Policy Preview"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "example_params": {"approval_required_actions": [], "capabilities": [], "forbidden_tools": [], "project_id": 123, "union_discovery_shelf": true}, "example_request": {"action": "agents.policy_preview", "params": {"approval_required_actions": [], "capabilities": [], "forbidden_tools": [], "project_id": 123, "union_discovery_shelf": true}}, "examples": [{"name": "Allowlist preview", "request": {"params": {"capabilities": ["agents.run", "knowledge.health"], "forbidden_tools": ["agents.delete"], "project_id": 1}, "tool": "agents.policy_preview"}, "response": {"data": {"denied": [], "effective_actions": []}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "UI live preview while editing AgentPolicy; debug effective allowlist.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_policy_preview", "semantic_input_mode": "inherit_workflow", "summary": "Expand AgentPolicy patterns to live MCP actions (preview, no persistence).", "title": "Agents Policy Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "UI live preview while editing AgentPolicy; debug effective allowlist.", "write_mode": null}, {"action": "agents.templates_list", "aliases": ["agents.templates"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.templates_list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Templates List"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Built-in catalog", "request": {"params": {"project_id": 1}, "tool": "agents.templates_list"}, "response": {"data": {"templates": []}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Discover template_id before agents.create_from_template.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_templates_list", "semantic_input_mode": "inherit_workflow", "summary": "List built-in Agent Fleet templates (canonical Python catalog).", "title": "List Agent Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover template_id before agents.create_from_template.", "write_mode": null}, {"action": "agents.template_preview", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.template_preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Template Preview"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Non-persisting merge", "request": {"params": {"project_id": 1, "template_id": "frontend_developer@v1"}, "tool": "agents.template_preview"}, "response": {"data": {"agent_spec": {}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Show users what a template will apply before create.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_template_preview", "semantic_input_mode": "inherit_workflow", "summary": "Return merged AgentSpec-shaped preview for a template (no persistence).", "title": "Preview Agent Template", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Show users what a template will apply before create.", "write_mode": null}, {"action": "agents.create_from_template", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Use only when ensure_agent is ambiguous. Plan drafts stay on agents.plan_propose. Canonical provision is ensure_agent create=false then create=true.", "anti_patterns": ["Use only when ensure_agent is ambiguous. Plan drafts stay on agents.plan_propose. Canonical provision is ensure_agent cr", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.create_from_template", "mutation_risk": "low", "related_tools": ["agents.get", "agents.ensure_agent", "agents.plan_claim", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Create From Template"}, "do_not_use_when": "Use only when ensure_agent is ambiguous. Plan drafts stay on agents.plan_propose. Canonical provision is ensure_agent create=false then create=true.", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Spawn fleet row from template_id; optional node_id bind (ensure_agent uses plan_claim instead).", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["agents.ensure_agent", "agents.plan_claim", "agents.work_next"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.get", "agents.ensure_agent", "agents.plan_claim", "agents.work_next"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_create_from_template", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create an agent row from a built-in template (atomic merge on server). Fleet catalog rows are production-scoped; env_uuid applies when node_id binds the new agent onto a sandbox plan slice.", "title": "Create Agent from Template", "wave_xix_atoms": {"WG_ENSURE_H5": "agents.ensure_agent preview template_id must match agents.work_next top compatible_templates[0] for the same node (harness H5 / resolver_parity_v1).", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_PROVISION_PARITY": "When execution.fully_provisionable and one top template, recovery routes agents.ensure_agent create=false (H5 preview) — SDK followWorkGraphAction runs ensureAgentSaga for create=true; ambiguous ties → create_from_template choose_template."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "env_uuid_requires_node_id": "env_uuid only when binding node_id on a plan slice", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "invalid_template_id": "Unknown template_id in catalog", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be created under an open sandbox head without diff-child bootstrap (AA-10b). Fork generation env or clear head; then use scoped create overlay.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_not_to_use": "Use only when ensure_agent is ambiguous. Plan drafts stay on agents.plan_propose. Canonical provision is ensure_agent create=false then create=true.", "when_to_use": "Spawn fleet row from template_id; optional node_id bind (ensure_agent uses plan_claim instead).", "write_mode": null}, {"action": "agents.ensure_agent", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "When resolution=existing_agent prefer recovery.next_action / idempotent_replay or plan_claim — do not re-provision blindly.", "anti_patterns": ["When resolution=existing_agent prefer recovery.next_action / idempotent_replay or plan_claim — do not re-provision blind", "Do not call create=true without previewing template_id (H5 parity with work_next)."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"create": true}, "semantic_input_mode": "inherit_workflow"}, "effect_override": {"conditional_mutate": "create=false previews templates; create=true provisions fleet agent then plan_claim.", "effect_depends_on_params": true, "mutates_when": {"create": true}}, "execution_class": "cheap", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.ensure_agent", "mutates_when": {"create": true}, "mutation_risk": "low", "related_tools": ["agents.work_next", "agents.plan_get", "agents.plan_claim"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Ensure Agent"}, "do_not_use_when": "When resolution=existing_agent prefer recovery.next_action / idempotent_replay or plan_claim — do not re-provision blindly.", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "create=false previews templates; create=true provisions fleet agent then plan_claim.", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "mutates_when": {"create": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "create=false previews templates; create=true provisions fleet agent then plan_claim.", "effect_depends_on_params": true, "mutates_when": {"create": true}}, "examples": [{"name": "Preview blocked executor", "request": {"params": {"create": false, "node_id": "task-b", "project_id": 1}, "tool": "agents.ensure_agent"}, "response": {"data": {"agent_id": null, "blocked_reason": "provision_required", "created": false, "node_id": "task-b", "template_id": "frontend_developer@v1"}, "success": true}}, {"description": "After work_next recovery routes here, create=true binds a fleet agent to the node.", "name": "Provision with create=true", "request": {"params": {"create": true, "node_id": "task-b", "project_id": 1}, "tool": "agents.ensure_agent"}, "response": {"data": {"agent_id": "619b1939-0000-4000-8000-000000000003", "created": true, "node_id": "task-b"}, "success": true}}], "execution_class": "cheap", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Commit-last provision: preview create=false (H5) → create=true (bind_node=False, explicit consent) …", "kind": "mcp_domain", "ladder": ["agents.plan_claim — CAS revision; role_mismatch → handoff not retry loop", "agents.plan_execute — only after claim; attach evidence for completion_predicates"], "mutation_kind": "none", "next_actions": ["agents.plan_claim"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "recovery_ladder": ["agents.plan_compaction_preview → agents.plan_heal_leaf (dry_run then apply) — spill_incomplete or plan_graph_too_large", "agents.plan_recovery_scan — verification_failed candidates + stale claims; optional env_uuid"], "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.work_next", "agents.plan_get", "agents.plan_claim"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_ensure_agent", "semantic_input_mode": "inherit_workflow", "summary": "Resolve or provision a plan-node executor. Read-only by default (effect.kind=read); create=true provisions from top compatible template with bind_node=False, validates eligibility, then returns next_a", "title": "Ensure Plan Executor", "wave_xix_atoms": {"MCP_DOMAIN_ERROR": "Domain denial: tools/call isError=false with structuredContent (ok=false, error_code, failure_kind=domain, recovery). Transport/internal uses isError=true (failure_kind=transport). plan_revision_conflict → agents.plan_get then retry with fresh if_match_revision.", "WG_BIND_VS_CLAIM": "node.agent_id binding ≠ active claim lease — already_claimed requires status=in_progress with non-expired lease meta; bound agent on ready/pending is not already_claimed; retry ensure_agent idempotent_replay or plan_claim with if_match_revision.", "WG_BLOCKED_REASON": "blocked_work[].blocked_reason is canonical (block_reason.REASON_PRIORITY); use recovery.next_actions — not validation.missing_roles.", "WG_CAPABILITY_HARD_GATE": "required_capabilities are mandatory — capability_mismatch blocks claim; route agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan; not handoff (capability_hard_gate_v1).", "WG_CAS_RETRY": "plan_revision_conflict → plan_get reload if_match_revision — never apply stale proposal after concurrent plan_patch or backlog apply.", "WG_ENSURE_CREATE_SAGA": "Commit-last provision: work_next blocked → ensure_agent create=false (H5 template_id) → create=true provisions with bind_node=False → eligibility gate → rollback on created_agent_not_eligible → next_action agents.plan_claim (bind+lease, if_match_revision); idempotent_replay when bound eligible agent exists.", "WG_ENSURE_H5": "agents.ensure_agent preview template_id must match agents.work_next top compatible_templates[0] for the same node (harness H5 / resolver_parity_v1).", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_PROVISION_PARITY": "When execution.fully_provisionable and one top template, recovery routes agents.ensure_agent create=false (H5 preview) — SDK followWorkGraphAction runs ensureAgentSaga for create=true; ambiguous ties → create_from_template choose_template.", "WG_ROLE_TAXONOMY": "no_compatible_agent for role=data|data_engineer is a taxonomy alias — prefer agents.ensure_agent create=false (H5) then create=true before repair_plan; create_from_template only when ensure_agent is ambiguous; role_matches_template in role_taxonomy.py is SoT."}, "when_blocked": {"capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "created_agent_not_eligible": "Provision rolled back — plan_propose mode=repair_plan or pick template with matching caps (H5)", "ensure_agent_stamp_mismatch": "Replay create=false preview; create=true must match preview_template_id + graph_revision", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_compatible_agent": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_focus_invalid": "agents.work_next detail=compact — refresh focus_node_id from packet next_action", "provision_required": "ensure_agent create=false (H5) then create=true then plan_claim", "provisioning_failed": "create_from_template or bind failed — retry agents.ensure_agent create=false (H5) then create=true", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "template_not_found": "agents.templates_list — template_id missing from catalog; agents.template_preview before create=true", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "When resolution=existing_agent prefer recovery.next_action / idempotent_replay or plan_claim — do not re-provision blindly.", "when_to_use": "Commit-last provision: preview create=false (H5) → create=true (bind_node=False, explicit consent) → eligibility gate → next_action plan_claim with if_match_revision; idempotent_replay on retry.", "write_mode": null}, {"action": "agents.automation_map", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.automation_map", "related_tools": ["agents.list", "logic.list", "social.support.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Automation Map"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Project automation hub", "request": {"params": {"project_id": 1}, "tool": "agents.automation_map"}, "response": {"data": {"agents": [], "support_bindings": [], "workflows": []}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Orchestration hub map before wiring agents to Logic or support.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.list", "logic.list", "social.support.inbox"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_automation_map", "semantic_input_mode": "inherit_workflow", "summary": "Fleet automation aggregate: triggers, Logic rule ids, support ownership.", "title": "Agents Automation Map", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Orchestration hub map before wiring agents to Logic or support.", "write_mode": null}, {"action": "agents.import_from_asset", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Importing fleet preset without generation.diff when auto_generation_mode is on.", "anti_patterns": ["Importing fleet preset without generation.diff when auto_generation_mode is on.", "Passing env_uuid when home is project_self or self.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.import_from_asset", "mutation_risk": "low", "related_tools": ["agents.get", "agents.run", "assets.get", "projects.orchestrator.import_from_asset"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Import From Asset"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Fulfill purchased agent template asset into Fleet.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.get", "agents.run", "assets.get", "projects.orchestrator.import_from_asset"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_import_from_asset", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create agent from commerce asset extensions.agent_fleet preset.", "title": "Agents Import From Asset", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be created under an open sandbox head without diff-child bootstrap (AA-10b). Fork generation env or clear head; then use scoped create overlay.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Fulfill purchased agent template asset into Fleet.", "write_mode": null}, {"action": "agents.fleet_diagnostics", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.fleet_diagnostics", "related_tools": ["agents.reconcile_binding", "agents.work_next", "agents.plan_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Fleet Diagnostics"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Fleet + orchestrator binding triage. On stale_orchestrator_binding_count or index mismatch, success…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.reconcile_binding", "agents.work_next", "agents.plan_get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.reconcile_binding", "agents.work_next", "agents.plan_get"], "required_cap": "agents_run", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_fleet_diagnostics", "semantic_input_mode": "inherit_workflow", "summary": "Project fleet diagnostics: runs, queue, orchestrator agent binding.", "title": "Agents Fleet Diagnostics", "wave_xix_atoms": {"WG_BIND_VS_CLAIM": "node.agent_id binding ≠ active claim lease — already_claimed requires status=in_progress with non-expired lease meta; bound agent on ready/pending is not already_claimed; retry ensure_agent idempotent_replay or plan_claim with if_match_revision.", "WG_DISCOVERY_ROUTE": "Discovery naming: intent_id (taxonomy) ≠ primary_action (router verb) ≠ agents.work_next (fleet pick) — do not treat a route phrase as an MCP action name. discovery.describe requires param action=<catalog action id> (not optional).", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fleet + orchestrator binding triage. On stale_orchestrator_binding_count or index mismatch, success payload includes next_action agents.reconcile_binding (repair=true). home=project|self|project_self", "write_mode": null}, {"action": "agents.skills_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.instruction_plane.gen1"], "id": "agents.skills_list", "related_tools": ["agents.skills_get", "agents.skills_preview", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Skills List"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "List skill cards", "request": {"params": {"project_id": 1}, "tool": "agents.skills_list"}, "response": {"data": {"skills": [{"id": "coding.kiss"}]}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Instruction plane — discover skill ids before orchestrate.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.skills_get", "agents.skills_preview", "discovery.describe"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_skills_list", "semantic_input_mode": "inherit_workflow", "summary": "List ecosystem skill cards (fixture + optional ecosystem overlay).", "title": "Agents Skills List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Instruction plane — discover skill ids before orchestrate.", "write_mode": null}, {"action": "agents.skills_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.instruction_plane.gen1"], "id": "agents.skills_get", "related_tools": ["agents.skills_list", "agents.skills_preview", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Skills Get"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Full skill card", "request": {"params": {"project_id": 1, "skill_id": "coding.kiss"}, "tool": "agents.skills_get"}, "response": {"data": {"skill": {"id": "coding.kiss"}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "MCP interop — load procedure text for external agents.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.skills_list", "agents.skills_preview", "discovery.describe"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_skills_get", "semantic_input_mode": "inherit_workflow", "summary": "Fetch one skill card. Procedure text comes back whole until 64000 characters. truncated means chars is longer than text; that prefix is not the procedure to save.", "title": "Agents Skills Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "MCP interop — load procedure text for external agents.", "write_mode": null}, {"action": "agents.skills_preview", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.skills_preview", "related_tools": ["agents.skills_get", "agents.skills_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Skills Preview"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Preview excerpts", "request": {"params": {"project_id": 1, "skill_ids": ["coding.kiss"]}, "tool": "agents.skills_preview"}, "response": {"data": {"previews": [{"id": "coding.kiss"}]}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Compose packet skill_preview without full bodies.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.skills_get", "agents.skills_list"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_skills_preview", "semantic_input_mode": "inherit_workflow", "summary": "Short skill preview for instruction packet (title + excerpt).", "title": "Agents Skills Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compose packet skill_preview without full bodies.", "write_mode": null}, {"action": "agents.team.create", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.orchestrator.gen1"], "id": "agents.team.create", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Team Create"}, "domain_title": "Diagnostics MCP domain", "effect": {"conditional_mutate": "ingest_playbook_plan_nodes on routed team.create goal", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Team/specialist fleet goals — thin wrapper over plan_ingest playbook + optional orchestrate. home=p…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_team_create", "semantic_input_mode": "inherit_workflow", "summary": "Thin wrapper: plan_ingest team template + optional orchestrate focus.", "title": "Agents Team Create", "wave_xix_atoms": {"WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_PLAN_FIRST": "Lightweight progress: agents.work_status (summary_only). Full autonomous loop: agents.work_next — follow next_action, not next_actions[0] parsing.", "WG_TEAM_OVER_INTEGRATION": "Team-create goals (agents.team.create): discovery rank demotes integrations.* — prefer agents.team.create / agents.orchestrate / agents.plan_* over integrations.oauth_begin."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Team/specialist fleet goals — thin wrapper over plan_ingest playbook + optional orchestrate. home=project|self|project_self; env_uuid only with home=project. Prefer over raw integrations.oauth_begin f", "write_mode": null}, {"action": "agents.plan_execute", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not execute without claim lease unless operator policy allows.", "anti_patterns": ["Do not execute without claim lease unless operator policy allows."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.agents.orchestrator.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_execute", "mutation_risk": "low", "recovery_blocks": {"orchestrator_binding_stale": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "orchestrator_binding_stale"}}, "related_tools": ["agents.work_next", "agents.plan_get", "agents.plan_claim"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Plan Execute"}, "do_not_use_when": "Do not execute without claim lease unless operator policy allows.", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "heavy", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "heavy", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Run closed-loop execute for a claimed leaf. Attach evidence for completion_predicates; read executi…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.work_next", "agents.plan_get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.work_next", "agents.plan_get", "agents.plan_claim"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_execute", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Run orchestrator focused on current plan graph (alias for orchestrate with plan focus). Returns plan_revision / completion decision when available.", "title": "Execute Plan Node", "wave_xix_atoms": {"WG_AUTONOMOUS_CLAIM_REQUIRED": "When context.autonomous_mode is true, agents.plan_execute is denied unless the focus node status is in_progress (plan_claim_required). Claim via agents.plan_claim before execute in the mcp_work_loop_v1 spine.", "WG_CAPABILITY_HARD_GATE": "required_capabilities are mandatory — capability_mismatch blocks claim; route agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan; not handoff (capability_hard_gate_v1).", "WG_CLAIM_BEFORE_EXECUTE": "agents.plan_execute requires an active claim lease from agents.plan_claim unless operator policy allows execute-without-claim; pass if_match_revision from plan_get.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_EXECUTION_SUMMARY_ONLY": "Read execution_summary.missing_requirements — missing_roles is legacy; do not infer fleet gaps from validation.missing_roles when execution_summary is present.", "WG_PLAN_EXECUTE_HANDOFF": "After agents.plan_execute success (wait=true completed), follow data.next_action (usually agents.work_next) — do not invent a parallel loop from prose."}, "when_blocked": {"capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_executable": "kind note and catalog are memory, not work. Do not plan_claim them. Claim a task, step, or issue on the same home.", "orchestrator_binding_stale": "agents.reconcile_binding repair=true", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_claim_required": "agents.plan_claim if_match_revision — in_progress lease before agents.plan_execute", "plan_completion_blocked": "Attach completion_predicates evidence; do not retry agents.plan_execute until allowed", "plan_focus_invalid": "agents.work_next detail=compact — refresh focus_node_id from packet next_action", "provision_required": "ensure_agent create=false (H5) then create=true then plan_claim", "run_failed": "agents.work_next detail=compact — inspect run traces; repair_plan or reclaim before retry", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verification_failed": "agents.plan_recovery_scan → plan_propose mode=repair_plan", "waiting_for_approval": "Run status waiting_for_approval — agents.approve_run with approval_artifact_hash from run_detail."}, "when_not_to_use": "Do not execute without claim lease unless operator policy allows.", "when_to_use": "Run closed-loop execute for a claimed leaf. Attach evidence for completion_predicates; read execution_summary from prior work_next when blocked. wait=true (default) polls fleet run up to wait_timeout_", "write_mode": null}, {"action": "agents.plan_suggest_tree", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_suggest_tree", "related_tools": ["agents.plan_propose", "agents.plan_apply_proposal"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Suggest Tree"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Read-only nested plan tree draft from goal_text — no DNA write. Persist via agents.plan_propose wit…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_propose", "agents.plan_apply_proposal"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_propose", "agents.plan_apply_proposal"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_plan_suggest_tree", "semantic_input_mode": "inherit_workflow", "summary": "Suggest a nested plan tree draft from a goal (read-only). Does not mutate task_list — use plan_propose/create_plan + plan_apply_proposal to persist.", "title": "Agents Plan Suggest Tree", "wave_xix_atoms": {"WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_PLANNER_PLANE": "Backlog scan uses planner eligibility (decomposition_status=needed) — not execution_ready; validation_ok reflects plan_valid (structural+semantic), not fleet gaps.", "WG_PLANNING_ARTIFACT": "meta.planning_artifact nodes are evidence-only (resolution=non_executable_artifact) — attach evidence on parent; plan_process_backlog and claim skip them for execution."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only nested plan tree draft from goal_text — no DNA write. Persist via agents.plan_propose with draft_tree or plan_apply_proposal after review.", "write_mode": null}, {"action": "agents.plan_propose", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not patch task_list directly for multi-node decompositions — use propose + apply.", "anti_patterns": ["Do not patch task_list directly for multi-node decompositions — use propose + apply.", "validation.missing_roles alone is legacy; prefer missing_specializations / execution_summary."], "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "heavy", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_propose", "related_tools": ["agents.plan_get", "agents.plan_apply_proposal", "agents.work_next", "discovery.describe"], "semantic_input_mode": "per_step_nl", "source": "overlay", "title": "Agents Plan Propose"}, "do_not_use_when": "Do not patch task_list directly for multi-node decompositions — use propose + apply.", "domain_title": "Diagnostics MCP domain", "effect": {"budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "conditional_mutate": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "effect_kind": "read", "examples": [{"description": "env_uuid pairs with plan_apply_proposal on the same sandbox fork. validation.execution.execution_summary rolls up per-node dependency_ready vs execution_ready fleet gaps.", "name": "Decompose with sandbox anchor", "request": {"params": {"env_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "mode": "decompose_node", "node_id": "obj-1", "project_id": 1}, "tool": "agents.plan_propose"}, "response": {"data": {"validation": {"executable_now": false, "execution": {"execution_summary": {"missing_specializations": ["frontend_developer"], "per_node": [{"execution_ready": false, "node_id": "child-1", "resolution": "provision_required"}], "provisionable_specializations": ["frontend_developer"]}, "fully_provisionable": true}, "plan_valid": true}}, "success": true}}, {"description": "After agents.plan_recovery_scan surfaces verification_failed, propose a repair without mutating DNA until plan_apply_proposal.", "name": "Repair plan after verification_failed", "request": {"params": {"env_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "mode": "repair_plan", "node_id": "leaf-verify", "project_id": 1}, "tool": "agents.plan_propose"}, "response": {"data": {"validation": {"execution": {"execution_summary": {"per_node": [{"node_id": "leaf-verify", "verification_failed": true}]}}, "plan_valid": true}}, "success": true}}], "execution_class": "heavy", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Open the graph for durable work: draft only, no DNA write. persist_unexecutable if fleet gaps; chec…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_apply_proposal", "agents.plan_get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "agents.plan_apply_proposal", "agents.work_next", "discovery.describe"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_plan_propose", "semantic_input_mode": "per_step_nl", "summary": "Build a validated planner proposal (draft) for create_plan or decompose_node. Does not mutate task_list — call agents.plan_apply_proposal to persist.", "title": "Propose Plan Changes", "wave_xix_atoms": {"WG_ALLOW_GENERIC_ACCEPTANCE": "allow_generic_acceptance defaults false; repair_plan / sandbox repair only — never default on complexity ≥3 decompose.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_FACET_REPAIR": "plan_propose runs ensure_proposal_facet_coverage (facet_repair, max 2 passes) after enrich for create_plan and decompose_node (including from_draft_tree meta under create_plan) — do not hand-patch semantic facet children; for facet gaps after other modes use mode=repair_plan.", "WG_OPTIMIZE_EXEC_STABLE": "optimize_plan must not change executable_now unless patches touch required_role, skill_ids, or completion criteria — check validation.execution.execution_summary.", "WG_PERSIST_UNEXECUTABLE": "validation_mode=persist_unexecutable on plan_propose / plan_apply_proposal / plan_process_backlog when plan_valid but fleet cannot execute — use the same mode on propose and apply.", "WG_PLANNER_PLANE": "Backlog scan uses planner eligibility (decomposition_status=needed) — not execution_ready; validation_ok reflects plan_valid (structural+semantic), not fleet gaps.", "WG_PLAN_VALID_NOT_EXECUTABLE": "plan_valid / validation_ok means structural+semantic OK — not fleet-executable; use validation_mode=persist_unexecutable or ensure_agent when plan_valid but not execution_ready; executable_now=false under semantic alias is intentional.", "WG_RECOVERY_VERIFICATION_FAILED": "Recovery reason SoT is verification_failed (aliases verify_failed, plan_verify_failed) — call agents.plan_recovery_scan first, then plan_propose mode=repair_plan via recovery.next_actions (not missing_roles).", "WG_ROLE_TAXONOMY": "no_compatible_agent for role=data|data_engineer is a taxonomy alias — prefer agents.ensure_agent create=false (H5) then create=true before repair_plan; create_from_template only when ensure_agent is ambiguous; role_matches_template in role_taxonomy.py is SoT."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_required_dependency": "agents.plan_propose mode=decompose_node or repair_plan — facet DAG edge missing (storage→knowledge, logic→scheduler); inspect dependencies_to_add", "mode_not_implemented": "Use create_plan | decompose_node | replan_subtree | repair_plan | optimize_plan — discovery.describe agents.plan_propose", "node_already_atomic": "Complexity too low to decompose — agents.work_next or agents.plan_get for another leaf", "node_not_found": "agents.plan_get include_claimable=true — node_id absent from graph slice", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "planner_duplicate_children": "agents.plan_get — semantic facet children already exist; re-propose is a no-op or use mode=replan_subtree", "replan_budget_exceeded": "Max replans per node exceeded — agents.plan_propose mode=repair_plan on parent or escalation", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "supersede_in_progress": "agents.plan_get then wait/retry — in-progress node cannot be superseded without options.force_supersede_in_progress (retryable)", "unknown_skill_id": "Fix node skill_ids to ecosystem catalog (agents.skills_list); use rag.retrieval / rag.ingest_acceptance — not MCP action names; re-run plan_propose after enrich", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal"}, "when_not_to_use": "Do not patch task_list directly for multi-node decompositions — use propose + apply.", "when_to_use": "Open the graph for durable work: draft only, no DNA write. persist_unexecutable if fleet gaps; check execution_summary before apply. supersede_in_progress or planner_duplicate_children -> plan_get.", "write_mode": null}, {"action": "agents.plan_apply_proposal", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not apply without reviewing validation.execution.execution_summary.", "anti_patterns": ["Do not apply without reviewing validation.execution.execution_summary.", "Do not pass a different env_uuid than the paired plan_propose on sandbox forks."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_apply_proposal", "mutation_risk": "low", "related_tools": ["agents.plan_get", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Apply Proposal"}, "do_not_use_when": "Do not apply without reviewing validation.execution.execution_summary.", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "heavy", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Apply replan with supersede", "request": {"params": {"if_match_revision": 12, "project_id": 1, "proposal": {"base_graph_revision": 12, "dependencies_to_add": [["task-b", "task-a"]], "mode": "replan_subtree", "nodes_to_create": [], "nodes_to_supersede": ["stale-task-1"], "nodes_to_update": [], "preserve_completed": true, "proposal_id": "pp-replan-demo", "supersede_reason": "replan_subtree"}}, "tool": "agents.plan_apply_proposal"}}], "execution_class": "heavy", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Persist a validated proposal. Same env_uuid and validation_mode as paired plan_propose.", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_get", "agents.work_next"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "agents.work_next"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_apply_proposal", "semantic_input_mode": "inherit_workflow", "summary": "Apply a planner proposal to the Work Graph with CAS (if_match_revision). Pass proposal from plan_propose and base_graph_revision unchanged.", "title": "Apply Plan Proposal", "wave_xix_atoms": {"MCP_DOMAIN_ERROR": "Domain denial: tools/call isError=false with structuredContent (ok=false, error_code, failure_kind=domain, recovery). Transport/internal uses isError=true (failure_kind=transport). plan_revision_conflict → agents.plan_get then retry with fresh if_match_revision.", "WG_CAS_RETRY": "plan_revision_conflict → plan_get reload if_match_revision — never apply stale proposal after concurrent plan_patch or backlog apply.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_EXECUTION_SUMMARY_ONLY": "Read execution_summary.missing_requirements — missing_roles is legacy; do not infer fleet gaps from validation.missing_roles when execution_summary is present.", "WG_PERSIST_UNEXECUTABLE": "validation_mode=persist_unexecutable on plan_propose / plan_apply_proposal / plan_process_backlog when plan_valid but fleet cannot execute — use the same mode on propose and apply."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal"}, "when_not_to_use": "Do not apply without reviewing validation.execution.execution_summary.", "when_to_use": "Persist a validated proposal. Same env_uuid and validation_mode as paired plan_propose.", "write_mode": null}, {"action": "agents.plan_process_backlog", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not auto_apply on production without operator tier and explicit auto_apply_policy.", "anti_patterns": ["Do not auto_apply on production without operator tier and explicit auto_apply_policy."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"auto_apply": true, "auto_apply_policy": "safe"}, "semantic_input_mode": "inherit_workflow"}, "effect_override": {"conditional_mutate": "auto_apply_policy off = propose only; safe|force applies planner patches (mutate).", "effect_depends_on_params": true, "mutates_when": {"auto_apply": true, "auto_apply_policy": "safe"}}, "execution_class": "heavy", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_process_backlog", "mutates_when": {"auto_apply": true, "auto_apply_policy": "safe"}, "mutation_risk": "low", "related_tools": ["agents.plan_apply_proposal", "agents.plan_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Process Backlog"}, "do_not_use_when": "Do not auto_apply on production without operator tier and explicit auto_apply_policy.", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "auto_apply_policy off = propose only; safe|force applies planner patches (mutate).", "effect_depends_on_params": true, "execution_class": "heavy", "generation": false, "kind": "mutate", "mutates_when": {"auto_apply": true, "auto_apply_policy": "safe"}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "auto_apply_policy off = propose only; safe|force applies planner patches (mutate).", "effect_depends_on_params": true, "mutates_when": {"auto_apply": true, "auto_apply_policy": "safe"}}, "examples": [{"description": "auto_apply_policy=off — proposals returned in results; no DNA mutation.", "name": "Propose-only backlog scan", "request": {"params": {"auto_apply_policy": "off", "env_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "max_nodes": 1, "project_id": 1}, "tool": "agents.plan_process_backlog"}, "response": {"data": {"candidates": [{"mode": "decompose_node", "node_id": "obj-1"}], "results": [{"applied": false, "node_id": "obj-1", "validation": {"execution": {"execution_summary": {"execution_ready": false}}}}]}, "success": true}}], "execution_class": "heavy", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Scan decomposition backlog (planner plane) on home=project|self|project_self; env_uuid only with ho…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_apply_proposal", "agents.plan_get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_apply_proposal", "agents.plan_get"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_process_backlog", "semantic_input_mode": "inherit_workflow", "summary": "Scan decomposition backlog (decomposition_status=needed, no execution decomposition) and build planner proposals. Claims planner-parent lease before decompose when required_role=planner (even when aut", "title": "Process Plan Backlog", "wave_xix_atoms": {"WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_FACET_REPAIR": "plan_propose runs ensure_proposal_facet_coverage (facet_repair, max 2 passes) after enrich for create_plan and decompose_node (including from_draft_tree meta under create_plan) — do not hand-patch semantic facet children; for facet gaps after other modes use mode=repair_plan.", "WG_PERSIST_UNEXECUTABLE": "validation_mode=persist_unexecutable on plan_propose / plan_apply_proposal / plan_process_backlog when plan_valid but fleet cannot execute — use the same mode on propose and apply.", "WG_PLANNER_PLANE": "Backlog scan uses planner eligibility (decomposition_status=needed) — not execution_ready; validation_ok reflects plan_valid (structural+semantic), not fleet gaps.", "WG_PLANNING_ARTIFACT": "meta.planning_artifact nodes are evidence-only (resolution=non_executable_artifact) — attach evidence on parent; plan_process_backlog and claim skip them for execution."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "replan_budget_exceeded": "Max replans per node exceeded — agents.plan_propose mode=repair_plan on parent or escalation", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal"}, "when_not_to_use": "Do not auto_apply on production without operator tier and explicit auto_apply_policy.", "when_to_use": "Scan decomposition backlog (planner plane) on home=project|self|project_self; env_uuid only with home=project. auto_apply_policy=off default; validation_mode=persist_unexecutable for intake-only; vali", "write_mode": null}, {"action": "agents.plan_recovery_scan", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not mutate DNA from recovery_scan — use plan_propose repair_plan or plan_patch.", "anti_patterns": ["Do not mutate DNA from recovery_scan — use plan_propose repair_plan or plan_patch."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_recovery_scan", "related_tools": ["agents.plan_propose", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Recovery Scan"}, "do_not_use_when": "Do not mutate DNA from recovery_scan — use plan_propose repair_plan or plan_patch.", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Candidates carry reason=verification_failed and recovery.next_actions.", "name": "Recovery scan (sandbox)", "request": {"params": {"env_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "limit": 8, "project_id": 1}, "tool": "agents.plan_recovery_scan"}, "response": {"data": {"candidates": [{"mode": "repair_plan", "node_id": "leaf-verify", "reason": "verification_failed", "recovery": {"next_actions": [{"action": "agents.plan_propose", "params": {"mode": "repair_plan", "node_id": "leaf-verify"}}]}}], "next_actions": [], "stale_claims": []}, "success": true}}], "execution_class": "heavy", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Read-only recovery preview after verification_failed or work_next recovery routes: candidates, stal…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_propose", "agents.work_next"], "onboarding_tier": "domain_playbook", "operator_recovery_template": {"expired_claim": {"claim": {"action": "agents.plan_claim", "params": {"env_uuid": "<env_uuid_if_sandbox>", "home": "project", "if_match_revision": "<revision>", "node_ids": ["<node_id>"]}}, "reclaim": {"action": "agents.plan_reclaim_stale", "params": {"env_uuid": "<env_uuid_if_sandbox>", "home": "project"}}, "refresh": {"action": "agents.plan_get", "params": {"detail": "compact", "env_uuid": "<env_uuid_if_sandbox>", "home": "project", "if_match_revision": "<revision>"}}}, "verification_failed": {"handoff": {"action": "agents.work_next", "params": {"handoff": true, "home": "project", "node_id": "<node_id>"}}, "repair_apply": {"action": "agents.plan_apply_proposal", "params": {"env_uuid": "<env_uuid_if_sandbox>", "home": "project", "if_match_revision": "<revision>"}}, "repair_propose": {"action": "agents.plan_propose", "params": {"env_uuid": "<env_uuid_if_sandbox>", "home": "project", "mode": "repair_plan", "node_id": "<node_id>"}}, "scan": {"action": "agents.plan_recovery_scan", "params": {"env_uuid": "<env_uuid_if_sandbox>", "home": "project"}}}}, "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "recovery_ladder": ["agents.plan_compaction_preview → agents.plan_heal_leaf (dry_run then apply) — spill_incomplete or plan_graph_too_large", "agents.plan_recovery_scan — verification_failed candidates + stale claims; optional env_uuid", "agents.plan_propose mode=repair_plan — target node_id; allow_generic_acceptance repair-only", "agents.plan_apply_proposal — same env_uuid as propose on sandbox forks", "agents.work_next handoff=true node_id=… — re-resolve after repair or provision"], "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_propose", "agents.work_next"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_plan_recovery_scan", "semantic_input_mode": "inherit_workflow", "summary": "Read-only scan for verification_failed repair candidates and stale claims. Reason codes use recovery_engine SoT (verification_failed, expired_claim).", "title": "Scan Plan Recovery", "wave_xix_atoms": {"WG_CLOSED_LOOP_VERIFY_FAIL": "verification_failed — next_action agents.plan_recovery_scan then repair_plan.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_PROVISION_PARITY": "When execution.fully_provisionable and one top template, recovery routes agents.ensure_agent create=false (H5 preview) — SDK followWorkGraphAction runs ensureAgentSaga for create=true; ambiguous ties → create_from_template choose_template.", "WG_RECOVERY_VERIFICATION_FAILED": "Recovery reason SoT is verification_failed (aliases verify_failed, plan_verify_failed) — call agents.plan_recovery_scan first, then plan_propose mode=repair_plan via recovery.next_actions (not missing_roles).", "WG_REPAIR_METRICS_SCAN_COUNTS": "plan_recovery_scan meta.repair_metrics is scan summary only (candidate_count, stale_claim_count). Facet repair_metrics (nodes_created, repair_graph_edit_distance) and repair_diagnostics come from plan_propose mode=repair_plan — not from scan counts."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verification_failed": "agents.plan_recovery_scan → plan_propose mode=repair_plan"}, "when_not_to_use": "Do not mutate DNA from recovery_scan — use plan_propose repair_plan or plan_patch.", "when_to_use": "Read-only recovery preview after verification_failed or work_next recovery routes: candidates, stale_claims, recovery.next_actions, and next_action — no DNA mutation (optional env_uuid on sandbox fork", "write_mode": null}, {"action": "agents.work_next", "aliases": ["agent_os.open", "agentos.open", "os.open", "os.panels"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not infer missing_roles from validation when execution_summary is present.", "anti_patterns": ["Do not infer missing_roles from validation when execution_summary is present.", "dependency_ready=false is not fixed by switching agent identity — wait deps first.", "Do not call agents.run on strategic parent nodes with children."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.work_next", "recovery_blocks": {"guidance_user_row_not_found": {"next_actions": [{"action": "agents.work_next", "params": {"handoff": true}}], "reason": "guidance_user_row_not_found"}, "orchestrator_binding_stale": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "orchestrator_binding_stale"}, "work_next_enrich_failed": {"next_actions": [{"action": "agents.work_next", "params": {"detail": "compact", "handoff": true}}], "reason": "work_next_enrich_failed"}, "work_next_hydrate_failed": {"next_actions": [{"action": "agents.work_next", "params": {"repair": true}}], "reason": "work_next_hydrate_failed"}, "work_next_repeat_reconcile_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "work_next_repeat_reconcile_failed"}, "workflow_batch_bind_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_bind_failed"}, "workflow_batch_bind_skipped": {"next_actions": [{"action": "agents.work_next", "params": {"repair": true}}], "reason": "workflow_batch_bind_skipped"}, "workflow_batch_context_bind_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_context_bind_failed"}, "workflow_batch_receipt_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_receipt_failed"}, "workflow_inverse_sync_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_inverse_sync_failed"}, "workflow_receipt_context_missing": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_context_missing"}, "workflow_receipt_unbound": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_unbound"}, "workflow_state_key_stamp_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_state_key_stamp_failed"}}, "related_tools": ["agents.plan_claim", "agents.plan_execute", "agents.ensure_agent", "agents.plan_get", "agents.plan_recovery_scan", "agents.graph_health", "discovery.list", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Agents Work Next"}, "do_not_use_when": "Do not infer missing_roles from validation when execution_summary is present.", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"detail": "compact"}, "example_request": {"action": "agents.work_next", "params": {"detail": "compact"}}, "examples": [{"description": "next_work.execution carries dependency_ready, execution_ready, and execution_summary; instruction_packet mirrors execution_summary.", "name": "Executable next work", "request": {"params": {"detail": "compact", "env_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "project_id": 1}, "tool": "agents.work_next"}, "response": {"data": {"detail": "compact", "instruction_packet": {"execution_summary": {"execution_ready": true}}, "next_action": {"action": "agents.plan_claim", "params": {"node_id": "task-a", "project_id": 1}}, "next_work": {"execution": {"dependency_ready": true, "execution_ready": true, "execution_summary": {"per_node": [{"execution_ready": true, "node_id": "task-a"}]}}, "node_id": "task-a"}, "node_id": "task-a", "panels": [{"bytes": 2, "count": 0, "id": "pin_slots"}], "reason": "", "revision": 2, "state": "actionable"}, "success": true}}, {"description": "dependency_ready true but execution_ready false → state=blocked; recovery routes to agents.ensure_agent; claim errors add recovery_block.", "name": "Blocked with recovery", "request": {"params": {"env_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "handoff": true, "node_id": "task-b", "project_id": 1}, "tool": "agents.work_next"}, "response": {"data": {"blocked_work": [{"dependency_ready": true, "execution": {"dependency_ready": true, "execution_ready": false, "execution_summary": {"provisionable_specializations": ["frontend_developer"]}}, "execution_ready": false, "node_id": "task-b"}], "detail": "compact", "panels": [{"bytes": 2, "count": 0, "id": "pin_slots"}], "recovery": {"next_actions": [{"action": "agents.ensure_agent", "params": {"create": true, "node_id": "task-b", "project_id": 1}}], "reason": "provision_required"}, "state": "blocked"}, "success": true}}], "execution_class": "plain_read", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "hydrate_mode_note": "discovery rank_only hydrate skips fleet — run full agents.work_next before plan_claim.", "instruction_hint": "After VPS backend restart, first agents.work_next may fail while MCP tools import — wait ~15s and r…", "kind": "mcp_domain", "ladder": ["agents.plan_get — include_execution_eligibility=true; optional env_uuid for sandbox slice", "agents.work_next — read dependency_ready (structural) vs execution_ready (fleet) separately; blocked_work.execution_summary + instruction_packet.execution_summary; dependency_ready=false → wait deps; execution_ready=false with deps ok → provision before claim", "agents.plan_claim — CAS revision; role_mismatch → handoff not retry loop", "agents.plan_execute — only after claim; attach evidence for completion_predicates"], "loop_compact": {"anti_pattern": "Do not projects.patch_data full orchestrator task_list blobs — use plan_heal_leaf ladder.", "cheap_sync_batch": ["agents.work_next", "agents.plan_get", "agents.plan_claim"], "heavy_expand": ["blocked_work", "diagnostics", "generation_pending", "goal_summary", "instruction_packet", "instruction_slice", "pin_slots", "plan_summary", "skills"], "hot_loop": {"detail": "compact", "home": "project"}, "leaf_overflow_ladder": ["agents.graph_health | agents.plan_compaction_preview (read)", "agents.plan_heal_leaf dry_run=true then apply", "agents.plan_patch archive ops | agents.graph_file_put if still over cap"], "recipe_id": "mcp_work_loop_v1", "recommended_expand": {"default": [], "detail_full_default": ["instruction_packet"], "when_promote_pending": ["generation_pending"], "when_state_blocked": ["instruction_packet", "blocked_work"]}, "rule": "Follow packet.next_action; discovery.search only when next_action is absent.", "spine": ["agents.work_next", "agents.plan_claim", "agents.plan_execute", "agents.work_next"]}, "mutation_kind": "none", "next_actions": ["agents.plan_claim", "agents.ensure_agent", "agents.plan_execute"], "onboarding_tier": "domain_playbook", "operator_closure_plan_patch": {"blocked_reason": "operator_closure", "describe": {"action": "discovery.describe", "params": {"action": "agents.plan_patch", "detail": "default"}}, "operator_complete": {"completion_meta_keys": ["completion_note", "completion_waived", "gate_evidence", "gates_passed"], "example_ops": [{"id": "<node_id>", "op": "set", "status": "in_progress"}, {"id": "<node_id>", "key": "gates_passed", "op": "set_meta", "value": true}, {"id": "<node_id>", "key": "gate_evidence", "op": "set_meta", "value": "Evidence line (HTTP probe, checklist doc, etc.)"}, {"id": "<node_id>", "op": "set", "status": "verifying"}, {"completion_note": "Evidence line (HTTP probe, checklist doc, etc.)", "id": "<node_id>", "op": "set", "status": "completed"}], "recommended_mode": "operator_complete", "rule": "Roleless platform ops leaves (human_required): set_meta gates_passed + gate_evidence, then FSM in_progress→verifying→completed. Pass from_status from plan_get node status."}, "plan_patch": {"action": "agents.plan_patch", "params": {"home": "project", "if_match_revision": "<revision>", "ops": [{"id": "<node_id>", "op": "set", "status": "in_progress"}, {"id": "<node_id>", "key": "gates_passed", "op": "set_meta", "value": true}, {"id": "<node_id>", "key": "gate_evidence", "op": "set_meta", "value": "Operator evidence (probe URL, checklist, deploy gate)"}, {"id": "<node_id>", "op": "set", "status": "verifying"}, {"completion_note": "Operator evidence (probe URL, checklist, deploy gate)", "id": "<node_id>", "op": "set", "status": "completed"}]}}, "preflight": {"action": "agents.plan_get", "params": {"detail": "compact", "if_match_revision": "<revision>", "node_id": "<node_id>"}}, "recommended_mode": "operator_complete", "speak_first": "operator_closure: tell the user in chat (operator_gate.messages) and ask yes/no. agents.plan_patch gates_passed only after an explicit yes. terminal means wait, not skip the leaf."}, "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "recovery_ladder": ["agents.plan_compaction_preview → agents.plan_heal_leaf (dry_run then apply) — spill_incomplete or plan_graph_too_large", "agents.plan_recovery_scan — verification_failed candidates + stale claims; optional env_uuid", "agents.plan_propose mode=repair_plan — target node_id; allow_generic_acceptance repair-only", "agents.plan_apply_proposal — same env_uuid as propose on sandbox forks", "agents.work_next handoff=true node_id=… — re-resolve after repair or provision"], "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_claim", "agents.plan_execute", "agents.ensure_agent", "agents.plan_get", "agents.plan_recovery_scan", "agents.graph_health", "discovery.list", "discovery.describe"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_work_next", "semantic_input_mode": "inherit_workflow", "summary": "Agent-native next-work packet. Default detail=compact: state, next_action, reason, revision. panels is the string expand. Pass expand (array or comma string) to inline sections on this response only: ", "title": "Get Next Work Item", "wave_xix_atoms": {"WG_BIND_VS_CLAIM": "node.agent_id binding ≠ active claim lease — already_claimed requires status=in_progress with non-expired lease meta; bound agent on ready/pending is not already_claimed; retry ensure_agent idempotent_replay or plan_claim with if_match_revision.", "WG_BLOCKED_REASON": "blocked_work[].blocked_reason is canonical (block_reason.REASON_PRIORITY); use recovery.next_actions — not validation.missing_roles.", "WG_CAPABILITY_HARD_GATE": "required_capabilities are mandatory — capability_mismatch blocks claim; route agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan; not handoff (capability_hard_gate_v1).", "WG_CLOSED_LOOP_DEPENDENCY": "dependency_blocked — no claim; reason names upstream node_id until deps complete.", "WG_CLOSED_LOOP_EXECUTABLE": "state=actionable (alias executable) and execution_ready — next_action agents.plan_claim with if_match_revision from plan_get.", "WG_CLOSED_LOOP_PLANNING": "planning_required — next_action agents.plan_propose mode=create_plan or decompose_node.", "WG_CLOSED_LOOP_PROVISION": "resolution=provision_required — next_action agents.ensure_agent create=false (H5) then create=true before plan_claim.", "WG_CLOSED_LOOP_STALE_CLAIM": "blocked_reason=expired_claim — next_action agents.plan_reclaim_stale; beats downstream dependency_blocked when no executable leaf.", "WG_CLOSED_LOOP_VERIFY_FAIL": "verification_failed — next_action agents.plan_recovery_scan then repair_plan.", "WG_DEPENDENCY_VS_EXECUTION_READY": "dependency_ready is structural (deps/status/decomposition); execution_ready is fleet (live agent or provision path) — never collapse the two gates.", "WG_DISCOVERY_ROUTE": "Discovery naming: intent_id (taxonomy) ≠ primary_action (router verb) ≠ agents.work_next (fleet pick) — do not treat a route phrase as an MCP action name. discovery.describe requires param action=<catalog action id> (not optional).", "WG_ENSURE_H5": "agents.ensure_agent preview template_id must match agents.work_next top compatible_templates[0] for the same node (harness H5 / resolver_parity_v1).", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_EXECUTION_SUMMARY_ONLY": "Read execution_summary.missing_requirements — missing_roles is legacy; do not infer fleet gaps from validation.missing_roles when execution_summary is present.", "WG_HANDOFF_RECOVERY": "role_mismatch / specialization_mismatch after claim → work_next handoff=true node_id=… — follow recovery.next_actions, do not retry same agent. capability_mismatch is missing required_capabilities: repair_plan or ensure_agent, not handoff.", "WG_HARNESS_GATES": "Dev gates: doctor --full (repo.ops.closed_loop.harness.gen1); key suites: ensure_agent_provision_e2e_v2, ensure_agent_idempotent_retry_v1, bind_vs_claim_semantics_v1, persist_unexecutable_v1, mcp_structured_domain_error_v1, resolver_parity_v1, instruction_plane_dry_v2, planner_runtime_parity_v3.", "WG_HARNESS_STATE": "Blocked agents.work_next packets include diagnostics.harness_state — read-only projection (dependency_ready, execution_ready, blocked_reason); not a second orchestrator.", "WG_LOOP_ERROR_BUDGET": "Loop error budget (WG-SLO-03/04): follow packet.next_action from agents.work_next — discovery.search while next_action is present burns compliance (target ≥90% followed). Heavy batches: options.async=true; full budget GET /mcp/actions execute_budget.", "WG_PLAN_FIRST": "Lightweight progress: agents.work_status (summary_only). Full autonomous loop: agents.work_next — follow next_action, not next_actions[0] parsing.", "WG_PLAN_VALID_NOT_EXECUTABLE": "plan_valid / validation_ok means structural+semantic OK — not fleet-executable; use validation_mode=persist_unexecutable or ensure_agent when plan_valid but not execution_ready; executable_now=false under semantic alias is intentional.", "WG_PROVISION_PARITY": "When execution.fully_provisionable and one top template, recovery routes agents.ensure_agent create=false (H5 preview) — SDK followWorkGraphAction runs ensureAgentSaga for create=true; ambiguous ties → create_from_template choose_template.", "WG_RECOVERY_VERIFICATION_FAILED": "Recovery reason SoT is verification_failed (aliases verify_failed, plan_verify_failed) — call agents.plan_recovery_scan first, then plan_propose mode=repair_plan via recovery.next_actions (not missing_roles).", "WG_ROLE_TAXONOMY": "no_compatible_agent for role=data|data_engineer is a taxonomy alias — prefer agents.ensure_agent create=false (H5) then create=true before repair_plan; create_from_template only when ensure_agent is ambiguous; role_matches_template in role_taxonomy.py is SoT.", "WG_TEAM_OVER_INTEGRATION": "Team-create goals (agents.team.create): discovery rank demotes integrations.* — prefer agents.team.create / agents.orchestrate / agents.plan_* over integrations.oauth_begin.", "WG_WORK_NEXT_LOOP": "Closed loop: plan_get → work_next → next_action → execute/claim → work_next until state=idle. Blocked: read recovery.next_actions or singular next_action."}, "when_blocked": {"agent_daily_cap": "Agent per_day_cap hit — patch AgentSpec.energy or wait for UTC day rollover.", "agent_not_found": "agent_id not in project fleet — use agents.team or plan_get before run_get.", "already_claimed": "agents.work_next — check in_progress lease (H11); handoff if wrong agent; plan_reclaim_stale if stale", "ambiguous_anchor": "patch_text search_replace — longer find, set count, or graph_file_get text window", "approval_hash_mismatch": "agents.run_get — approval_artifact_hash must match pending tool call on the run", "auth_required": "Authenticate before work-graph spine — auth.get_profile → context.project_id → agents.work_next (not discovery.search).", "batch_project_scope_leak": "A failed MCP batch step with params.project_id does not retarget later steps — only auth.switch_project may promote batch context.project_id. Re-bind context.project_id before mutations if a step used a probe pid.", "batch_semantic_anchor_conflict": "Align step NL with batch goal anchor — use one goal_text for the batch or split batches", "batch_semantic_anchor_required": "Batch includes a mutating or non-plain-read step: set options.execution_intent=direct for authorized CRUD, or options.goal, focus_node_id, or plan_execute_mode for workflow. Plain reads and validate_only (e.g. script.put) may run without goal. Use preflight.check simulate_batch_actions + simulate_batch_params (or execution_intent) to preview anchor.", "capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "checklist_gate_open": "Complete checklist gates on meta.checklist_gates (plan_node entity); agents.plan_get node_id=… — do not patch description as a blocker", "claim_empty": "agents.work_next handoff=true — no nodes claimed; refresh claimable set", "claim_heartbeat_failed": "No active in_progress lease for node_id — plan_claim the node before heartbeat_only pin ops", "conflicting_semantic_anchor": "Same as batch_semantic_anchor_conflict — per-step NL vs batch semantic_contract", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "created_agent_not_eligible": "Provision rolled back — plan_propose mode=repair_plan or pick template with matching caps (H5)", "decomposition_blocked": "agents.plan_propose mode=decompose_node — parent has open decomposition children", "dependency_blocked": "agents.plan_get to inspect upstream deps; do not ensure_agent; do not claim", "dependency_error": "Batch only — DAG: a prior step failed or was skipped; fix the first failed step_id. Standalone notifications.deliver / channels.deliver use channel_not_linked or channels.create_bind_link, not dependency_error.", "dependency_failed": "Prerequisite batch step did not succeed — fix or remove dependsOn; poll verification_action before retrying dependent step", "discovery_search_recursion": "Prefer discovery.list (optional domain=) to copy exact action ids, then discovery.describe. If you use discovery.search: one concrete q= per execute, then describe — do not chain many search steps; in goal-anchored batches run search in a separate execute (batch_semantic_anchor_conflict).", "energy_denied": "Insufficient builder_energy before agents.run — energy.get_balance then payments.create intent=energy_pack; follow packet.next_action.", "ensure_agent_stamp_mismatch": "Replay create=false preview; create=true must match preview_template_id + graph_revision", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "fleet_skipped": "Fleet was not loaded for this work_next call (compact/rank-only path) — not the same as no_compatible_agent; load fleet or use full work_next when matching agents to tasks.", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "fully_provisionable": "ensure_agent create=false (H5) then create=true (preferred over create_from_template)", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_address_required": "Personal home needs a resolved session address. Pass home on the tool and ensure the operator session has user_id before patch.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "graph_storage_empty": "Prod task_list leaf is empty at revision 0 with storage hash — restore via generation supply and agents.plan_patch; do not empty-overwrite revision 0.", "guidance_user_row_not_found": "auth.get_profile then agents.work_next handoff=true", "idle": "Orchestrator graph has no tasks yet (revision 0) — valid idle; seed with agents.plan_propose or agents.plan_patch before claim/execute.", "import_pack_personal_home_unsupported": "Orchestrator import pack requires home=project; personal session graphs use export/read paths only.", "internal_execution_error": "agents.plan_recovery_scan → plan_propose mode=repair_plan; retry after catalog refresh", "invalid_channel": "channel must be workspace, messenger, bot, mcp, or api — retry agents.orchestrate with a supported surface", "invalid_detail": "detail/projection/limit validation — see problem.field in error payload", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "invalid_state_transition": "agents.plan_get node status — legal FSM only; completed↔cancelled retries are no-ops", "join_not_allowed": "Project is not open-join — request invite or projects.add_user from an owner.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "membership_required": "Open community hub: call projects.join on context.project_id, then agents.work_next with home=project_self (recipe mcp_community_hub_v1).", "missing_capability": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "missing_required_dependency": "agents.plan_propose mode=decompose_node or repair_plan — facet DAG edge missing (storage→knowledge, logic→scheduler); inspect dependencies_to_add", "mode_not_implemented": "Use create_plan | decompose_node | replan_subtree | repair_plan | optimize_plan — discovery.describe agents.plan_propose", "needs_seed": "Graph revision > 0 but task list is empty — propose or patch a plan; do not run plan_recovery_scan against an intentionally empty graph.", "no_compatible_agent": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "node_already_atomic": "Complexity too low to decompose — agents.work_next or agents.plan_get for another leaf", "node_not_eligible": "agents.plan_get on the same home — node failed evaluate_work_eligibility; agents.work_next handoff=true and follow recovery.next_actions", "node_not_found": "agents.plan_get include_claimable=true — node_id absent from graph slice", "not_authenticated": "MCP is required. This channel has no operator session — authorize first (Connect on plugin AgentStack MCP or /agentstack-authorize). Confirm with mcp-execute.mjs auth.get_profile. Do not retry the unsigned plugin call and do not call mcp_auth.", "not_executable": "kind note and catalog are memory, not work. Do not plan_claim them. Claim a task, step, or issue on the same home.", "operator_closure": "operator_closure: tell the user in chat (operator_gate.messages) and ask yes/no. agents.plan_patch gates_passed only after an explicit yes. terminal means wait, not skip the leaf.", "orchestrate_failed": "resolve_and_run failed — read data.error_code; agents.fleet_diagnostics, agents.reconcile_binding, or agents.run_get when run_uuid is present", "orchestration_step_violation": "Action outside current workflow step — follow packet next_action / inverse_resume; do not mutate graph until step advances. For ad-hoc reads (auth.get_profile) or plan writes outside the spine, rerun the batch with options.execution_mode=plain or options.execution_intent=direct on a single allowed action. For notifications.deliver inside a playbook: run preflight.check first or use packet.next_action — not a raw deliver outside the step allow-list.", "orchestrator_agent_missing": "projects.orchestrator.get then projects.orchestrator.patch (or owner/agents_admin auto-provision on prod); sandbox env_uuid cannot provision — bind on prod and reconcile before sandbox orchestrate", "orchestrator_agent_stale": "Bound agent_uuid no longer matches fleet — agents.reconcile_binding repair=true; agents.ensure_agent when the template row is missing; then agents.work_next handoff=true.", "orchestrator_binding_stale": "agents.reconcile_binding repair=true", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "pin_inventory_full": "Goal pin inventory at active_max — unpin a slot (plan affinity) then retry agents.plan_claim", "pin_slot_not_found": "No matching goal pin slot for skill_id and agent_id — agents.plan_get pin_slots then retry", "plan_archive_no_effect": "Archive patch matched no nodes — agents.plan_get detail=compact; confirm archive_ids / node_id scope; use agents.plan_patch with if_match_revision, not empty ops.", "plan_claim_owner_conflict": "agents.work_next handoff=true — another operator holds the lease", "plan_claim_required": "agents.plan_claim if_match_revision — in_progress lease before agents.plan_execute", "plan_completion_blocked": "Attach completion_predicates evidence; do not retry agents.plan_execute until allowed", "plan_focus_invalid": "agents.work_next detail=compact — refresh focus_node_id from packet next_action", "plan_graph_bytes_high": "graph_limits.advisories plan_graph_bytes_high — agents.plan_compaction_preview; archive completed nodes or graph_file_put before bulk ingest; plan_get detail=compact.", "plan_graph_children_exceeded": "Direct children per parent are capped (32). Flat parent_id storage counts siblings under each parent_id — not total graph nodes. Split into sub-groups or use agents.plan_propose decompose_node.", "plan_graph_load_failed": "DNA/graph slice failed to load — plan_get (compact) then retry. If patch used a long title (>256), use patch_text or shorten title; see validation_error + field=title instead of this code when preflight maps PGVE.", "plan_graph_oversize": "Plan graph exceeds size budget — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed subtrees or split objectives.", "plan_graph_private": "Orchestrator graph is private — sign in (user_id in MCP context) or set orchestrator public_read; project API keys must include created_by user.", "plan_graph_too_large": "The merged graph does not fit the JSON leaf (see graph_limits.inline_write_hard_limit_bytes, typically 512 KiB). Bodies spill near chunk_spill_target_bytes (~400 KiB). For huge prose use node.prompt/detail (not only meta.description), append_storage_ref (stubs inline text), reorder_children {parent_id,child_ids}, or storage file maps in meta.storage_refs. Cards keep ~200-char stubs after spill. Read one node with plan_get detail=body and node_id. Archive completed nodes (op archive) if titles/meta still overflow. Do not retry the same blob. Leaf heal ladder: agents.plan_compaction_preview → agents.plan_heal_leaf dry_run=true → apply.", "plan_ops_parent_missing": "add_child parent_id is not in the graph — create the parent first or fix parent_id. On an empty project graph (revision 0, no tasks), omit parent_id and send {op:add_child, node:{id, title, kind}} with if_match_revision:0 from plan_get; do not use op set for new ids.", "plan_patch_inline_body_spill": "Inline prose exceeds chunk seal — agents.graph_file_put; follow spill recovery in error data", "plan_patch_nodes_missing_from_changed": "Revision moved but new node ids are absent on plan_get — align generation_env_uuid on context and tool params; deploy compaction protect_ids (undated completed purge); run prelude bucket parents before child ingest batches.", "plan_patch_ops_limit": "Too many ops[] in one plan_patch — split batches; plan_get between writes (max 50)", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "planner_duplicate_children": "agents.plan_get — semantic facet children already exist; re-propose is a no-op or use mode=replan_subtree", "planning_blocked": "agents.plan_propose mode=decompose_node or plan_process_backlog — finish planner plane first", "planning_required": "agents.plan_propose mode=create_plan or decompose_node — strategic/decomposition node, not execution", "provision_required": "ensure_agent create=false (H5) then create=true then plan_claim", "provisioning_failed": "create_from_template or bind failed — retry agents.ensure_agent create=false (H5) then create=true", "relogin_required": "Session invalidated (deploy, eviction, or X-Session-Action: relogin_required) — re-authenticate: auth.get_profile or hosted remint; do not retry the same Bearer in a loop.", "replan_budget_exceeded": "Max replans per node exceeded — agents.plan_propose mode=repair_plan on parent or escalation", "role_mismatch": "work_next handoff=true node_id=… — do not retry same agent", "run_failed": "agents.work_next detail=compact — inspect run traces; repair_plan or reclaim before retry", "run_mismatch": "run_id does not belong to the supplied agent_id — omit agent_id or fix the pair.", "run_not_found": "No run row for run_id in this project — verify run_id from agents.run or traces.", "run_not_waiting_for_approval": "agents.run_get — run is not waiting_for_approval; poll status before approve_run", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Key lacks required L1 cap (often mcp_read or project_admin for plan_patch). Widen via apikeys.create (full_project) or reconnect MCP with full OAuth scope. If project role is owner/admin, MCP widens caps for execute project_id — call auth.get_profile (credential_plane) to confirm key_preview and caps; align context.project_id with the tenant before agents.plan_get / plan_patch.", "service_caps_required_in_prod": "Project API key has no L1 service_caps — recreate with admin permissions (auto agents_autonomous_loop in prod) or user.apikeys.create preset agents_autonomous_loop / full_project; pass context.project_id=1 for ecosystem graph.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "skill_mismatch": "agents.work_next handoff=true — skill_ids mismatch; follow recovery.next_actions", "specialization_mismatch": "work_next handoff=true — follow recovery.next_actions", "spill_incomplete": "graph_limits.spill_incomplete — agents.plan_compaction_preview then agents.plan_heal_leaf (dry_run then apply); archive completed nodes (plan_patch op archive) if still over cap.", "status_not_claimable": "agents.plan_get on the same home. Claim only pending or ready nodes, or an in_progress node whose lease has expired.", "supersede_in_progress": "agents.plan_get then wait/retry — in-progress node cannot be superseded without options.force_supersede_in_progress (retryable)", "template_not_found": "agents.templates_list — template_id missing from catalog; agents.template_preview before create=true", "terminal": "agents.work_next — skip terminal node; pick another leaf (completed/cancelled not claimable)", "text_revision_conflict": "patch_text — re-read the field from plan_get; refresh expected_text_sha256", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "unknown_skill_id": "Fix node skill_ids to ecosystem catalog (agents.skills_list); use rag.retrieval / rag.ingest_acceptance — not MCP action names; re-run plan_propose after enrich", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Re-run agents.plan_propose; inspect validation.errors — agents.plan_get before plan_apply_proposal", "verification_failed": "agents.plan_recovery_scan → plan_propose mode=repair_plan", "waiting_approval": "agents.work_next — wait approval gate; agents.plan_get to inspect approval meta", "waiting_for_approval": "Run status waiting_for_approval — agents.approve_run with approval_artifact_hash from run_detail.", "waiting_input": "agents.work_next — ask_user recovery; do not plan_claim until operator input arrives", "wip_full": "Agent WIP cap reached — agents.plan_get then complete/release in_progress claims; retry plan_claim", "wire_budget_exceeded": "Slice too large — narrow node_id, max_depth, or use detail=cards (detail=body|full past wire budget)", "work_next_enrich_failed": "agents.work_next handoff=true detail=compact", "work_next_hydrate_failed": "Work-graph hydrate failed — run agents.work_next with repair=true and detail=compact; on preflight failures narrow batch targets; on discovery failures narrow scope or defer hydrate.", "work_next_repeat_reconcile_failed": "agents.reconcile_binding repair=true", "workflow_batch_bind_failed": "agents.reconcile_binding repair=true — guidance bind failed; check member row / session", "workflow_batch_bind_skipped": "Binding skipped (read-only batch or missing workflow_run_id) — agents.work_next handoff=true if follow-up work is expected", "workflow_batch_context_bind_failed": "agents.reconcile_binding repair=true — batch context bind failed", "workflow_batch_receipt_failed": "Step succeeded but receipt stamp failed — agents.reconcile_binding repair=true; retry read-only agents.plan_get before mutating", "workflow_inverse_sync_failed": "agents.reconcile_binding repair=true — inverse session sync failed", "workflow_receipt_context_missing": "Active workflow receipt missing workflow_run_id or step_id — agents.reconcile_binding repair=true; agents.work_next handoff=true detail=compact", "workflow_receipt_unbound": "Workflow receipt not bound to session — agents.reconcile_binding repair=true", "workflow_scope_leak": "Batch step params.project_id disagrees with MCP context.project_id — fix the batch, not the work graph: ecosystem bus uses project_id=1 on bots.bus.* while context may be a tenant pin; StackScript/generation steps carry the subject tenant in params; omit duplicate project_id on global reads or align context via auth.switch_project. Run preflight.check — do not plan_heal_leaf or repair_plan for this error.", "workflow_state_key_stamp_failed": "agents.reconcile_binding repair=true — workflow_state_key stamp failed"}, "when_not_to_use": "Do not infer missing_roles from validation when execution_summary is present.", "when_to_use": "After VPS backend restart, first agents.work_next may fail while MCP tools import — wait ~15s and retry once (not a plan graph bug). Bound project: agents.work_next (recipe mcp_work_loop_v1) before ca", "write_mode": null}, {"action": "agents.work_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not use for autonomous closed loop or claiming — agents.work_next instead.", "anti_patterns": ["Do not use for autonomous closed loop or claiming — agents.work_next instead.", "Do not parse next_actions[0]; read packet.next_action on work_next only."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.work_status", "related_tools": ["agents.work_next", "agents.plan_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Work Status"}, "do_not_use_when": "Do not use for autonomous closed loop or claiming — agents.work_next instead.", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "execution_contract": {"dependency_ready": "Structural gate — deps, status, decomposition", "execution_ready": "Fleet gate — existing agent or provision path", "execution_summary": "Aggregated specializations + per_node template lists"}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Summary-only plan progress (state idle|waiting|blocked|actionable, plan_summary). No claim params —…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.work_next", "agents.plan_get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.work_next", "agents.plan_get"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_work_status", "semantic_input_mode": "inherit_workflow", "summary": "Plan summary only: task counts and execution-ready leaves. The packet is small; the server still reads the plan leaf to count it. No node pick.", "title": "Agents Work Status", "wave_xix_atoms": {"WG_COLD_START_VS_ROUTE": "Cold start: no project_id → agentstack_session_setup only. Do not discovery.search until context.project_id is set. Bound project: agents.work_next first; discovery.search only when packet.next_action is absent. Status-only poll → agents.work_status (no claim params).", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_PLAN_FIRST": "Lightweight progress: agents.work_status (summary_only). Full autonomous loop: agents.work_next — follow next_action, not next_actions[0] parsing."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not use for autonomous closed loop or claiming — agents.work_next instead.", "when_to_use": "Summary-only plan progress (state idle|waiting|blocked|actionable, plan_summary). No claim params — use agents.work_next for executable leaf + canonical next_action.", "write_mode": null}, {"action": "agents.plan_reconcile_diagnostics", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_reconcile_diagnostics", "mutation_risk": "low", "related_tools": ["agents.reconcile_binding", "agents.plan_get", "agents.plan_propose", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Plan Reconcile Diagnostics"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "After fleet heal or agents.reconcile_binding on home=project|self|project_self — close open diag-* …", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_propose", "agents.plan_get", "agents.work_next"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.reconcile_binding", "agents.plan_get", "agents.plan_propose", "agents.work_next"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_plan_reconcile_diagnostics", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Auto-complete open diagnostic plan nodes when live findings are cleared (statuses_toward_completed: typically pending→verifying→completed).", "title": "Agents Plan Reconcile Diagnostics", "wave_xix_atoms": {"MCP_DOMAIN_ERROR": "Domain denial: tools/call isError=false with structuredContent (ok=false, error_code, failure_kind=domain, recovery). Transport/internal uses isError=true (failure_kind=transport). plan_revision_conflict → agents.plan_get then retry with fresh if_match_revision.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks."}, "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After fleet heal or agents.reconcile_binding on home=project|self|project_self — close open diag-* nodes with finding_absent evidence; env_uuid only with home=project.", "write_mode": null}, {"action": "agents.reconcile_binding", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "mutates_when": {"repair": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.reconcile_binding", "mutates_when": {"repair": true}, "mutation_risk": "low", "recovery_blocks": {"guidance_user_row_not_found": {"next_actions": [{"action": "agents.work_next", "params": {"handoff": true}}], "reason": "guidance_user_row_not_found"}, "orchestrator_binding_stale": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "orchestrator_binding_stale"}, "work_next_enrich_failed": {"next_actions": [{"action": "agents.work_next", "params": {"detail": "compact", "handoff": true}}], "reason": "work_next_enrich_failed"}, "work_next_repeat_reconcile_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "work_next_repeat_reconcile_failed"}, "workflow_batch_bind_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_bind_failed"}, "workflow_batch_bind_skipped": {"next_actions": [{"action": "agents.work_next", "params": {"repair": true}}], "reason": "workflow_batch_bind_skipped"}, "workflow_batch_context_bind_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_context_bind_failed"}, "workflow_batch_receipt_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_batch_receipt_failed"}, "workflow_inverse_sync_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_inverse_sync_failed"}, "workflow_receipt_context_missing": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_context_missing"}, "workflow_receipt_unbound": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_unbound"}, "workflow_state_key_stamp_failed": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_state_key_stamp_failed"}}, "related_tools": ["agents.fleet_diagnostics", "agents.plan_get", "agents.plan_execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Reconcile Binding"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_param_sensitive": true, "conditional_mutate": "repair=false — orchestrator/fleet preview only (no DNA or fleet writes); repair=true (default) may rebind or reprovision.", "effect_depends_on_params": true, "execution_class": "cheap", "generation": true, "kind": "mutate", "mutates_when": {"repair": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Validate/repair orchestrator agent_uuid vs fleet index. repair=true mutates binding. Pass home=proj…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.fleet_diagnostics", "agents.plan_get", "agents.plan_execute"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.fleet_diagnostics", "agents.plan_get", "agents.plan_execute"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_reconcile_binding", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Validate and repair project orchestrator agent_uuid vs fleet index and lineage.", "title": "Agents Reconcile Binding", "wave_xix_atoms": {"MCP_DOMAIN_ERROR": "Domain denial: tools/call isError=false with structuredContent (ok=false, error_code, failure_kind=domain, recovery). Transport/internal uses isError=true (failure_kind=transport). plan_revision_conflict → agents.plan_get then retry with fresh if_match_revision.", "WG_BIND_VS_CLAIM": "node.agent_id binding ≠ active claim lease — already_claimed requires status=in_progress with non-expired lease meta; bound agent on ready/pending is not already_claimed; retry ensure_agent idempotent_replay or plan_claim with if_match_revision.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks."}, "when_blocked": {"agent_daily_cap": "Agent per_day_cap hit — patch AgentSpec.energy or wait for UTC day rollover.", "batch_project_scope_leak": "A failed MCP batch step with params.project_id does not retarget later steps — only auth.switch_project may promote batch context.project_id. Re-bind context.project_id before mutations if a step used a probe pid.", "batch_semantic_anchor_conflict": "Align step NL with batch goal anchor — use one goal_text for the batch or split batches", "batch_semantic_anchor_required": "Batch includes a mutating or non-plain-read step: set options.execution_intent=direct for authorized CRUD, or options.goal, focus_node_id, or plan_execute_mode for workflow. Plain reads and validate_only (e.g. script.put) may run without goal. Use preflight.check simulate_batch_actions + simulate_batch_params (or execution_intent) to preview anchor.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dependency_failed": "Prerequisite batch step did not succeed — fix or remove dependsOn; poll verification_action before retrying dependent step", "discovery_search_recursion": "Prefer discovery.list (optional domain=) to copy exact action ids, then discovery.describe. If you use discovery.search: one concrete q= per execute, then describe — do not chain many search steps; in goal-anchored batches run search in a separate execute (batch_semantic_anchor_conflict).", "energy_denied": "Insufficient builder_energy before agents.run — energy.get_balance then payments.create intent=energy_pack; follow packet.next_action.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "guidance_user_row_not_found": "auth.get_profile then agents.work_next handoff=true", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestration_step_violation": "Action outside current workflow step — follow packet next_action / inverse_resume; do not mutate graph until step advances. For ad-hoc reads (auth.get_profile) or plan writes outside the spine, rerun the batch with options.execution_mode=plain or options.execution_intent=direct on a single allowed action. For notifications.deliver inside a playbook: run preflight.check first or use packet.next_action — not a raw deliver outside the step allow-list.", "orchestrator_agent_stale": "Bound agent_uuid no longer matches fleet — agents.reconcile_binding repair=true; agents.ensure_agent when the template row is missing; then agents.work_next handoff=true.", "orchestrator_binding_stale": "agents.reconcile_binding repair=true", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_archive_no_effect": "Archive patch matched no nodes — agents.plan_get detail=compact; confirm archive_ids / node_id scope; use agents.plan_patch with if_match_revision, not empty ops.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "work_next_enrich_failed": "agents.work_next handoff=true detail=compact", "work_next_repeat_reconcile_failed": "agents.reconcile_binding repair=true", "workflow_batch_bind_failed": "agents.reconcile_binding repair=true — guidance bind failed; check member row / session", "workflow_batch_bind_skipped": "Binding skipped (read-only batch or missing workflow_run_id) — agents.work_next handoff=true if follow-up work is expected", "workflow_batch_context_bind_failed": "agents.reconcile_binding repair=true — batch context bind failed", "workflow_batch_receipt_failed": "Step succeeded but receipt stamp failed — agents.reconcile_binding repair=true; retry read-only agents.plan_get before mutating", "workflow_inverse_sync_failed": "agents.reconcile_binding repair=true — inverse session sync failed", "workflow_receipt_context_missing": "Active workflow receipt missing workflow_run_id or step_id — agents.reconcile_binding repair=true; agents.work_next handoff=true detail=compact", "workflow_receipt_unbound": "Workflow receipt not bound to session — agents.reconcile_binding repair=true", "workflow_scope_leak": "Batch step params.project_id disagrees with MCP context.project_id — fix the batch, not the work graph: ecosystem bus uses project_id=1 on bots.bus.* while context may be a tenant pin; StackScript/generation steps carry the subject tenant in params; omit duplicate project_id on global reads or align context via auth.switch_project. Run preflight.check — do not plan_heal_leaf or repair_plan for this error.", "workflow_state_key_stamp_failed": "agents.reconcile_binding repair=true — workflow_state_key stamp failed"}, "when_to_use": "Validate/repair orchestrator agent_uuid vs fleet index. repair=true mutates binding. Pass home=project|self|project_self to reconcile diagnostic plan nodes on that leaf; env_uuid only with home=projec", "write_mode": null}, {"action": "agents.instruction_rules_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.instruction_rules_list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Instruction Rules List"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Orchestration Studio — inspect instruction_rules before editing overlay.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_instruction_rules_list", "semantic_input_mode": "inherit_workflow", "summary": "List merged platform instruction rules (fixture + ecosystem overlay).", "title": "Agents Instruction Rules List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Orchestration Studio — inspect instruction_rules before editing overlay.", "write_mode": null}, {"action": "agents.instruction_rules_upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.instruction_rules_upsert", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Instruction Rules Upsert"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Orchestration Studio — persist operator rule overlay (ecosystem project only).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_instruction_rules_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Upsert one instruction rule on ecosystem project overlay (8DNA leaf).", "title": "Agents Instruction Rules Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Orchestration Studio — persist operator rule overlay (ecosystem project only).", "write_mode": null}, {"action": "agents.health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.health", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Health"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Ops check before agents.list when fleet_warming 503 appears.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_health", "semantic_input_mode": "inherit_workflow", "summary": "Fleet ECS index health for a project (agents/bots organelle diagnostics).", "title": "Agents Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops check before agents.list when fleet_warming 503 appears.", "write_mode": null}, {"action": "agents.graph_file_put", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not set rag_ingest without an explicit RAG/knowledge goal.", "anti_patterns": ["Do not set rag_ingest without an explicit RAG/knowledge goal.", "Do not paste file bodies into plan_patch set or node prompt — use graph_file_get.", "Do not skip storage.list_files (folder + file_id from storage_roundtrip_hint) after upload."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.graph_file_put", "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Graph File Put"}, "do_not_use_when": "Do not set rag_ingest without an explicit RAG/knowledge goal.", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "if_match_revision from plan_get; verify via storage_roundtrip_hint.", "name": "Upload with graph CAS", "request": {"params": {"content": "# Goal", "filename": "spec.md", "home": "project", "if_match_revision": 12, "node_id": "task-a", "project_id": 1}, "tool": "agents.graph_file_put"}, "response": {"data": {"revision": 13, "storage_ref": {"file_id": "abc", "folder_key": "graph__node_task-a"}, "storage_roundtrip_hint": {"file_id": "abc", "folder": "graph__node_task-a", "verify_action": "storage.list_files"}}, "success": true}}, {"description": "Pass env_uuid from generation.fork receipt; same revision discipline as agents.plan_get.", "name": "Sandbox fork (auto_generation_mode)", "request": {"params": {"content": "# Draft", "field": "prompt", "filename": "spec.md", "home": "project", "if_match_revision": 3, "node_id": "task-a", "project_id": 1}, "tool": "agents.graph_file_put"}, "response": {"data": {"revision": 4, "storage_ref": {"file_id": "abc"}}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "graph_file_mcp_errors": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "storage.read or project_admin cap missing for scope", "generation_fork_required": "auto_generation_mode on — pass env_uuid from generation.fork for home=project mutations", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "Missing required params or binary file for text edit", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "plan_revision_conflict": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal after concurrent plan_patch or graph_file_*.", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Operator session or API key required", "upload_failed": "Storage quota, extension, or organelle upload error"}, "instruction_hint": "Channel file: this stores the bytes and the run attaches storage_file_id. Do not paste that body in…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_get", "storage.list_files", "agents.graph_file_get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_graph_file_put", "semantic_input_mode": "inherit_workflow", "summary": "Upload bytes to storage and append StorageRefV1 on a plan node.", "title": "Agents Graph File Put", "wave_xix_atoms": {"WG_CAS_RETRY": "plan_revision_conflict → plan_get reload if_match_revision — never apply stale proposal after concurrent plan_patch or backlog apply.", "WG_ENV_UUID_PARITY": "Thread the same env_uuid across plan_get, plan_propose, plan_apply_proposal, plan_process_backlog, plan_recovery_scan, and work_next on sandbox forks.", "WG_STORAGE_NOT_KNOWLEDGE": "File upload / document persistence → storage.* (MCP operator or REST binary upload). Do not ingest to knowledge unless the goal requests RAG/Q&A/semantic search.", "WG_VERIFY_AFTER_WRITE": "After each platform mutation, verify via canonical read on meta.verify_after_write_action (storage.list_files, crm.list_contacts, logic.dry_run, rag.search) — attach evidence, do not mark complete from agent prose alone."}, "when_blocked": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "upload_failed": "Storage quota, extension, or organelle upload error", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not set rag_ingest without an explicit RAG/knowledge goal.", "when_to_use": "Channel file: this stores the bytes and the run attaches storage_file_id. Do not paste that body into the finish message. Manual spill (agent-authored): upload bytes to ecosystem storage, append meta.", "write_mode": null}, {"action": "agents.graph_file_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not call agents.work_next to read linked files — graph_file_get returns the text window.", "anti_patterns": ["Do not call agents.work_next to read linked files — graph_file_get returns the text window.", "Do not use for meta.body_external / chunk_id nodes — plan_get detail=body hydrates work_graph/chunks.", "Do not invent storage.preview_text — human SPA preview is FileTextPreviewPane on the public path; agents use this MCP te"], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.graph_file_get", "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Graph File Get"}, "do_not_use_when": "Do not call agents.work_next to read linked files — graph_file_get returns the text window.", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Pass file_id from meta.storage_refs; no work_next.", "name": "Text window for linked file", "request": {"params": {"file_id": "abc", "home": "project", "max_chars": 8000, "node_id": "task-a", "project_id": 1}, "tool": "agents.graph_file_get"}, "response": {"data": {"storage_ref": {"file_id": "abc", "folder_key": "graph__node_task-a"}, "text": {"content": "# Goal", "truncated": false}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "graph_file_mcp_errors": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "storage.read or project_admin cap missing for scope", "generation_fork_required": "auto_generation_mode on — pass env_uuid from generation.fork for home=project mutations", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "Missing required params or binary file for text edit", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "plan_revision_conflict": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal after concurrent plan_patch or graph_file_*.", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Operator session or API key required", "upload_failed": "Storage quota, extension, or organelle upload error"}, "instruction_hint": "Read meta.storage_refs linked files only (UTF-8 window). Do not use for plan_heal_leaf chunk seals …", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.graph_file_edit", "agents.graph_file_list"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_graph_file_get", "semantic_input_mode": "inherit_workflow", "summary": "Read a graph-linked file card and a text window (no work_next).", "title": "Agents Graph File Get", "wave_xix_atoms": {"WG_STORAGE_NOT_KNOWLEDGE": "File upload / document persistence → storage.* (MCP operator or REST binary upload). Do not ingest to knowledge unless the goal requests RAG/Q&A/semantic search."}, "when_blocked": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "upload_failed": "Storage quota, extension, or organelle upload error", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not call agents.work_next to read linked files — graph_file_get returns the text window.", "when_to_use": "Read meta.storage_refs linked files only (UTF-8 window). Do not use for plan_heal_leaf chunk seals (meta.body_external / chunk_id) — use plan_get detail=body. SPA operators: Work Graph / Storage drawe", "write_mode": null}, {"action": "agents.graph_file_edit", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not edit without if_match_revision; use expected_sha256 when bytes may race.", "anti_patterns": ["Do not edit without if_match_revision; use expected_sha256 when bytes may race."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.graph_file_edit", "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Graph File Edit"}, "do_not_use_when": "Do not edit without if_match_revision; use expected_sha256 when bytes may race.", "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "expected_sha256 from graph_file_get; verify via storage_roundtrip_hint.", "name": "Search/replace with graph CAS", "request": {"params": {"file_id": "abc", "home": "project", "if_match_revision": 12, "node_id": "task-a", "project_id": 1, "replacements": [{"find": "TODO", "replace": "DONE"}]}, "tool": "agents.graph_file_edit"}, "response": {"data": {"revision": 13, "storage_ref": {"expected_sha256": "…", "file_id": "def"}, "storage_roundtrip_hint": {"file_id": "def", "verify_action": "storage.list_files"}}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "graph_file_mcp_errors": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "storage.read or project_admin cap missing for scope", "generation_fork_required": "auto_generation_mode on — pass env_uuid from generation.fork for home=project mutations", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "Missing required params or binary file for text edit", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "plan_revision_conflict": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal after concurrent plan_patch or graph_file_*.", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Operator session or API key required", "upload_failed": "Storage quota, extension, or organelle upload error"}, "instruction_hint": "Search/replace on linked file text (same editor as hosting/KB — prompt agentstack_text_editor); opt…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.plan_get", "agents.graph_file_get", "storage.list_files"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "agents_graph_file_edit", "semantic_input_mode": "inherit_workflow", "summary": "Search/replace on a linked file, upload new blob, swap ref, delete old file.", "title": "Agents Graph File Edit", "wave_xix_atoms": {"WG_CAS_RETRY": "plan_revision_conflict → plan_get reload if_match_revision — never apply stale proposal after concurrent plan_patch or backlog apply.", "WG_STORAGE_NOT_KNOWLEDGE": "File upload / document persistence → storage.* (MCP operator or REST binary upload). Do not ingest to knowledge unless the goal requests RAG/Q&A/semantic search.", "WG_VERIFY_AFTER_WRITE": "After each platform mutation, verify via canonical read on meta.verify_after_write_action (storage.list_files, crm.list_contacts, logic.dry_run, rag.search) — attach evidence, do not mark complete from agent prose alone."}, "when_blocked": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "upload_failed": "Storage quota, extension, or organelle upload error", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not edit without if_match_revision; use expected_sha256 when bytes may race.", "when_to_use": "Search/replace on linked file text (same editor as hosting/KB — prompt agentstack_text_editor); optional expected_sha256 CAS on bytes. Uploads new blob, updates meta.storage_refs, deletes prior file_i", "write_mode": null}, {"action": "agents.graph_file_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not scan full plan_get bodies for refs — use graph_file_list.", "anti_patterns": ["Do not scan full plan_get bodies for refs — use graph_file_list."], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.graph_file_list", "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Agents Graph File List"}, "do_not_use_when": "Do not scan full plan_get bodies for refs — use graph_file_list.", "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Use after graph_file_put to complete storage_roundtrip_verified.", "name": "Refs on node + entity bindings", "request": {"params": {"home": "project", "node_id": "task-a", "project_id": 1}, "tool": "agents.graph_file_list"}, "response": {"data": {"entity_files": [{"file_id": "abc"}], "storage_refs": [{"file_id": "abc"}]}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "graph_file_mcp_errors": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "storage.read or project_admin cap missing for scope", "generation_fork_required": "auto_generation_mode on — pass env_uuid from generation.fork for home=project mutations", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "Missing required params or binary file for text edit", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "plan_revision_conflict": "CAS conflict — agents.plan_get reload if_match_revision; never apply stale proposal after concurrent plan_patch or graph_file_*.", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Operator session or API key required", "upload_failed": "Storage quota, extension, or organelle upload error"}, "instruction_hint": "List meta.storage_refs on a node plus storage rows bound to plan_node via list_by_entity.", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.graph_file_get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "plane_chooser": "Fleet: agents.list. Plan loop: plan_get → work_next → ensure_agent → plan_claim → plan_execute. dependency_ready ≠ execution_ready. execution_summary is SoT for provision gaps. blocked_reason + role_taxonomy (data↔data_engineer) — not validation.missing_roles. Draft: plan_propose + plan_apply_proposal (same env_uuid; facet_repair automatic). fap_denied on agents.update writes nothing.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["agents.plan_get", "storage.list_files", "storage.bind_entity", "agents.plan_patch", "agents.graph_file_get", "agents.graph_file_list"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "agents_graph_file_list", "semantic_input_mode": "inherit_workflow", "summary": "List storage_refs on a node plus storage.list_by_entity(plan_node).", "title": "Agents Graph File List", "wave_xix_atoms": {"WG_STORAGE_NOT_KNOWLEDGE": "File upload / document persistence → storage.* (MCP operator or REST binary upload). Do not ingest to knowledge unless the goal requests RAG/Q&A/semantic search."}, "when_blocked": {"content_required": "Pass content or content_base64", "content_shrink_blocked": "full replace would shrink file text — use search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "Omit env_uuid or set home=project and retry. self and project_self are the session row and cannot take a sandbox slice.", "file_missing_on_disk": "Card exists in DNA but bytes missing on disk", "forbidden": "Project write or project_admin required — rbac.check_permission before agents.reconcile_binding repair=true", "generation_fork_required": "auto_generation_mode on — call generation.fork (or omit env_uuid for MCP auto-fork), then retry with env_uuid from receipt on home=project", "graph_home_unknown": "home must be project, self, or project_self. Retry agents.plan_get or agents.plan_patch with one of those values.", "internal_error": "Unexpected server error — retry or diagnose", "invalid_base64": "content_base64 decode failed", "invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "node_id, storage_ref, or file card missing", "patch_apply_failed": "unified_diff did not apply — re-read agents.graph_file_get", "patch_too_large": "unified_diff exceeds max size for graph file edit", "permission_denied": "Project RBAC denied — rbac.check_permission, confirm membership, or dev-operator persona for platform substrate tools.", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "rag_embed_quota": "Embedding quota exhausted — upgrade plan or BYOK", "rag_embed_rate_limit": "OpenAI embeddings rate-limited — retry after backoff", "replacement_not_found": "find string absent in file — no write", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "Personal or session-scoped home needs a signed-in operator user_id in MCP context (or principal_user_id on the tool).", "storage_content_conflict": "expected_sha256 mismatch — re-read graph_file_get", "unauthorized": "Same as auth_required — OAuth Connect, Device Code, or Bearer from profile API key; then agentstack_session_setup and context.project_id.", "upload_failed": "Storage quota, extension, or organelle upload error", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not scan full plan_get bodies for refs — use graph_file_list.", "when_to_use": "List meta.storage_refs on a node plus storage rows bound to plan_node via list_by_entity.", "write_mode": null}], "ai": [{"action": "ai.providers.list", "aliases": ["ai.provider.list", "ai.providers", "free.ai.list", "freeai.list", "llm.providers", "llm.providers.list", "providers.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not invent provider_id outside the catalog items[].", "anti_patterns": ["Do not invent provider_id outside the catalog items[].", "Do not expect error_code energy_low — use free_calls.mode=energy_low for ranking hints."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.ai.gen1"], "id": "ai.providers.list", "related_tools": ["ai.providers.probe", "ai.providers.connect", "ai.providers.free_calls_set", "energy.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Ai Providers List"}, "domain_title": "Ai Providers MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "energy_low": "builder_energy low — buy pack or wait daily pool; Free.ai still debits energy. Next: energy.get_balance."}, "examples": [{"enabled_only": true}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.ai_providers.gen1", "core.llm.partner_providers.gen1", "core.economy.llm_energy.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Before agents.run when choosing llm.provider. Free.ai is platform_supply — users spend builder_ener…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["ai.providers.connect", "ai.providers.probe", "energy.get_balance", "agents.run"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_providers", "owner_gene": "core.mcp.ai_providers.gen1", "related_tools": ["ai.providers.probe", "ai.providers.connect", "ai.providers.free_calls_set", "energy.get_balance"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_providers_list", "semantic_input_mode": "inherit_workflow", "summary": "List LLM providers from the partner registry (openai/anthropic/gemini + OpenAI-compatible partners like freeai). Free.ai is platform_supply (debit_energy=true — users spend builder_energy). Includes d", "title": "Ai Providers List", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "energy_low": "builder_energy low — buy pack or wait daily pool; Free.ai still debits energy. Next: energy.get_balance."}, "when_to_use": "Before agents.run when choosing llm.provider. Free.ai is platform_supply — users spend builder_energy; Free.ai fulfills COGS. Keywords: freeai, platform_supply, llm_free_calls, energy. Policy mode ene", "write_mode": null}, {"action": "ai.providers.probe", "aliases": ["ai.provider.probe", "free.ai.probe", "freeai.probe", "llm.providers.probe"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not treat probe as a billed completion — energy is not debited.", "anti_patterns": ["Do not treat probe as a billed completion — energy is not debited."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.ai.gen1"], "id": "ai.providers.probe", "related_tools": ["ai.providers.connect", "ai.providers.list", "agents.run", "agents.provider_preflight", "energy.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Ai Providers Probe"}, "domain_title": "Ai Providers MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "key_missing": "No BYOK for provider — ai.providers.connect with api_key (ecosystem or project). Next: ai.providers.connect.", "probe_failed": "Credential/quota probe failed — reconnect key or pick another provider. Next: ai.providers.connect.", "provider_quota_exceeded": "Upstream quota/rate limit — wait, switch provider, or check energy.get_balance. Next: energy.get_balance.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "examples": [{"model": "qwen7b", "provider_id": "freeai"}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.ai_providers.gen1", "core.llm.partner_providers.gen1", "core.economy.llm_energy.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "After ai.providers.connect or before agents.run with preflight_required. Probes Free.ai / openai / …", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["agents.run", "agents.provider_preflight", "ai.providers.connect", "ai.providers.list"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_providers", "owner_gene": "core.mcp.ai_providers.gen1", "related_tools": ["ai.providers.connect", "ai.providers.list", "agents.run", "agents.provider_preflight", "energy.get_balance"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_providers_probe", "semantic_input_mode": "inherit_workflow", "summary": "Lightweight LLM credential/quota probe for a provider (Agents preflight).", "title": "Ai Providers Probe", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "key_missing": "No BYOK for provider — ai.providers.connect with api_key (ecosystem or project). Next: ai.providers.connect.", "probe_failed": "Credential/quota probe failed — reconnect key or pick another provider. Next: ai.providers.connect.", "provider_quota_exceeded": "Upstream quota/rate limit — wait, switch provider, or check energy.get_balance. Next: energy.get_balance.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "when_to_use": "After ai.providers.connect or before agents.run with preflight_required. Probes Free.ai / openai / anthropic / gemini credentials (no energy debit).", "write_mode": null}, {"action": "ai.providers.connect", "aliases": ["ai.provider.connect", "free.ai.connect", "freeai.connect", "llm.providers.connect"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Never put API keys in treasury.credits or projects.patch_data public leaves.", "anti_patterns": ["Never put API keys in treasury.credits or projects.patch_data public leaves."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.ai.gen1"], "id": "ai.providers.connect", "related_tools": ["ai.providers.probe", "ai.providers.free_calls_set", "energy.get_balance", "ai.providers.list"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Ai Providers Connect"}, "domain_title": "Ai Providers MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "not_found": "Ecosystem project or treasury credit row missing — check project_id. Next: projects.get_data.", "service_cap_denied": "API key lacks mcp_read/project_admin — widen caps or use Device Code full. Next: auth.get_profile.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "examples": [{"api_key": "sk-free-…", "provider_id": "freeai", "scope": "ecosystem"}], "execution_class": "cheap", "genetic_tags": ["core.mcp.ai_providers.gen1", "core.llm.partner_providers.gen1", "core.economy.llm_energy.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Store Free.ai or partner API key in protected service_keys (ecosystem or project). Never writes sec…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["ai.providers.probe", "ai.providers.free_calls_set", "energy.get_balance", "ai.providers.list"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_providers", "owner_gene": "core.mcp.ai_providers.gen1", "related_tools": ["ai.providers.probe", "ai.providers.free_calls_set", "energy.get_balance", "ai.providers.list"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "ai_providers_connect", "semantic_input_mode": "inherit_workflow", "summary": "Store an LLM provider API key in protected service_keys (ecosystem or project). Never writes secrets into treasury.credits.", "title": "Ai Providers Connect", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "not_found": "Ecosystem project or treasury credit row missing — check project_id. Next: projects.get_data.", "service_cap_denied": "API key lacks mcp_read/project_admin — widen caps or use Device Code full. Next: auth.get_profile.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "when_to_use": "Store Free.ai or partner API key in protected service_keys (ecosystem or project). Never writes secrets into treasury.credits.", "write_mode": null}, {"action": "ai.providers.free_calls_set", "aliases": ["ai.free_calls.set", "freeai.free_calls_set", "llm.free_calls.set", "llm.providers.free_calls_set"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not treat Free.ai as billing_exempt — platform_supply still debits builder_energy.", "anti_patterns": ["Do not treat Free.ai as billing_exempt — platform_supply still debits builder_energy."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.ai.gen1"], "id": "ai.providers.free_calls_set", "related_tools": ["ai.providers.list", "ai.providers.probe", "ai.providers.connect", "energy.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Ai Providers Free Calls Set"}, "domain_title": "Ai Providers MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "service_cap_denied": "API key lacks mcp_read/project_admin — widen caps or use Device Code full. Next: auth.get_profile.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "examples": [{"enabled": true, "mode": "always", "prefer": true}], "execution_class": "cheap", "genetic_tags": ["core.mcp.ai_providers.gen1", "core.llm.partner_providers.gen1", "core.economy.llm_energy.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Enable/prefer platform_supply routing (Free.ai) for catalogs, Agent defaults, and KeySelector fallb…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["ai.providers.list", "ai.providers.connect", "ai.providers.probe", "agents.run"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_providers", "owner_gene": "core.mcp.ai_providers.gen1", "related_tools": ["ai.providers.list", "ai.providers.probe", "ai.providers.connect", "energy.get_balance"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "ai_providers_free_calls_set", "semantic_input_mode": "inherit_workflow", "summary": "Set ecosystem (or project) llm_free_calls policy — enable/prefer platform_supply providers (Free.ai) that fulfill builder_energy calls.", "title": "Ai Providers Free Calls Set", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "service_cap_denied": "API key lacks mcp_read/project_admin — widen caps or use Device Code full. Next: auth.get_profile.", "validation_error": "Fix provider_id / api_key / scope params — see discovery.describe. Next: ai.providers.list."}, "when_to_use": "Enable/prefer platform_supply routing (Free.ai) for catalogs, Agent defaults, and KeySelector fallback. Users still debit builder_energy.", "write_mode": null}, {"action": "ai.chat.settings.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not poll on every user keystroke — cache per project in UI.", "Do not use settings.get to probe LLM keys — use ai.providers.probe."], "capability_descriptor": {"complexity": "simple", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.llm.partner_providers.gen1"], "id": "ai.chat.settings.get", "related_tools": ["ai.chat.settings.set", "bots.reply_source.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Chat Settings Get"}, "domain_title": "Ai Chat MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.ai_chat.gen1", "frontend.ai_chat.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Before tuning hosted chat or bus reply routing (TG 2421).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_chat", "owner_gene": "core.mcp.ai_chat.gen1", "related_tools": ["ai.chat.settings.set", "bots.reply_source.get"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_chat_settings_get", "semantic_input_mode": "inherit_workflow", "summary": "Read project light-chat LLM settings for /chat and studio (surface light_chat). Returns settings (mode, limits.messages_per_user_day, on_limit, fallback_provider) and free_ai_available for the caller.", "title": "Ai Chat Settings Get", "when_to_use": "Before tuning hosted chat or bus reply routing (TG 2421).", "write_mode": null}, {"action": "ai.chat.settings.set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not bypass RBAC by writing 8DNA directly for ecosystem.ai chat leaves."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.llm.partner_providers.gen1"], "id": "ai.chat.settings.set", "mutation_risk": "low", "related_tools": ["ai.chat.settings.get", "ai.providers.free_calls_set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Chat Settings Set"}, "domain_title": "Ai Chat MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.ai_chat.gen1", "frontend.ai_chat.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Operator chat defaults; pair with bots.reply_source.set for TG 2428.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_chat", "owner_gene": "core.mcp.ai_chat.gen1", "related_tools": ["ai.chat.settings.get", "ai.providers.free_calls_set"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "ai_chat_settings_set", "semantic_input_mode": "inherit_workflow", "summary": "Write project light-chat LLM policy: mode auto|freeai|own_key, limits.messages_per_user_day (0=unlimited), on_limit fallback|manager|stop, fallback_provider, max_tokens_per_reply. Owner/admin only (fo", "title": "Ai Chat Settings Set", "when_to_use": "Operator chat defaults; pair with bots.reply_source.set for TG 2428.", "write_mode": null}], "ai_builder": [{"action": "ai_builder.manifest.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.manifest.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Manifest Get"}, "domain_title": "Ai Builder MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Load UAM v1 manifest before compose or validate.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_builder_manifest_get", "semantic_input_mode": "inherit_workflow", "summary": "Load Unified Application Manifest (UAM v1) for the current project.", "title": "Ai Builder Manifest Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load UAM v1 manifest before compose or validate.", "write_mode": null}, {"action": "ai_builder.manifest.validate", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.manifest.validate", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Manifest Validate"}, "domain_title": "Ai Builder MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Validate UAM JSON before agents.fleet bind.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_builder_manifest_validate", "semantic_input_mode": "inherit_workflow", "summary": "Validate a UAM v1 JSON object (structure + catalog + logic templates).", "title": "Ai Builder Manifest Validate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Validate UAM JSON before agents.fleet bind.", "write_mode": null}, {"action": "ai_builder.compose.preview", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.compose.preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Compose Preview"}, "domain_title": "Ai Builder MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Deterministic compose preview (sha256 + paths).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_builder_compose_preview", "semantic_input_mode": "inherit_workflow", "summary": "Deterministic compose preview: returns content_sha256 and file paths.", "title": "Ai Builder Compose Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Deterministic compose preview (sha256 + paths).", "write_mode": null}, {"action": "ai_builder.source.list", "ai_builder_atoms": {"AI_BUILDER_LIST_ALIAS": "ai_builder.project.list aliases to ai_builder.source.list — list App Studio src/** paths, not hosting bucket bytes.", "AI_BUILDER_SOURCE_NOT_FOUND": "not_found: ai_builder.source.list first — response may include suggested_paths. New file under src/: source.patch with content= (no prior GET). Patch ladder: source.get → copy exact find substring → expected_sha256 → replacements.", "AI_BUILDER_SOURCE_VS_HOSTING": "App Studio source tree is ai_builder.source.* under src/** — static /s/ bytes are hosting.bucket.file.patch, not ai_builder.source.patch on the live bucket."}, "aliases": ["ai_builder.project.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.source.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Source List"}, "domain_title": "Ai Builder MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Read the editable React tree (src/**) before patching. Does not list /s/ bucket files.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_builder_source_list", "semantic_input_mode": "inherit_workflow", "summary": "List React source files under the project App Studio tree (src/** and related). Not hosting /s/ bucket bytes.", "title": "List App Studio Source", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read the editable React tree (src/**) before patching. Does not list /s/ bucket files.", "write_mode": null}, {"action": "ai_builder.source.get", "ai_builder_atoms": {"AI_BUILDER_SOURCE_NOT_FOUND": "not_found: ai_builder.source.list first — response may include suggested_paths. New file under src/: source.patch with content= (no prior GET). Patch ladder: source.get → copy exact find substring → expected_sha256 → replacements.", "AI_BUILDER_SOURCE_VS_HOSTING": "App Studio source tree is ai_builder.source.* under src/** — static /s/ bytes are hosting.bucket.file.patch, not ai_builder.source.patch on the live bucket."}, "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.source.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Source Get"}, "domain_title": "Ai Builder MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "view=skeleton lists names. view=symbol returns matching bodies whole until 64000 characters; a long…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_builder_source_get", "semantic_input_mode": "inherit_workflow", "summary": "Read one UTF-8 source file and its sha256.", "title": "Read App Studio Source", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id and path required (path=src/…). view=skeleton defaults to src/main.tsx.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "File missing — ai_builder.source.list; use suggested_paths when present. Create with source.patch content=.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "view=skeleton lists names. view=symbol returns matching bodies whole until 64000 characters; a longer body is truncated and is not the span to replace. A file past 64000 characters is a window; pass o", "write_mode": null}, {"action": "ai_builder.source.put", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.source.put", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Source Put"}, "domain_title": "Ai Builder MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Create or replace one src/** file. Multi-line bodies: symbols[] or real newlines — not \\\\n in JSON …", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "ai_builder_source_put", "semantic_input_mode": "inherit_workflow", "summary": "Create or replace one source file. Does not start Vite.", "title": "Ai Builder Source Put", "when_blocked": {"content_shrink_blocked": "The body is one text window of a longer file. Re-read until truncated is false, or pass allow_shrink.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "digest_mismatch": "Re-read with source.get; pass current sha256.", "file_too_large": "Split file, use storage.upload, or symbols — max 2MB per App Studio path.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "literal_escape": "JSON content with \\\\n triggers literal_escape — use symbols:[{name, replace}] with real newlines or a single \\n escape in JSON.", "path_protected": "App Studio protected entry scaffolds — for Vite journal ship use hosting.workspace.init profile=node_vite, hosting.workspace.file.put, hosting.git.init then git push agentstack HEAD:dev (not ai_builder.source.* on package.json/vite.config).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "slot_marker_missing": "Keep @slot: and @endslot in src/routes/* files.", "syntax_rejected": "Fix syntax before write; prefer symbols for multi-line bodies.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create or replace one src/** file. Multi-line bodies: symbols[] or real newlines — not \\\\n in JSON (literal_escape). Call ai_builder.build.enqueue afterwards.", "write_mode": null}, {"action": "ai_builder.source.patch", "ai_builder_atoms": {"AI_BUILDER_LITERAL_ESCAPE": "literal_escape: use symbols:[{name, replace}] with real newlines in replace bodies — not \\\\n in JSON strings. Prefer symbol edits over full-file content rewrites.", "AI_BUILDER_MAIN_REWIRE": "Rewiring src/main.tsx imports: allow_shrink=true when removing blocks; fix syntax_rejected with smaller find/replace (one import line). Route shell lives in src/routes/Route0.tsx — not ./routes/Route0 from wrong folder.", "AI_BUILDER_SOURCE_VS_HOSTING": "App Studio source tree is ai_builder.source.* under src/** — static /s/ bytes are hosting.bucket.file.patch, not ai_builder.source.patch on the live bucket.", "AI_BUILDER_VS_GENERATION": "generation.* forks 8DNA config (bots, knowledge, project data) on paid tiers — not the hosting workspace. A browser game ships with hosting.git + hosting.site.build, not ai_builder.source.patch. sandbox_not_available on Free means upgrade for 8DNA sandbox — not a blocker for hosting workspace writes."}, "aliases": ["app.patch"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not patch assets/index-*.js — that is build output.", "Do not use hosting.bucket.file.patch for App Studio source paths.", "Do not send full-file content for large App.tsx — use symbols to avoid syntax_rejected loops.", "Do not call mcp_app_studio_create_v1 as an MCP action — it is a recipe id."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.source.patch", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Source Patch"}, "do_not_use_when": "Use this for App Studio source. Static buckets use hosting.bucket.file.patch.", "domain_title": "Ai Builder MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Pass expected_sha256 from source.get. Use symbols for whole-function edits; replacements for slot text.", "name": "Symbol replace after skeleton read", "request": {"params": {"expected_sha256": "abc123…", "path": "src/routes/Route0.tsx", "symbols": [{"name": "Route0Page", "replace": "function Route0Page() {\n  return <main>@slot:page</main>;\n}\n"}]}, "tool": "ai_builder.source.patch"}, "response": {"data": {"agent_completion": {"done": true, "phase": "source"}, "path": "src/routes/Route0.tsx", "sha256": "def456…"}, "success": true}}, {"name": "Find/replace in @slot:page", "request": {"params": {"expected_sha256": "abc123…", "path": "src/routes/Route0.tsx", "replacements": [{"find": "<h1>Welcome</h1>", "replace": "<h1>Hello Studio</h1>"}]}, "tool": "ai_builder.source.patch"}, "response": {"data": {"path": "src/routes/Route0.tsx", "sha256": "…"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "One find/replace or symbols:[{name, replace}] for a whole function. Pass expected_sha256; digest_mi…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "ai_builder_source_patch", "semantic_input_mode": "inherit_workflow", "summary": "Patch one source file by replacements, a whole function, full content, or a unified diff. Never enqueues a build. Do not patch the published assets/index-*.js bundle.", "title": "Patch App Studio Source", "when_blocked": {"content_shrink_blocked": "find/replace removed too many lines — pass allow_shrink:true for intentional entrypoint shrinks, or split into smaller replacements.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "digest_mismatch": "Re-read with source.get; pass current sha256.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "literal_escape": "Use real newlines in replace bodies, not \\n literals.", "patch_apply_failed": "unified diff did not apply — source.get and retry", "path_protected": "App Studio protected entry scaffolds — for Vite journal ship use hosting.workspace.init profile=node_vite, hosting.workspace.file.put, hosting.git.init then git push agentstack HEAD:dev (not ai_builder.source.* on package.json/vite.config).", "replacement_not_found": "search_replace needs find and replace. ai_builder.source.get and confirm the substring.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "slot_marker_missing": "Keep @slot: and @endslot in src/routes/* files.", "symbol_not_found": "source.get view=skeleton to list names, then retry.", "syntax_rejected": "Fix syntax before write; try symbols or smaller replacements.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Use this for App Studio source. Static buckets use hosting.bucket.file.patch.", "when_to_use": "One find/replace or symbols:[{name, replace}] for a whole function. Pass expected_sha256; digest_mismatch writes nothing. A truncated source.get window is refused unless allow_shrink is true. Do not p", "write_mode": null}, {"action": "ai_builder.compose.apply", "ai_builder_atoms": {"AI_BUILDER_RECIPE_NOT_TOOL": "mcp_app_studio_* are recipes (executable=false) — run via recipe runner or ai_builder.compose.apply / build.enqueue, not agentstack.execute with recipe id as action."}, "aliases": ["ai_builder.create", "app.scaffold"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.compose.apply", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Compose Apply"}, "domain_title": "Ai Builder MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Create the React skeleton from a blueprint, then patch slots.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "ai_builder_compose_apply", "semantic_input_mode": "inherit_workflow", "summary": "Materialize a blueprint or UAM onto the project source tree. Does not run Vite.", "title": "Ai Builder Compose Apply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create the React skeleton from a blueprint, then patch slots.", "write_mode": null}, {"action": "ai_builder.build.enqueue", "ai_builder_atoms": {"AI_BUILDER_BUILD_FAILED_RECOVERY": "Vite parse error in errors[0].file:line. source.get view=symbol, source.patch once, build.enqueue again. Browserslist/caniuse warnings are not failures.", "AI_BUILDER_RECIPE_NOT_TOOL": "mcp_app_studio_* are recipes (executable=false) — run via recipe runner or ai_builder.compose.apply / build.enqueue, not agentstack.execute with recipe id as action.", "AI_BUILDER_VS_STACKSCRIPT": "script.put / StackScript = server-side TypeScript (@stack/runtime) on DNA slice. Browser game UI/WebGL = hosting workspace + hosting.site.build, then promote_branch to prod. Do not script.put defineRoom for a Vite SPA."}, "aliases": ["ai_builder.build", "ai_builder.build.run", "ai_builder.run"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.build.enqueue", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Build Enqueue"}, "domain_title": "Ai Builder MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "After source edits. Poll ai_builder.build.status. Do not wait inside agents.orchestrate.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "ai_builder_build_enqueue", "semantic_input_mode": "inherit_workflow", "summary": "App Studio Vite queue only. AI Builder is off for shipping a game — do not use this. Put sources on the hosting journal and hosting.site.build.", "title": "Ai Builder Build Enqueue", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After source edits. Poll ai_builder.build.status. Do not wait inside agents.orchestrate.", "write_mode": null}, {"action": "ai_builder.build.status", "ai_builder_atoms": {"AI_BUILDER_BUILD_FAILED_RECOVERY": "Vite parse error in errors[0].file:line. source.get view=symbol, source.patch once, build.enqueue again. Browserslist/caniuse warnings are not failures.", "AI_BUILDER_PUBLISH_BOUNDARY": "ai_builder.publish omits bucket_id when hosting.project.status shows primary_public_url. Do not hand-edit assets/index-*.js build output. If bucket_id_or_bucket_name_required — run hosting.site.quick_start first (or pass bucket_id from hosting.project.status)."}, "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.build.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Build Status"}, "domain_title": "Ai Builder MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Poll latest build (omit build_uuid)", "request": {"params": {}, "tool": "ai_builder.build.status"}, "response": {"data": {"agent_completion": {"done": false, "phase": "status"}, "error_code": "syntax_error", "errors": [{"file": "src/routes/Route0.tsx", "line": 12, "message": "Unexpected token"}], "next_actions": [{"action": "ai_builder.source.get", "params": {"path": "src/routes/Route0.tsx", "view": "symbol"}}, {"action": "ai_builder.source.patch"}], "status": "failed"}, "error_code": "syntax_error", "success": false}}, {"name": "Build completed", "request": {"params": {}, "tool": "ai_builder.build.status"}, "response": {"data": {"agent_completion": {"done": true, "phase": "status"}, "status": "completed"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Poll until completed, failed, or cached. Omit build_uuid for the latest build. On failed: error_cod…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "owner_gene": "core.ai_builder.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "ai_builder_build_status", "semantic_input_mode": "inherit_workflow", "summary": "Read a Vite build status, including file and line when it failed.", "title": "Check Build Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dependency_error": "Fix imports in errors[0].file — source.get view=symbol; do not patch package.json for Browserslist noise.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "syntax_error": "Fix errors[0].file:line in src/ — ai_builder.source.get view=symbol, patch once, build.enqueue again.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll until completed, failed, or cached. Omit build_uuid for the latest build. On failed: error_code syntax_error or dependency_error with errors[{file,line,message}]. Browserslist/caniuse warnings ar", "write_mode": null}, {"action": "ai_builder.publish", "ai_builder_atoms": {"AI_BUILDER_HOSTED_SESSION": "Published pages call /s/{project_id}/mcp with credentials on load — not MCP auth.login for visitors; clearSession only on HTTP 401.", "AI_BUILDER_PUBLISH_BOUNDARY": "ai_builder.publish omits bucket_id when hosting.project.status shows primary_public_url. Do not hand-edit assets/index-*.js build output. If bucket_id_or_bucket_name_required — run hosting.site.quick_start first (or pass bucket_id from hosting.project.status).", "AI_BUILDER_PUBLISH_URL_SHAPE": "After ai_builder.publish (or quick_start with publish=true): public_path is /s/{project_id}/{bucket_slug}/; public_url_absolute is https://agentstack.tech + that path (same as hosting.project.status sites.primary_public_url). WebGL/Vite games use publish after build.status completed — not quick_start HTML stub."}, "aliases": ["ai_builder.build.publish"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not store .tsx in ecosystem storage.", "Do not add a second orchestrator beside core.agents.orchestrator.gen1.", "Do not merge tenant dependencies into the shared package.json."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.publish", "related_tools": ["hosting.site.quick_start", "hosting.project.status", "ai_builder.build.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Ai Builder Publish"}, "domain_title": "App Studio pipeline", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"branch": "example_string", "bucket_id": "example_string", "project_id": 123}, "example_request": {"action": "ai_builder.publish", "params": {"branch": "example_string", "bucket_id": "example_string", "project_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.app_studio.pipeline.gen1"], "instruction_hint": "Only when the user explicitly asks to publish. Agents need approval. If bucket_id_or_bucket_name_re…", "kind": "processor", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "app_studio.pipeline", "owner_gene": "core.app_studio.pipeline.gen1", "plane": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "plane_chooser": "AI Builder compile is off for shipping site bytes — follow HOSTING_SHIP_LADDER (prompt agentstack_hosting_git_journal). App Studio edits only: ai_builder.source.* inside the studio tree — not hosting.bucket.file.patch on live /s/ output. Do not call ai_builder.build.enqueue or ai_builder.publish to go live. generation.promote is 8DNA only. mcp_app_studio_v1 phases: create → source.patch → optional studio build — prod ship is hosting git journal. Import map @agentstack/sdk is /sdk/v{version}/commerce.esm.js. view=skeleton, then symbols or replacements. Omit build_uuid and bucket_id on publish. Static HTML only: hosting.site.quick_start. Do not patch the published hashed bundle. A replacements string is literal, including JSX {{ }}. clearSession only on HTTP 401. HTTP 200 unauthorized on /s/{id}/mcp is a missing hosted cookie.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_text_editor", "agentstack_app_studio"], "related_tools": ["hosting.site.quick_start", "hosting.project.status", "ai_builder.build.status"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "production_publish", "rollback": ["hosting.release.promote"], "safe_action": "ai_builder_publish", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "App Studio publish only. AI Builder is off for games — prod is hosting.git.promote_branch ref=dev target=prod, not this action.", "title": "Publish App Studio Build", "verification": ["hosting.project.status", "hosting.site.edge_health"], "verify": [{"action": "hosting.project.status", "predicate": "named resource is visible"}, {"action": "hosting.site.edge_health", "predicate": "named resource is visible"}], "when_blocked": {"bucket_id_or_bucket_name_required": "No primary hosting site — run hosting.site.quick_start first, then retry ai_builder.publish (or pass bucket_id from hosting.project.status).", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id required; bucket_id optional when primary site exists — else hosting.site.quick_start first.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "publish_failed": "Inspect error — ai_builder.build.status, fix src/, rebuild, then publish again. If no bucket: hosting.project.status then hosting.site.quick_start slug=… before ai_builder.publish.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Only when the user explicitly asks to publish. Agents need approval. If bucket_id_or_bucket_name_required — run hosting.site.quick_start first.", "write_mode": null}], "analytics": [{"action": "analytics.project_snapshot", "aliases": ["analytics.export_data", "analytics.list", "analytics.set_budget"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.analytics.gen1", "core.analytics.read_model.gen1"], "id": "analytics.project_snapshot", "related_tools": ["finance.project.analytics", "analytics.get_usage", "projects.get_stats"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Analytics Project Snapshot"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "not_found": "projects.get — verify project_id and membership.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session."}, "execution_class": "plain_read", "instruction_hint": "Dashboard / metrics / report for a project. Use finance.project.analytics only when you need P&L al…", "mutation_kind": "none", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Dashboard BFF: analytics.project_snapshot (activity, finance, CRM slices). Platform operator pid=1: analytics.platform_snapshot (adds platform_rollups). Legacy: analytics.get_usage / get_metrics — prefer project_snapshot. projects.get_stats = members/status only. P&L only: finance.project.analytics — not analytics.get_metrics for custom DNA.", "related_tools": ["finance.project.analytics", "analytics.get_usage", "projects.get_stats"], "required_cap": "analytics", "requires_preflight": false, "risk_class": "read", "safe_action": "analytics_project_snapshot", "semantic_input_mode": "inherit_workflow", "summary": "Unified project analytics snapshot: activity, finance, CRM, product events, optional business/bots/hosting slices. Prefer this over analytics.get_usage.", "title": "Analytics Project Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dashboard / metrics / report for a project. Use finance.project.analytics only when you need P&L alone.", "write_mode": null}, {"action": "analytics.platform_snapshot", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.analytics.gen1"], "id": "analytics.platform_snapshot", "related_tools": ["analytics.project_snapshot", "integrations.get_platform_diagnostics"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Analytics Platform Snapshot"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Ecosystem-wide platform rollup (project_id=1). Includes platform_rollups slice + stackscript fuel/l…", "mutation_kind": "none", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Dashboard BFF: analytics.project_snapshot (activity, finance, CRM slices). Platform operator pid=1: analytics.platform_snapshot (adds platform_rollups). Legacy: analytics.get_usage / get_metrics — prefer project_snapshot. projects.get_stats = members/status only. P&L only: finance.project.analytics — not analytics.get_metrics for custom DNA.", "related_tools": ["analytics.project_snapshot", "integrations.get_platform_diagnostics"], "required_cap": "analytics", "requires_preflight": false, "risk_class": "low_write", "safe_action": "analytics_platform_snapshot", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem platform rollup (project_id=1) with platform_rollups slice. Alias of analytics.project_snapshot — prefer for operator platform KPIs. period is echoed on the envelope; platform_rollups uses f", "title": "Analytics Platform Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem-wide platform rollup (project_id=1). Includes platform_rollups slice + stackscript fuel/load (`stackscript.dna_monthly`). `period` is echoed for other slices; platform_rollups summary window", "write_mode": null}, {"action": "analytics.get_usage", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.analytics.gen1"], "id": "analytics.get_usage", "related_tools": ["analytics.project_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Analytics Get Usage"}, "do_not_use_when": "Prefer analytics.project_snapshot for operator dashboards.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "not_found": "projects.get — verify project_id and membership.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session."}, "execution_class": "plain_read", "instruction_hint": "Quick activity counters; prefer analytics.project_snapshot for dashboards.", "mutation_kind": "none", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Dashboard BFF: analytics.project_snapshot (activity, finance, CRM slices). Platform operator pid=1: analytics.platform_snapshot (adds platform_rollups). Legacy: analytics.get_usage / get_metrics — prefer project_snapshot. projects.get_stats = members/status only. P&L only: finance.project.analytics — not analytics.get_metrics for custom DNA.", "related_tools": ["analytics.project_snapshot"], "required_cap": "analytics", "requires_preflight": false, "risk_class": "read", "safe_action": "analytics_get_usage", "semantic_input_mode": "inherit_workflow", "summary": "Project activity usage slice (members + API/exec events). Prefer analytics.project_snapshot with include=['activity']. Date filters are accepted for forward-compat but not applied.", "title": "Analytics Get Usage", "tool_chains": ["usage_monitoring"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Prefer analytics.project_snapshot for operator dashboards.", "when_to_use": "Quick activity counters; prefer analytics.project_snapshot for dashboards.", "write_mode": null}, {"action": "analytics.get_metrics", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.analytics.gen1"], "id": "analytics.get_metrics", "related_tools": ["analytics.project_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Analytics Get Metrics"}, "do_not_use_when": "Prefer project_snapshot unless reading custom metric keys.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "not_found": "projects.get — verify project_id and membership.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session."}, "execution_class": "plain_read", "instruction_hint": "Read custom counters stored in project data.metrics[].", "mutation_kind": "none", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Dashboard BFF: analytics.project_snapshot (activity, finance, CRM slices). Platform operator pid=1: analytics.platform_snapshot (adds platform_rollups). Legacy: analytics.get_usage / get_metrics — prefer project_snapshot. projects.get_stats = members/status only. P&L only: finance.project.analytics — not analytics.get_metrics for custom DNA.", "related_tools": ["analytics.project_snapshot"], "required_cap": "analytics", "requires_preflight": false, "risk_class": "read", "safe_action": "analytics_get_metrics", "semantic_input_mode": "inherit_workflow", "summary": "Custom DNA metrics array (data.metrics[]) for a project — not performance KPIs. For dashboard KPIs use analytics.project_snapshot.", "title": "Analytics Get Metrics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Prefer project_snapshot unless reading custom metric keys.", "when_to_use": "Read custom counters stored in project data.metrics[].", "write_mode": null}, {"action": "analytics.bump", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.analytics.journal.gen1"], "id": "analytics.bump", "related_tools": ["analytics.project_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Analytics Bump"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"invalid_parameters": "deltas object required — catalog keys ae, ee, pe, rc, ec, eo, ev.* only.", "not_found": "projects.get — verify project_id and membership.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session."}, "execution_class": "cheap", "instruction_hint": "Manual ring correction or integration test seeding.", "mutation_kind": "none", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Dashboard BFF: analytics.project_snapshot (activity, finance, CRM slices). Platform operator pid=1: analytics.platform_snapshot (adds platform_rollups). Legacy: analytics.get_usage / get_metrics — prefer project_snapshot. projects.get_stats = members/status only. P&L only: finance.project.analytics — not analytics.get_metrics for custom DNA.", "related_tools": ["analytics.project_snapshot"], "required_cap": "analytics", "requires_preflight": false, "risk_class": "low_write", "safe_action": "analytics_bump", "semantic_input_mode": "inherit_workflow", "summary": "Increment analytics day-ring counters (catalog keys only: ae, ee, pe, rc, ec, eo, ev.*). Prefer organic writers; use for tests or manual corrections.", "title": "Analytics Bump", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "deltas object required — catalog keys ae, ee, pe, rc, ec, eo, ev.* only.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Manual ring correction or integration test seeding.", "write_mode": null}, {"action": "analytics.events.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.analytics.gen1"], "id": "analytics.events.list", "related_tools": ["analytics.project_snapshot", "analytics.archive.query"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Analytics Events List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Game or product telemetry drill-down without loading full snapshot", "mutation_kind": "none", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Dashboard BFF: analytics.project_snapshot (activity, finance, CRM slices). Platform operator pid=1: analytics.platform_snapshot (adds platform_rollups). Legacy: analytics.get_usage / get_metrics — prefer project_snapshot. projects.get_stats = members/status only. P&L only: finance.project.analytics — not analytics.get_metrics for custom DNA.", "related_tools": ["analytics.project_snapshot", "analytics.archive.query"], "required_cap": "analytics", "requires_preflight": false, "risk_class": "read", "safe_action": "analytics_events_list", "semantic_input_mode": "inherit_workflow", "summary": "List product analytics events for a project (same rows as GET /api/analytics/events). Not included in analytics.project_snapshot.", "title": "Analytics Events List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Game or product telemetry drill-down without loading full snapshot", "write_mode": null}, {"action": "analytics.archive.query", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.analytics.journal.gen1"], "id": "analytics.archive.query", "related_tools": ["analytics.project_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Analytics Archive Query"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"archive_disabled": "Cold archive requires audit_logs and storage quota — enable policy or use live snapshot.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "not_found": "projects.get — verify project_id and membership.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session."}, "execution_class": "plain_read", "instruction_hint": "Forensic analytics after detail archived to Storage sqlite.", "mutation_kind": "none", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Dashboard BFF: analytics.project_snapshot (activity, finance, CRM slices). Platform operator pid=1: analytics.platform_snapshot (adds platform_rollups). Legacy: analytics.get_usage / get_metrics — prefer project_snapshot. projects.get_stats = members/status only. P&L only: finance.project.analytics — not analytics.get_metrics for custom DNA.", "related_tools": ["analytics.project_snapshot"], "required_cap": "analytics", "requires_preflight": false, "risk_class": "read", "safe_action": "analytics_archive_query", "semantic_input_mode": "inherit_workflow", "summary": "Read-only cold archive rows (audit_logs + storage quota). Not included in analytics.project_snapshot.", "title": "Analytics Archive Query", "when_blocked": {"archive_disabled": "Cold archive requires audit_logs and storage quota — enable policy or use live snapshot.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Set project_id or bind context.project_id before snapshot.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "projects.get — verify project_id and membership.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen API key caps (analytics) or use an operator session.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Forensic analytics after detail archived to Storage sqlite.", "write_mode": null}], "apikeys": [{"action": "apikeys.create", "aliases": ["projects.create_api_key"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not leave service_caps null in prod.", "Do not paste operator Bearer into hosted /s/ pages."], "capability_descriptor": {"complexity": "intermediate", "domain": "apikeys", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.apikeys.gen1"], "id": "apikeys.create", "mutation_risk": "low", "related_tools": ["apikeys.list", "apikeys.delete"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Apikeys Create"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"execution_error": "Internal error during key creation", "insufficient_permissions": "Caller does not have admin/owner/write role on the project", "internal_error": "Unexpected failure in PAT mint", "invalid_parameters": "service_caps must be a list or comma-separated string", "limit_exceeded": "max_user_api_keys", "project_required": "agent PAT needs project_id", "service_caps_required_in_prod": "Explicit preset or service_caps required in production", "unauthorized": "No user on the credential"}, "examples": [{"description": "User key with explicit user_full L1 caps (never null in prod)", "name": "Full-access user PAT", "request": {"actor_kind": "user", "name": "Production Key"}, "response": {"data": {"actor_kind": "user", "api_key": "<jwt-pat>", "key_id": "550e8400-e29b-41d4-a716-446655440000", "preset": "user_full", "project_id": 123, "user_id": 1}, "success": true}}, {"description": "Safe key for an AI payment agent — blocks scheduler and analytics", "name": "Payments-only key", "request": {"name": "Payment Agent Key", "service_caps": ["payments"]}, "response": {"data": {"api_key": "<jwt-pat>", "key_id": "550e8400-e29b-41d4-a716-446655440001", "project_id": 123, "service_caps": ["payments"], "user_id": 1}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Use to provision API keys for programmatic/AI-agent access. Always set service_caps when creating k…", "mutation_kind": "entity", "next_actions": ["apikeys.list"], "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "related_tools": ["apikeys.list", "apikeys.delete"], "required_cap": "api_keys|apikeys.write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "apikeys_create", "semantic_input_mode": "inherit_workflow", "summary": "Create an **agent PAT** (unified user PAT). Postel alias of `user.apikeys.create` with actor_kind=agent.", "title": "Apikeys Create", "tool_chains": ["project_bootstrap", "multi_tenant_onboarding", "multi_tenant_onboarding"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Internal error during key creation", "insufficient_permissions": "Caller does not have admin/owner/write role on the project", "internal_error": "Unexpected failure in PAT mint", "invalid_caps": "List required caps from discovery.describe on target domain actions", "invalid_parameters": "service_caps must be a list or comma-separated string", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "limit_exceeded": "Revoke unused keys (apikeys.delete) — max_user_api_keys", "project_required": "Pass project_id or bind context.project_id for agent PAT", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps on create — or use operator session", "service_caps_required_in_prod": "apikeys.create with preset user_full / mcp_write or explicit service_caps", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Bearer operator session or auth.login — not anonymous", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Use to provision API keys for programmatic/AI-agent access. Always set service_caps when creating keys for AI agents to limit blast radius.", "write_mode": null}, {"action": "apikeys.list", "aliases": ["api_keys.list", "projects.get_api_keys"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "apikeys", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.apikeys.gen1"], "id": "apikeys.list", "related_tools": ["apikeys.create", "apikeys.delete", "auth.get_profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Apikeys List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"unauthorized": "No user on the credential"}, "examples": [{"description": "Get all API keys for the current project", "name": "List keys for current project", "request": {}, "response": {"data": {"count": 1, "keys": [{"actor_kind": "agent", "created_at": "2025-01-20T10:00:00Z", "key_id": "550e8400-e29b-41d4-a716-446655440000", "key_preview": "abcd1234...", "last_used_at": "2025-01-20T09:00:00Z", "name": "Production API Key", "resource_scope": {"mode": "projects", "project_ids": [123]}, "rotatable": true, "secret_exposed": false, "service_caps": ["mcp_read"], "status": "active"}], "project_id": 123}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Audit PATs before create/delete rotation (requires api_keys cap).", "mutation_kind": "none", "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "related_tools": ["apikeys.create", "apikeys.delete", "auth.get_profile"], "required_cap": "api_keys|apikeys.read", "requires_preflight": false, "risk_class": "read", "safe_action": "apikeys_list", "semantic_input_mode": "inherit_workflow", "summary": "List personal and agent PATs (alias of user.apikeys.list).", "title": "Apikeys List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Connect MCP (G-A174) or Device Code — PAT list is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit PATs before create/delete rotation (requires api_keys cap).", "write_mode": null}, {"action": "apikeys.delete", "aliases": ["apikeys.revoke", "projects.delete_api_key"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not delete before minting replacement — secret is one-time."], "capability_descriptor": {"complexity": "intermediate", "domain": "apikeys", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.apikeys.gen1"], "id": "apikeys.delete", "mutation_risk": "high", "related_tools": ["apikeys.list", "apikeys.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Apikeys Delete"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "errors": {"insufficient_permissions": "Current user does not have permission to delete this API key", "invalid_parameters": "key_id is required", "key_not_found": "API key with specified ID does not exist or is not accessible", "unauthorized": "No user"}, "examples": [{"description": "Permanently delete an API key", "name": "Delete API key", "request": {"key_id": "550e8400-e29b-41d4-a716-446655440000"}, "response": {"data": {"deleted": true, "key_id": "550e8400-e29b-41d4-a716-446655440000"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Revoke compromised key — cannot undo.", "mutation_kind": "entity", "next_actions": ["apikeys.list"], "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_tools": ["apikeys.list", "apikeys.create"], "required_cap": "api_keys|apikeys.write", "requires_preflight": true, "risk_class": "destructive", "safe_action": "apikeys_delete", "semantic_input_mode": "inherit_workflow", "summary": "Delete an API key permanently.", "title": "Apikeys Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Current user does not have permission to delete this API key", "invalid_parameters": "Pass non-empty key_id UUID", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_not_found": "key_id from apikeys.list — user-owned PAT only", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Same session that created the PAT", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke compromised key — cannot undo.", "write_mode": null}, {"action": "apikeys.update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.apikeys.gen1"], "id": "apikeys.update", "mutation_risk": "low", "related_tools": ["user.apikeys.update", "apikeys.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Apikeys Update"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Same as user.apikeys.update.", "mutation_kind": "entity", "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "related_tools": ["user.apikeys.update", "apikeys.list"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "apikeys_update", "semantic_input_mode": "inherit_workflow", "summary": "Alias of user.apikeys.update — update PAT name/status.", "title": "Apikeys Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Same as user.apikeys.update.", "write_mode": null}], "assets": [{"action": "assets.list_presets", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.list_presets", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets List Presets"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List deterministic asset wizard presets for the project.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "assets_list_presets", "semantic_input_mode": "inherit_workflow", "summary": "List deterministic asset wizard presets for the project.", "title": "Assets List Presets", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — presets are project-scoped", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List deterministic asset wizard presets for the project.", "write_mode": null}, {"action": "assets.create", "aliases": ["assets.mint"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not replace data.assets.items[] via projects.patch_data — use assets.create.", "anti_patterns": ["Do not replace data.assets.items[] via projects.patch_data — use assets.create.", "Do not create a second asset when list is empty — sandbox head is kept server-side."], "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.create", "mutation_risk": "low", "related_tools": ["assets.get", "assets.list", "assets.update", "commerce.storefront.seed_apply"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Create"}, "commerce_atoms": {"ASSETS_SANDBOX_HEAD": "Empty assets.list after assets.create is the sandbox head — server keeps the row; do not patch data.assets.items[] manually.", "CHECKOUT_TIER_GATE": "payments.create blocked by feature gate — buffs.get_effective_limits; payments.get_balance and payments.list_methods before retry."}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"name": "GOLD", "preset_id": "game_currency", "price_usdt": "0.00", "type": "currency"}, "example_request": {"action": "assets.create", "params": {"name": "GOLD", "preset_id": "game_currency", "price_usdt": "0.00", "type": "currency"}}, "examples": [{"description": "Create a game card with attack, HP, and mana cost", "name": "Create game card", "request": {"components": {"game": {"stats": {"attack": 5, "hp": 10, "mana_cost": 3}}, "properties": {"tradeable": false}, "visual": {"image_url": "https://example.com/card.png"}}, "name": "card_10hp_5atk", "price_usdt": "0.00", "type": "digital_item"}, "response": {"data": {"components": {"game": {"stats": {"attack": 5, "hp": 10, "mana_cost": 3}}, "properties": {"tradeable": false}, "visual": {"image_url": "https://example.com/card.png"}}, "id": "550e8400-e29b-41d4-a716-446655440000", "name": "card_10hp_5atk", "price_usdt": "0.00", "project_id": 123, "type": "digital_item"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Digital commerce asset — prefer over custom product tables.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.get", "assets.list", "assets.update", "commerce.storefront.seed_apply"], "required_cap": "assets_write", "requires_preflight": false, "risk_class": "low_write", "rollback": ["assets.delete"], "safe_action": "assets_create", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a new asset for the project.", "title": "Assets Create", "tool_chains": ["project_bootstrap", "economy_setup", "economy_setup"], "verification": ["assets.get", "assets.list"], "verify": [{"action": "assets.get", "predicate": "named resource is visible"}, {"action": "assets.list", "predicate": "named resource is visible"}], "when_blocked": {"asset_exists": "assets.list — id collision; pick a new name or delete stale row", "batch_semantic_anchor_required": "Multi-step batches with assets.create need options.execution_intent=direct, options.goal, or preflight.check simulate_batch_actions — not bare execute chains", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "generation sandbox head may apply — assets.list before second create", "insufficient_permissions": "project write + assets_write cap", "internal_error": "scoped env_uuid invalid or DNA fault — agentstack_diagnose", "invalid_structure": "components must match preset schema — assets.list_presets", "invalid_type": "type must be a known asset type — assets.list_presets", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "name_required": "name is required — assets.list_presets for a starter row", "project_id_required": "context.project_id bound — pass project_id on create", "read_back_miss": "DNA write succeeded but items[] read-back missed id — retry assets.list; if empty, generation.realign_to_prod or assets.reindex on stale memo/index", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with assets_write in service_caps; member role does not auto-widen — use owner/admin session or explicit assets_write on the key", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unknown_preset": "assets.list_presets — preset slug from catalog row", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "generation sandbox head — assets.list then retry; agentstack_diagnose if persists"}, "when_to_use": "Digital commerce asset — prefer over custom product tables.", "write_mode": null}, {"action": "assets.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.get", "related_tools": ["assets.list", "assets.create", "assets.update"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve asset details by asset ID", "name": "Get asset by ID", "request": {"asset_id": "asset_a1b2c3d4e5f6"}, "response": {"data": {"components": {"game": {"stats": {"attack": 5, "hp": 10, "mana_cost": 3}}, "properties": {"tradeable": false}, "visual": {"image_url": "https://example.com/card.png"}}, "id": "550e8400-e29b-41d4-a716-446655440000", "name": "card_10hp_5atk", "price_usdt": "0.00", "type": "digital_item"}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Verify assets.create receipt or load full row before assets.update or storefront seed.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.list", "assets.create", "assets.update"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "assets_get", "semantic_input_mode": "inherit_workflow", "summary": "Get asset details by ID.", "title": "Assets Get", "when_blocked": {"asset_not_found": "assets.list — opaque asset_id as returned by create/list", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "index_card_only": "shape.mode=index_card — items[] missing row; assets.reindex or retry after create commit", "invalid_parameters": "asset_id required — opaque id from assets.create or assets.list", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — pass project_id on get", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify assets.create receipt or load full row before assets.update or storefront seed.", "write_mode": null}, {"action": "assets.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not treat empty list as missing product — may be generation sandbox head.", "anti_patterns": ["Do not treat empty list as missing product — may be generation sandbox head.", "Wallets hold balance — assets.list is catalog only.", "Do not use projection=full for pick-lists — summary avoids loading assets.items[]."], "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.list", "related_tools": ["assets.get", "assets.update", "assets.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets List"}, "commerce_atoms": {"ASSETS_LIST_PAGINATION": "Page with limit (default 100, max 1000) and offset; has_more or offset + len(items) < count for next page. total is canonical catalog size.", "ASSETS_LIST_PROJECTION": "assets.list defaults to projection=summary (ECS index). Use projection=full or assets.get for components/price_usdt; scope.drift → assets.reindex then re-list. Index-light filters: type, rarity, tradeable, lifecycle, category, q, cross_project — no items[] read on summary path.", "ASSETS_SANDBOX_HEAD": "Empty assets.list after assets.create is the sandbox head — server keeps the row; do not patch data.assets.items[] manually.", "PAYMENTS_NO_LIST": "payments.list does not exist — use payments.get_balance, payments.get, or wallets.list."}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Get all assets in the project", "name": "List all assets", "request": {"project_id": 123}, "response": {"data": {"count": 1, "items": [{"id": "asset_a1b2c3d4e5f6", "name": "card_10hp_5atk", "status": "active", "type": "digital_item"}], "limit": 100, "offset": 0, "projection": "summary", "scope": {"canonical_total": 1, "drift": false}, "total": 1}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Catalog pick-list: default summary (index cards). Use assets.get or projection=full for components/…", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.get", "assets.update", "assets.create"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "assets_list", "semantic_input_mode": "inherit_workflow", "summary": "Page catalog assets (default projection=summary, limit 100, max 1000).", "title": "Assets List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — tenant: empty list may be sandbox head; platform pid≤1: check scope.drift and counts.assets", "scope_drift": "response.scope.drift true — assets.reindex then assets.list again; summary uses ECS index only (no items[] read); projection=full loads items[]", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Catalog pick-list: default summary (index cards). Use assets.get or projection=full for components/price. If scope.drift, assets.reindex then re-list. Paginate: limit default 100 (max 1000), offset; t", "write_mode": null}, {"action": "assets.update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.update", "mutation_risk": "low", "related_tools": ["assets.get", "assets.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Update"}, "commerce_atoms": {"ASSETS_SANDBOX_HEAD": "Empty assets.list after assets.create is the sandbox head — server keeps the row; do not patch data.assets.items[] manually."}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"asset_id": "asset_a1b2c3d4e5f6", "components": {}, "data": {"quote_asset_name": "Gold", "symbol": "CR"}, "name": "example_string", "price_usdt": "example_string"}, "example_request": {"action": "assets.update", "params": {"asset_id": "asset_a1b2c3d4e5f6", "components": {}, "data": {"quote_asset_name": "Gold", "symbol": "CR"}, "name": "example_string", "price_usdt": "example_string"}}, "examples": [{"description": "Update asset properties", "name": "Update asset", "request": {"asset_id": "550e8400-e29b-41d4-a716-446655440000", "name": "Updated Card Name", "price_usdt": "1.00"}, "response": {"data": {"id": "550e8400-e29b-41d4-a716-446655440000", "name": "Updated Card Name", "price_usdt": "1.00"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Patch asset metadata or pricing leaf.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.get", "assets.create"], "required_cap": "assets_write", "requires_preflight": false, "risk_class": "low_write", "rollback": ["assets.update"], "safe_action": "assets_update", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Update an existing asset.", "title": "Assets Update", "verification": ["assets.get"], "verify": [{"action": "assets.get", "predicate": "named resource is visible"}], "when_blocked": {"asset_not_found": "assets.list or assets.get — confirm asset id on active sandbox head", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "assets_write cap + project membership", "invalid_parameters": "patch leaf paths only — not full data.assets.items[] blob", "invalid_structure": "assets.get then patch leaf paths valid for the asset type", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_tradeable": "Set components.properties.tradeable (or transferable) true via assets.update before REST POST /projects/{id}/assets/{asset_id}/transfer — not wallets.transfer", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "update_failed": "CAS or mutate refused — assets.get then retry leaf patch", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch asset metadata or pricing leaf.", "write_mode": null}, {"action": "assets.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.delete", "mutation_risk": "low", "related_tools": ["assets.list", "assets.get", "assets.create", "assets.update"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Delete"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "example_params": {"asset_id": "asset_a1b2c3d4e5f6"}, "example_request": {"action": "assets.delete", "params": {"asset_id": "asset_a1b2c3d4e5f6"}}, "examples": [{"description": "Use asset_id exactly as returned by create/list", "name": "Delete by opaque id", "request": {"asset_id": "asset_a1b2c3d4e5f6"}}], "execution_class": "cheap", "instruction_hint": "Remove asset from catalog — check storefront refs first.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.list", "assets.get", "assets.create", "assets.update"], "required_cap": "assets_write", "requires_preflight": true, "risk_class": "destructive", "rollback": [], "safe_action": "assets_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete an asset from the project.", "title": "Assets Delete", "verification": ["assets.list"], "verify": [{"action": "assets.list", "predicate": "named resource is visible"}], "when_blocked": {"asset_not_found": "assets.list — check storefront refs before delete", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "assets_write cap required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "project_id_required": "context.project_id bound — pass project_id on delete", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove asset from catalog — check storefront refs first.", "write_mode": null}, {"action": "assets.transfer", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.transfer", "mutation_risk": "high", "related_tools": ["assets.get", "assets.update", "wallets.transfer"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Transfer"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Transfer tradeable item", "request": {"asset_id": "asset_a1b2c3d4e5f6", "quantity": 1, "to_project_id": 123, "to_user_id": 42}}], "execution_class": "cheap", "instruction_hint": "Move tradeable catalog items between users — not AGNT/agUSD wallet transfer.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.get", "assets.update", "wallets.transfer"], "required_cap": "assets_write", "requires_preflight": true, "risk_class": "financial", "safe_action": "assets_transfer", "semantic_input_mode": "inherit_workflow", "summary": "Transfer a catalog asset (inventory holding) to another user/project.", "title": "Assets Transfer", "when_blocked": {"asset_not_found": "assets.get — opaque asset_id on active sandbox head", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_holdings": "source user lacks quantity — inventory revoke failed", "insufficient_permissions": "assets_write cap + project membership on source project_id", "invalid_parameters": "asset_id plus to_user_id and to_project_id (>0); quantity defaults to 1", "inventory_failed": "grant to recipient failed after debit — retry; check inventory service", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_tradeable": "assets.update — set components.properties.tradeable or transferable true (catalog transfer is not wallets.transfer)", "operation_failed": "unexpected failure — agentstack_diagnose with trace id", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "project_id_required": "context.project_id bound — pass project_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with assets_write in service_caps", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move tradeable catalog items between users — not AGNT/agUSD wallet transfer.", "write_mode": null}, {"action": "assets.bulk_delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.bulk_delete", "mutation_risk": "low", "related_tools": ["assets.delete", "assets.list"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Bulk Delete"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Prefer over many assets.delete calls for the same project.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.delete", "assets.list"], "required_cap": "assets_write", "requires_preflight": true, "risk_class": "destructive", "safe_action": "assets_bulk_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete multiple catalog assets in one write (REST bulk-delete parity).", "title": "Assets Bulk Delete", "when_blocked": {"asset_not_found": "assets.list — missing ids appear in failed[]", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "assets_write cap required", "invalid_parameters": "asset_ids must be a non-empty array of opaque ids", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "project_id_required": "context.project_id bound — pass project_id on bulk_delete", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Prefer over many assets.delete calls for the same project.", "write_mode": null}, {"action": "assets.bulk_update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.bulk_update", "mutation_risk": "low", "related_tools": ["assets.update", "assets.list"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Bulk Update"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Bulk lifecycle or metadata patches — not projects.patch_data on items[].", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.update", "assets.list"], "required_cap": "assets_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "assets_bulk_update", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch multiple catalog assets in one write (REST bulk-update parity).", "title": "Assets Bulk Update", "when_blocked": {"asset_not_found": "assets.list — per-row missing id in failed[]", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "assets_write cap + project membership", "invalid_parameters": "updates must be a non-empty array of rows with asset_id (or id)", "invalid_structure": "each row patch must match assets.update leaf paths", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_tradeable": "Set tradeable via assets.update before transfer — bulk patch cannot bypass transfer gate", "project_id_required": "context.project_id bound — pass project_id on bulk_update", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk lifecycle or metadata patches — not projects.patch_data on items[].", "write_mode": null}, {"action": "assets.import", "ai_tips": "Bulk migrate catalog JSON — prefer over many assets.create or patching items[].", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.import", "mutation_risk": "low", "related_tools": ["assets.list", "assets.reindex", "assets.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Import"}, "commerce_atoms": {"ASSETS_IMPORT_PARTIAL": "success=true with non-empty failed[] is partial import — fix failed rows or overwrite=true; do not re-import the whole blob via projects.patch_data."}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Import one row", "request": {"assets": [{"id": "asset_a1b2c3d4e5f6", "name": "Starter SKU", "price_usdt": "0.00", "type": "digital_item"}]}}], "execution_class": "cheap", "instruction_hint": "Bulk migrate catalog JSON — prefer over many assets.create or patching items[].", "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.list", "assets.reindex", "assets.create"], "required_cap": "assets_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "assets_import", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Bulk import catalog assets from JSON (REST parity with POST .../assets/import).", "title": "Assets Import", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "import_all_failed": "every row failed validation — fix failed[]; components defaults to {}", "import_failed": "CAS or mutate refused — assets.list; generation.realign_to_prod if sandbox stuck", "insufficient_permissions": "assets_write cap + project write", "invalid_parameters": "params.assets must be a non-empty array — same shape as catalog export rows", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "post_import": "assets.list — if scope.drift remains after import, assets.reindex once", "project_id_required": "context.project_id or params.project_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with assets_write in service_caps", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk migrate catalog JSON — prefer over many assets.create or patching items[].", "write_mode": ["merge", "patch", "upsert", "replace", "write", "delete"]}, {"action": "assets.export", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.export", "related_tools": ["assets.import", "assets.list", "assets.reindex"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Export"}, "commerce_atoms": {"ASSETS_EXPORT_HEAVY": "assets.export always reads assets.items[] once, then filters by asset_ids when set (>100 ids still one full read). Use assets.list + limit/offset for catalog UI."}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Backup or feed assets.import; pass asset_ids for bulk subset (≤100 avoids full blob). Prefer assets…", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.import", "assets.list", "assets.reindex"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "assets_export", "semantic_input_mode": "inherit_workflow", "summary": "Export all catalog rows from canonical assets.items[] (full records).", "title": "Assets Export", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "mcp_read on API key or session", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Backup or feed assets.import; pass asset_ids for bulk subset (≤100 avoids full blob). Prefer assets.list + pagination for UI pick-lists.", "write_mode": null}, {"action": "assets.reindex", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.reindex", "mutation_risk": "low", "related_tools": ["assets.list", "assets.get"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Reindex"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"project_id": 123}, "example_request": {"action": "assets.reindex", "params": {"project_id": 123}}, "execution_class": "cheap", "instruction_hint": "Heal ECS index drift after bulk import or sandbox promote.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.list", "assets.get"], "required_cap": "assets_write", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "assets_reindex", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Rebuild assets ECS index from canonical items[] (heal P6 list drift).", "title": "Assets Reindex", "verification": ["assets.list", "assets.get"], "verify": [{"action": "assets.list", "predicate": "named resource is visible"}, {"action": "assets.get", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "index_rebuild_failed": "CAS refused — assets.list scope; generation.realign_to_prod if sandbox stuck", "insufficient_permissions": "assets_write cap + project membership", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound — assets.list scope.drift before reindex", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with assets_write in service_caps", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Heal ECS index drift after bulk import or sandbox promote.", "write_mode": null}, {"action": "assets.activity", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.assets.presets.gen1"], "id": "assets.activity", "related_tools": ["assets.get", "assets.transfer", "assets.list"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Assets Activity"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Inspector timeline / support — after assets.get confirms the row exists.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.get", "assets.transfer", "assets.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "assets_activity", "semantic_input_mode": "inherit_workflow", "summary": "Recent activity for one catalog asset (execution_ecosystem_logs; transfers and ops that set asset_id). Read-only.", "title": "Assets Activity", "when_blocked": {"asset_not_found": "assets.get — confirm opaque asset_id on active head", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "asset_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id bound", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspector timeline / support — after assets.get confirms the row exists.", "write_mode": null}], "auth": [{"action": "auth.login", "aliases": ["app.auth.login", "auth.quick_auth", "identity.login", "session.create"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.login", "related_tools": ["auth.get_profile", "auth.email_otp.send", "auth.email_otp.login", "projects.get_projects"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Login"}, "domain_title": "Auth MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Authenticate user and receive JWT token", "name": "Login with email and password", "request": {"params": {"email": "user@example.com", "password": "securepassword123"}, "tool": "auth.login"}, "response": {"data": {"expires_at": "2025-01-27T10:00:00Z", "session_id": "session-uuid", "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "user": {"email": "user@example.com", "is_ecosystem": false, "name": "User Name", "project_id": 1, "role": "admin", "user_id": 1}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Tenant app user sign-in — not Cursor plugin MCP Connect.", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["auth.get_profile"], "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.get_profile", "auth.email_otp.send", "auth.email_otp.login", "projects.get_projects"], "requires_preflight": false, "risk_class": "read", "safe_action": "auth_login", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Email+password tenant sign-in — not Cursor MCP Connect. Passwordless: auth.email_otp.send → login. Session live: omit email → get_profile.", "title": "Auth Login", "when_blocked": {"authz_generation_stale": "Do not re-enter password — call auth.get_profile with backoff or REST bootstrap with X-Auth-Mint-Grace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_credentials": "auth.email_otp.send or retry password — not Cursor plugin MCP Connect", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "member_email_not_auth": "Retry with ecosystem canonical login email — project member display email cannot authenticate; auth.register if no Layer 1 auth row (AUTH_CANONICAL_IDENTITY)", "password_setup_required": "auth.password_reset.request or set-password invite before auth.login", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_found": "auth.register or passwordless OTP when account is missing", "vertical_workspace_unavailable": "Retry auth.login after brief delay — hosted vertical workspace provision failed"}, "when_to_use": "Tenant app user sign-in — not Cursor plugin MCP Connect.", "write_mode": null}, {"action": "auth.email_otp.send", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.email_otp.send", "related_tools": ["auth.email_otp.login", "auth.login", "messaging.get_auth_email_readiness"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Email Otp Send"}, "do_not_use_when": "Not Cursor plugin MCP Connect; hosted /s/ visitors use page REST OTP. Pair with auth.email_otp.login — not password auth.login alone.", "domain_title": "Auth MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Send a code, then auth.email_otp.login. Convert uses purpose=convert and the same anonymous key. Do…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.email_otp.login", "auth.login", "messaging.get_auth_email_readiness"], "requires_preflight": false, "risk_class": "low_write", "safe_action": "auth_email_otp_send", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "One-time sign-in code. purpose=login|register|convert. No auth.convert_anonymous_user tool. sent=true hides whether the account exists. needs_human: ask the human. UI: AuthWidget or <agentstack-auth>.", "title": "Auth Email Otp Send", "when_blocked": {"anonymous_session_required": "purpose=convert requires same X-API-Key anonymous principal", "channel_not_linked": "User must link bot channel (profile MFA) before channel=telegram", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "delivery_unavailable": "delivery_unavailable=true — messaging.get_auth_email_readiness; email: Mail Hub /dev/platform/environment secrets; compose RESEND_API_KEY is bootstrap-only; bot: channel=telegram + linked channel_identities; retry resend:true", "invalid_email": "Fix email param before retry", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "otp_cooldown": "HTTP 429 or cooldown replay — reuse code with same challenge_id or resend:true for new challenge_id", "rate_limited": "Backoff — do not tight-loop send", "resend_required": "Cooldown active — reuse inbox/Telegram code with same challenge_id, or resend:true for new challenge_id (invalidates prior code)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unbound_channel": "Bot channel not reachable for user_id — same as channel_not_linked", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Not Cursor plugin MCP Connect; hosted /s/ visitors use page REST OTP. Pair with auth.email_otp.login — not password auth.login alone.", "when_to_use": "Send a code, then auth.email_otp.login. Convert uses purpose=convert and the same anonymous key. Do not build a second login form.", "write_mode": null}, {"action": "auth.email_otp.login", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.email_otp.login", "related_tools": ["auth.email_otp.send", "auth.login", "auth.get_profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Email Otp Login"}, "do_not_use_when": "Not session mint without a prior auth.email_otp.send challenge_id. Not Cursor OAuth — ecosystem Bearer from this action only.", "domain_title": "Auth MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Finish passwordless login with the code the human pasted. The bearer is already stored. A server re…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.email_otp.send", "auth.login", "auth.get_profile"], "requires_preflight": false, "risk_class": "read", "safe_action": "auth_email_otp_login", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Verify the email code and mint a session. data.sessions[jti] survives a process restart. The SDK stores the bearer. Hosted flagship sends body.p. MFA: retry with mfa_ticket and mfa_code.", "title": "Auth Email Otp Login", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_key_unavailable": "GET /api/health ecosystem_session_key_source — same plane as password login 503", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "otp_expired": "auth.email_otp.send with same email", "otp_invalid": "Re-read challenge_id + otp — auth.email_otp.send again if expired", "registration_unavailable_misconfigured": "GET /api/health registration_ready — platform ops; do not retry register until true", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Not session mint without a prior auth.email_otp.send challenge_id. Not Cursor OAuth — ecosystem Bearer from this action only.", "when_to_use": "Finish passwordless login with the code the human pasted. The bearer is already stored. A server restart does not require a new login while that session row is active.", "write_mode": null}, {"action": "auth.register", "aliases": ["auth.create_user", "users.create"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.register", "related_tools": ["auth.login", "auth.email_otp.send", "auth.email_otp.login", "buffs.apply_temporary_effect"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Register"}, "domain_title": "Auth MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Register a new user", "request": {"email": "user@example.com", "name": "User", "password": "password"}, "response": {"data": {"token": "jwt-token", "user": {"email": "user@example.com", "user_id": 1}}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Create a new platform user with email + password.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.login", "auth.email_otp.send", "auth.email_otp.login", "buffs.apply_temporary_effect"], "requires_preflight": false, "risk_class": "low_write", "safe_action": "auth_register", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "New platform user (email+password). Passwordless: auth.email_otp.send purpose=register → login. Then auth.get_profile.", "title": "Auth Register", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "email_exists": "auth.login or auth.email_otp.send purpose=login", "email_required": "Email is required", "invalid_email": "Invalid email format", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "password_missing_uppercase": "Password must include an uppercase letter", "password_required": "Password is required", "password_too_short": "Password shorter than minimum for registration", "registration_unavailable_misconfigured": "GET /api/health registration_ready — fix server key plane before auth.register", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create a new platform user with email + password.", "write_mode": null}, {"action": "auth.anonymous.provision", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.anonymous.provision", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Anonymous Provision"}, "domain_title": "Auth MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Hosted game demos: mint anonymous player credentials before script.run / rooms.*. Prefer this over …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "auth_anonymous_provision", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Provision an anonymous hosted-game player for project_id. Same outcome as POST /api/auth/anonymous/provision — ephemeral guest (eph_ask_*, no DNA user row). Returns api_key, user_id (1.8B+ band), acce", "title": "Auth Anonymous Provision", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hosted game demos: mint anonymous player credentials before script.run / rooms.*. Prefer this over inventing REST paths; SPAs still use POST /api/auth/anonymous/provision.", "write_mode": null}, {"action": "auth.get_profile", "aliases": ["auth.authenticate", "auth.list", "auth.me", "auth.profile", "auth.status", "auth.whoami"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.get_profile", "related_tools": ["auth.update_profile", "auth.login"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Get Profile"}, "domain_title": "Auth MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Session probe. compact sketches neighbors; full is the HTTP profile. One jti covers memberships. Re…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["preflight.check"], "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "One jti covers every project membership allows. mutation_allowed true: do not switch_project and do not log in again. A restart rehydrates that jti from 8DNA. A page at /s/{id}/ uses the hosted cookie, not this jti.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.update_profile", "auth.login"], "requires_preflight": false, "risk_class": "read", "safe_action": "auth_get_profile", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Get the session card for the current API key.", "title": "Read Session Profile", "when_blocked": {"authz_generation_stale": "Retry auth.get_profile after short backoff — RBAC epoch bumped; do not auth.login again when session_ready was true on mint", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosted_app_required": "POST /api/hosted-apps/{pid}/session after login or guest bootstrap: trusted /s/{pid}/ Origin with no Bearer auto-provisions (guest_bootstrap.access_token) and mints the hosted_app cookie — not operator Bearer", "hosted_cookie_missing": "Open hosted /s/{pid}/ in browser or use operator Bearer", "hosted_project_mismatch": "Align cookie, X-Hosted-App-Path, and every step project_id", "hosted_step_project_id_invalid": "Fix step project_id type — must be integer storefront pid", "hosted_step_project_id_required": "Add integer project_id to each batch step params", "invalid_credential": "Revoke stale key (G-A166) — Device Code or Connect mint fresh Bearer", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_credential": "Connect G-A174 or Device Code — never empty Bearer on plugin MCP", "not_authenticated": "MCP is required and this channel has no operator session. Pick one method (any one is enough), then confirm session_ready. Do not call mcp_auth and do not retry auth.get_profile on the same unsigned plugin channel.", "opaque": "Use JWT Bearer from Connect/Device Code — raw opaque keys are not MCP session keys", "placeholder_credential": "Replace placeholder Authorization in ~/.cursor/mcp.json", "relogin_required": "Reconnect — X-Session-Action relogin_required", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_caps_required_in_prod": "JWT or PAT with service_caps=null is not MCP-unrestricted in production — tools/list may succeed while tools/call returns service_caps_required_in_prod. Recreate via apikeys.create (full_project / agents_autonomous_loop) or Device Code /agentstack-authorize with mcp_write. Confirm caps on auth.get_profile credential_plane — not tools/list alone.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "token_expired": "Connect (plugin MCP) or /agentstack-authorize — then auth.get_profile", "unauthorized": "auth.login or plugin Connect — then bind context.project_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Session probe. compact sketches neighbors; full is the HTTP profile. One jti covers memberships. Restart rehydrates it from 8DNA. Do not log in again.", "write_mode": null}, {"action": "auth.update_profile", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.update_profile", "mutation_risk": "low", "related_tools": ["auth.get_profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Update Profile"}, "domain_title": "Auth MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Update user profile", "request": {"name": "Updated Name"}, "response": {"data": {"name": "Updated Name", "user_id": 1}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Patch user profile fields (display name, locale).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.get_profile"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "auth_update_profile", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Update user profile.", "title": "Auth Update Profile", "tool_chains": ["crud_with_logic"], "when_blocked": {"authz_generation_stale": "RBAC epoch lag — retry auth.get_profile with backoff", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosted_app_required": "Hosted MCP requires session_type=hosted_app — POST /api/hosted-apps/{pid}/session", "hosted_cookie_missing": "Hosted app cookie missing for /s/{pid}/ MCP", "hosted_project_mismatch": "Cookie, path, or step project_id must match storefront pid", "hosted_step_project_id_invalid": "Hosted batch step project_id must be an integer", "hosted_step_project_id_required": "Hosted batch step missing params.project_id — use SDK mcpBatchStep", "invalid_credential": "Credential rejected — mint a new PAT or Connect", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_credential": "No API key or Bearer on the request", "not_authenticated": "MCP is required and this channel has no operator session. Pick one method (any one is enough), then confirm session_ready. Do not call mcp_auth and do not retry auth.get_profile on the same unsigned plugin channel.", "opaque": "Opaque API key not recognized — use Device Code Bearer or user PAT", "placeholder_credential": "Placeholder token in mcp.json — run Device Code or Connect", "relogin_required": "Session expired — Connect or auth.login; do not silent-retry writes", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "token_expired": "Bearer or session expired — Connect or Device Code again", "unauthorized": "User not authenticated", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch user profile fields (display name, locale).", "write_mode": null}, {"action": "auth.switch_project", "aliases": ["project.select", "projects.select", "session.switch_project"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not loop switch_project when membership already allows the mutation.", "Do not reconnect OAuth to heal stale accessible_project_ids when session_ready is true."], "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.switch_project", "related_tools": ["auth.login", "auth.get_profile", "projects.join"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Switch Project"}, "do_not_use_when": "When session_ready=true and mutation_allowed=true for context.project_id — set params.project_id only.", "domain_title": "Auth MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "mcp_community_hub_v1 step after projects.join — bind context for project_self work_next", "request": {"target_project_id": 123}, "response": {"data": {"jti": "session-jti-example", "project_id": 123, "session_handoff": {"mutation_allowed_after": true, "session_ready": true, "target_project_id": 123}, "success": true, "token_fields_redacted": ["access_token", "refresh_token", "session"], "token_type": "Bearer"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Only when auth.get_profile mutation_allowed is false. One call, then the mutation. Do not loop it a…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.login", "auth.get_profile", "projects.join"], "requires_preflight": false, "risk_class": "read", "safe_action": "auth_switch_project", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Rebind working project on the same identity session when mutation_allowed is false; for user-scoped Bearer prefer context.project_id / X-Project-ID without a new login.", "title": "Auth Switch Project", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Mint failed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_a_member": "projects.get_users — session stays valid; pick another project_id", "project_not_accessible": "Same as not_a_member — membership check via projects.get_users", "project_session_required": "auth.login or auth.get_profile before switch_project", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Caller not authenticated", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "target_project_id missing or invalid"}, "when_not_to_use": "When session_ready=true and mutation_allowed=true for context.project_id — set params.project_id only.", "when_to_use": "Only when auth.get_profile mutation_allowed is false. One call, then the mutation. Do not loop it and do not log in again. Cache miss still succeeds when projects.get_users shows the caller.", "write_mode": null}, {"action": "auth.channel_identities.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.channel_identities.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Channel Identities List"}, "domain_title": "Auth MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "List bot channel identities linked to the authenticated user profile.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "auth_channel_identities_list", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "List bot channel identities linked to the authenticated user profile.", "title": "Auth Channel Identities List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List bot channel identities linked to the authenticated user profile.", "write_mode": null}, {"action": "auth.channel_identities.revoke", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.channel_identities.revoke", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Channel Identities Revoke"}, "domain_title": "Auth MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Revoke a channel identity link by id (owner-only).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "auth_channel_identities_revoke", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Revoke a channel identity link by id (owner-only).", "title": "Auth Channel Identities Revoke", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke a channel identity link by id (owner-only).", "write_mode": null}, {"action": "auth.password_setup.mint", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.password_setup.mint", "mutation_risk": "low", "related_tools": ["auth.register", "projects.add_user"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Password Setup Mint"}, "domain_title": "Auth MCP domain", "effect": {"conditional_mutate": "Mints one-time setup token in user DNA; not a plain read despite verb mint.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "After creating a user with a random password, send this link instead of the password.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.register", "projects.add_user"], "requires_preflight": false, "risk_class": "low_write", "safe_action": "auth_password_setup_mint", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Mint a one-time /set-password URL for an existing ecosystem user. Operator-only (ecosystem owner or ecosystem admin/manage_users). The user opens the link, chooses their password, then signs in.", "title": "Auth Password Setup Mint", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Caller is not an ecosystem operator", "invalid_parameters": "user_id missing", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Caller not authenticated", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_found": "Target user does not exist in project_id=1"}, "when_to_use": "After creating a user with a random password, send this link instead of the password.", "write_mode": null}, {"action": "auth.password_reset.request", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.password_reset.request", "related_tools": ["auth.login", "auth.register", "auth.password_setup.mint"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Password Reset Request"}, "domain_title": "Auth MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "User forgot password — triggers reset email when account exists.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.login", "auth.register", "auth.password_setup.mint"], "requires_preflight": false, "risk_class": "read", "safe_action": "auth_password_reset_request", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Request a self-service password reset email for an ecosystem user. Always returns the same success message (enumeration-safe). The user opens the link in the email, sets a new password, then signs in.", "title": "Auth Password Reset Request", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_email": "Malformed email address", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "User forgot password — triggers reset email when account exists.", "write_mode": null}, {"action": "auth.confirm_email.resend", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.confirm_email.resend", "related_tools": ["auth.register", "auth.login", "messaging.get_auth_email_readiness"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Confirm Email Resend"}, "domain_title": "Auth MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "User cannot log in with email_unconfirmed — re-queue confirmation email when Mail Hub is ready.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.register", "auth.login", "messaging.get_auth_email_readiness"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "auth_confirm_email_resend", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Resend signup email confirmation for an ecosystem user (enumeration-safe). Use when login returns email_unconfirmed and the original confirmation never arrived.", "title": "Auth Confirm Email Resend", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_email": "Malformed email address", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "User cannot log in with email_unconfirmed — re-queue confirmation email when Mail Hub is ready.", "write_mode": null}, {"action": "auth.identity.resolve", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.identity.resolve", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Identity Resolve"}, "domain_title": "Identity MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Resolve canonical vs display email for a user (support / debug).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.identity", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "auth_identity_resolve", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "Resolve canonical vs display email for a user (support / debug).", "title": "Auth Identity Resolve", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Resolve canonical vs display email for a user (support / debug).", "write_mode": null}, {"action": "auth.identity.conflicts", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.identity.conflicts", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Auth Identity Conflicts"}, "domain_title": "Identity MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "List project member emails that diverge from ecosystem canonical auth email.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.identity", "owner_gene": "core.auth.hub.gen1", "plane": "Session: auth.get_profile. One jti covers every project membership allows. 8DNA rehydrates that jti. do not log in again. A page at /s/{id}/ uses the hosted cookie, not this jti.", "plane_chooser": "Session gate: auth.get_profile — session_ready + can_execute_mutation before mutate. Login: auth.login / auth.email_otp.* — not NextAuth/Clerk. Project scope: params.project_id on each execute step; auth.switch_project only when required_client_action demands handoff — not every workspace hop. MCP HTTP: X-API-Key or Bearer (OAuth/Device Code/PAT); valid X-API-Key wins when both sent; placeholder ${…} in X-API-Key does not block Bearer from Connect.", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "auth_identity_conflicts", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "session_atoms": {"HOSTED_MCP_BATCH_PROJECT_ID": "Hosted /s/{pid}/mcp execute: every step params must include integer project_id matching the storefront (SDK mcpBatchStep). Exempt discovery.list, discovery.status, auth.get_profile. Missing → hosted_step_project_id_required.", "HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "summary": "List project member emails that diverge from ecosystem canonical auth email.", "title": "Auth Identity Conflicts", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List project member emails that diverge from ecosystem canonical auth email.", "write_mode": null}], "bots": [{"action": "bots.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.list", "related_tools": ["bots.get", "bots.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots List"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Discover fleet rows before get/run. Read projection on the response — summary is not full spec. hom…", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.get", "bots.create"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_list", "semantic_input_mode": "inherit_workflow", "summary": "Default projection=summary rows are uuid, title, deployment_state, and record_status. projection=full is bot_spec.", "title": "Bots List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "bots_run capability required", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover fleet rows before get/run. Read projection on the response — summary is not full spec. home=project (default) | self | project_self — env_uuid only when home=project. owner=user lists persona", "write_mode": null}, {"action": "bots.templates", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.templates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Templates"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "List built-in bot templates before bots.create.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_templates", "semantic_input_mode": "inherit_workflow", "summary": "List built-in bot templates before bots.create.", "title": "Bots Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List built-in bot templates before bots.create.", "write_mode": null}, {"action": "bots.waba_templates", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.waba_templates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Waba Templates"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "List WhatsApp Business API templates (builtins + optional Graph sync).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_waba_templates", "semantic_input_mode": "inherit_workflow", "summary": "List WhatsApp Business API templates (builtins + optional Graph sync).", "title": "Bots Waba Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List WhatsApp Business API templates (builtins + optional Graph sync).", "write_mode": null}, {"action": "bots.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.get", "related_tools": ["bots.list", "bots.update", "bots.simulate", "bots.acl.list", "bots.acl.get_mode"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Get"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"bot_id": "00000000-0000-4000-8000-000000000001", "projection": "full"}, "example_request": {"action": "bots.get", "params": {"bot_id": "00000000-0000-4000-8000-000000000001", "projection": "full"}}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Load full agent_spec for edit or run. home=project | self | project_self — env_uuid only when home=…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.list", "bots.update", "bots.simulate", "bots.acl.list", "bots.acl.get_mode"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_get", "semantic_input_mode": "inherit_workflow", "summary": "Load full agent_spec for edit or run. home=project | self | project_self — env_uuid only when home=project (sandbox overlay). owner=user for personal rows. Omit env for production read.", "title": "Bots Get", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load full agent_spec for edit or run. home=project | self | project_self — env_uuid only when home=project (sandbox overlay). owner=user for personal rows. Omit env for production read.", "write_mode": null}, {"action": "bots.create", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not treat echo brain_mode as AI success — set brain via bots.set_brain.", "anti_patterns": ["Do not treat echo brain_mode as AI success — set brain via bots.set_brain.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.create", "mutation_risk": "low", "related_tools": ["bots.attach_channel", "bots.set_brain", "bots.go_live"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Create"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"brain_mode": "echo", "client_bot_key": "example_string", "home": "example_string", "name": "example_string", "project_id": 123, "template_id": "example_string", "template_variables": {}}, "example_request": {"action": "bots.create", "params": {"brain_mode": "echo", "client_bot_key": "example_string", "home": "example_string", "name": "example_string", "project_id": 123, "template_id": "example_string", "template_variables": {}}}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Create a draft bot row (Telegram / WhatsApp / Instagram channel). Fleet shell on business head proj…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.attach_channel", "bots.set_brain", "bots.go_live"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["bots.archive", "generation.realign_to_prod"], "safe_action": "bots_create", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a draft bot row (Telegram / WhatsApp / Instagram channel). Fleet shell on business head project_id; pass env_uuid on sandbox fleet steps after generation.fork. Use client_bot_key (tenant-assist", "title": "Bots Create", "verification": ["bots.get", "bots.list"], "verify": [{"action": "bots.get", "predicate": "named resource is visible"}, {"action": "bots.list", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be created under an open sandbox head without diff-child bootstrap (AA-10b). Fork generation env or clear head; then use scoped create overlay.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Create a draft bot row (Telegram / WhatsApp / Instagram channel). Fleet shell on business head project_id; pass env_uuid on sandbox fleet steps after generation.fork. Use client_bot_key (tenant-assist", "write_mode": null}, {"action": "bots.attach_channel", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.attach_channel", "mutation_risk": "low", "related_tools": ["bots.go_live", "bots.simulate", "bots.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Attach Channel"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Bind channel credentials after bots.create or wire_unity_telegram. When bots.health shows multiple …", "kind": "mcp_domain", "mutation_kind": "entity", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.go_live", "bots.simulate", "bots.health"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_attach_channel", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Attach a project messaging connection (telegram, max, whatsapp, …) to a bot fleet row. Idempotent: re-attach same connection_uuid prunes stale Telegram channels without tokens.", "title": "Bots Attach Channel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Bind channel credentials after bots.create or wire_unity_telegram. When bots.health shows multiple Telegram channels, re-call attach on the live connection_uuid to prune dead rows before bots.go_live.", "write_mode": null}, {"action": "bots.go_live", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.go_live", "mutation_risk": "low", "related_tools": ["bots.simulate", "bots.health", "bots.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Go Live"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"activate_webhook": true, "bot_id": "example_string", "home": "example_string", "hook_base": "example_string", "project_id": 123}, "example_request": {"action": "bots.go_live", "params": {"activate_webhook": true, "bot_id": "example_string", "home": "example_string", "hook_base": "example_string", "project_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Activate bot after channel attach + brain config.", "kind": "mcp_domain", "mutation_kind": "entity", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.simulate", "bots.health", "bots.get"], "required_cap": "bots_admin", "requires_preflight": true, "risk_class": "production_publish", "rollback": ["bots.pause", "generation.realign_to_prod"], "safe_action": "bots_go_live", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Activate bot webhooks and set lifecycle live (Telegram / MAX / WhatsApp channels).", "title": "Bots Go Live", "verification": ["bots.health", "bots.get"], "verify": [{"action": "bots.health", "predicate": "named resource is visible"}, {"action": "bots.get", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Activate bot after channel attach + brain config.", "write_mode": null}, {"action": "bots.health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "bots_atoms": ["BOTS_INBOUND_MEDIA_ENV"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.health", "related_tools": ["bots.get", "bots.simulate", "bots.go_live", "bots.attach_channel"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Health"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Channel health and channel_capabilities (media, buttons, session_window_hours) before staff_reply, …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.get", "bots.simulate", "bots.go_live", "bots.attach_channel"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_health", "semantic_input_mode": "inherit_workflow", "summary": "Channel health and channel_capabilities (media, buttons, session_window_hours) before staff_reply, broadcast, or commerce_offer attachments. media=false channels still accept files via storage.upload ", "title": "Bots Health", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Channel health and channel_capabilities (media, buttons, session_window_hours) before staff_reply, broadcast, or commerce_offer attachments. media=false channels still accept files via storage.upload", "write_mode": null}, {"action": "bots.reset_message_quota", "ai_tips": "Live bots ACK webhooks but never reply; health.quota.blocked is true. Action id is bots.reset_message_quota — there is no bots.reset_quota.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not call bots.reset_quota — the action id is bots.reset_message_quota.", "anti_patterns": ["Do not call bots.reset_quota — the action id is bots.reset_message_quota."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.reset_message_quota", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Reset Message Quota"}, "doc_audience": "operator", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Live bots ACK webhooks but never reply; health.quota.blocked is true. Action id is bots.reset_messa…", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_reset_message_quota", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Zero project ``ecosystem.bot_usage`` and the NeuroCache hot counter for the current UTC month. Use when a poisoned cache mutes live Telegram.", "title": "Bots Reset Message Quota", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "insufficient_permissions": "bots_admin cap required for quota reset.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Live bots ACK webhooks but never reply; health.quota.blocked is true. Action id is bots.reset_message_quota — there is no bots.reset_quota.", "write_mode": null}, {"action": "bots.dlq_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.dlq_list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Dlq List"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "List bot queue DLQ items before replay. Queue plane is production runtime — not sandbox 8DNA slice;…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_dlq_list", "semantic_input_mode": "inherit_workflow", "summary": "List bot queue DLQ items before replay. Queue plane is production runtime — not sandbox 8DNA slice; home/env_uuid on fleet DNA tools do not apply here.", "title": "Bots Dlq List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Operator session with bots read on project.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List bot queue DLQ items before replay. Queue plane is production runtime — not sandbox 8DNA slice; home/env_uuid on fleet DNA tools do not apply here.", "write_mode": null}, {"action": "bots.dlq_replay", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.dlq_replay", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Dlq Replay"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Replay one DLQ item after fixing root cause.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_dlq_replay", "semantic_input_mode": "inherit_workflow", "summary": "Replay one DLQ item after fixing root cause.", "title": "Bots Dlq Replay", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "dlq_id or message_id required for replay.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Replay one DLQ item after fixing root cause.", "write_mode": null}, {"action": "bots.dlq_archive", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.dlq_archive", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Dlq Archive"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Cancel DLQ rows whose last_error contains a substring (orchestrator_failed). Does not replay. Queue…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_dlq_archive", "semantic_input_mode": "inherit_workflow", "summary": "Cancel DLQ rows by last_error substring. Does not replay them.", "title": "Bots Dlq Archive", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dlq_archive_failed": "DLQ archive rejected — inspect data payload from repository", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_id_required": "context.project_id or project_id", "reason_required": "Pass reason_contains (substring of last_error)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cancel DLQ rows whose last_error contains a substring (orchestrator_failed). Does not replay. Queue plane is production runtime.", "write_mode": null}, {"action": "bots.simulate", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not pack multiple bots.simulate in one sync execute.", "Do not treat echo brain_mode as production AI success.", "Do not expect command_matched for NL fabula download asks — mentor pipeline only.", "MCP transport success≠checklist pass — refused, awaiting_agent, ok:false need human read.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "bots_atoms": ["BOTS_SIMULATE_HEAVY", "BOTS_MENTOR_EPISODIC_SKIP", "BOTS_FABULA_NAV_QA", "BOTS_INBOUND_MEDIA_ENV", "BOTS_REPLY_MAILBOX", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "heavy_llm", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "heavy", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.simulate", "recovery_blocks": {"orchestrator_binding_stale": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "orchestrator_binding_stale"}}, "related_tools": ["bots.conversations", "bots.get", "bots.set_brain", "knowledge.playground"], "semantic_input_mode": "per_step_nl", "source": "handler", "title": "Bots Simulate"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "conditional_mutate": "action=capabilities | mode=capabilities = read-only probe (no LLM). REST ai_stream ~180s per call; one heavy_llm per sync MCP batch. RAG CPU runs off the event loop; LLM still holds the request. Prefer options.async=true + discovery.job_status when the host is busy.", "effect_depends_on_params": true, "execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "effect_kind": "read", "example_params": {"bot_id": "00000000-0000-4000-8000-000000000001", "channel_kind": "telegram", "chat_type": "group", "external_user_id": "mcp-describe-group-access-probe", "text": "/access"}, "example_request": {"action": "bots.simulate", "params": {"bot_id": "00000000-0000-4000-8000-000000000001", "channel_kind": "telegram", "chat_type": "group", "external_user_id": "mcp-describe-group-access-probe", "text": "/access"}}, "examples": [{"name": "Capabilities preflight (no LLM)", "request": {"params": {"action": "capabilities", "project_id": 1}, "tool": "bots.simulate"}, "response": {"data": {"mode": "capabilities"}, "success": true}}, {"name": "1444 free fabula named nav (helper bot)", "request": {"params": {"bot_id": "a1f4c56a-5d66-40e0-8de8-68cba1d520a6", "external_user_id": "fabula-baseline-a11", "principal_user_id": 1, "project_id": 1444, "text": "Где скачать Фабулу Любви к себе?"}, "tool": "bots.simulate"}, "response": {"data": {"reply": "…lesson/view?id=345047850#a11…", "synthesis_path": "registry_named_exact"}, "success": true}}], "execution_class": "heavy", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Dry-run one bot turn (heavy_llm). Optional attachments[] simulate inbound user media (same envelope…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": [{"action": "discovery.job_status", "note": "Poll until completed or failed; do not re-run simulate to check status.", "params": {"job_id": "<job_id from async execute receipt>"}}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "bots.list projection=summary for fleet pick; bots.get for bot_spec. bots.simulate is one heavy LLM step per sync execute — use wait=false or options.async=true. Patch triggers with write_mode=merge; full menu publish uses replace.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.conversations", "bots.get", "bots.set_brain", "knowledge.playground"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_simulate", "semantic_input_mode": "per_step_nl", "summary": "Dry-run one bot brain turn without outbound. Heavy LLM: at most one per sync agentstack.execute (60s batch; 180s if this is the only heavy step). action=capabilities returns schema hints without LLM. ", "title": "Bots Simulate", "when_blocked": {"agent_killed": "Restore agent lifecycle before simulate", "agent_not_found": "bots.set_brain + live agent row — MCP success≠checklist pass", "agents_killswitch": "Clear agents global killswitch (admin fleet) before simulate", "attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "awaiting_agent": "Poll agents run or use sync simulate — not a successful checklist turn", "batch_semantic_anchor_conflict": "Split MCP batch or align semantic anchor with preflight.check.", "bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "channel_kind_required": "Pass channel or attach_channel before simulate.", "channel_media_unsupported": "Channel cannot send attachment shape; check bots.health media caps.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "corpus_empty": "Ingest KB before mentor simulate — not an RBAC error", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "orchestrator_binding_stale": "Re-bind brain to current orchestrator agent_uuid", "personal_agent_run_denied": "Personal agent runs require owner principal — use operator session", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_file_not_found": "storage_file_id missing on disk — re-upload to bots__outbound.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run one bot turn (heavy_llm). Optional attachments[] simulate inbound user media (same envelope schema as provider turns). Outbound files for staff_reply/broadcast: storage.upload folder bots__out", "write_mode": null}, {"action": "bots.conversations", "aliases": ["bots.conversations.messages"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["For agent mailboxes prefer bots.bus.inbox with handle= — clearer MCP intent.", "Do not read cross-agent pending without reply_for=<their slug> + reply_for_scope=history.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.conversations", "related_tools": ["bots.bus.inbox", "bots.bus.reply", "bots.bus.ask", "bots.bus.ack", "bots.bus.webhook.connect", "bots.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Conversations"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "List bot threads for Studio inbox / handoff. reply_for=<agent_id|agentstack> is mailbox owner; repl…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["Audit one thread: conversation_id=<cid> include_messages=true messages_limit=80", "Poll pending: reply_for=<your source_agent_id> reply_for_scope=pending — use bots.bus.inbox", "Cross-agent: reply_for=<other slug> reply_for_scope=history include_messages=true", "Download: GET .../bots/{bot_id}/media?storage_file_id= from attachment", "Agent MCP ladder: recipe mcp_bot_reply_mailbox_v1 · prompt agentstack_bot_message_bus"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.inbox", "bots.bus.reply", "bots.bus.ask", "bots.bus.ack", "bots.bus.webhook.connect", "bots.health"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_conversations", "semantic_input_mode": "inherit_workflow", "summary": "List bot conversations with handoff/needs_reply enrichment. include_messages returns the session turns the store already keeps (at most 200).", "title": "Bots Conversations", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List bot threads for Studio inbox / handoff. reply_for=<agent_id|agentstack> is mailbox owner; reply_for_scope=pending (default) = unanswered inbound to owner; history = any thread that ever targeted", "write_mode": null}, {"action": "bots.set_handoff", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.set_handoff", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Set Handoff"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Toggle handoff_active for a conversation; pair with bots.conversations to pick conversation_id.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_set_handoff", "semantic_input_mode": "inherit_workflow", "summary": "Toggle handoff_active for a conversation; pair with bots.conversations to pick conversation_id.", "title": "Bots Set Handoff", "when_blocked": {"bot_not_found": "bots.list / bots.get for a fleet bot_id on this project.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id — bots.conversations then retry.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_staff_user": "Operator session must carry user_id (reconnect MCP).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Toggle handoff_active for a conversation; pair with bots.conversations to pick conversation_id.", "write_mode": null}, {"action": "bots.staff_reply", "aliases": ["bots.bus.staff_reply", "bots.mailbox.reply"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not paste the file body into text — Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-upload to bots__outbound). MCP storage.upload does not take bytes. Do not paste the file body into text.", "anti_patterns": ["Do not paste the file body into text — Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scop", "Do not expect provider_message_id on MCP sync response — trust outbound_job_id; use bots.bus.inbox pending or worker/DLQ", "Use require_handoff: true only when handoff must be active; default require_handoff is false.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.staff_reply", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.set_handoff", "bots.conversations", "bots.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Staff Reply"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Logical agent sender with quote-reply", "request": {"params": {"bot_id": "<from bots.list>", "conversation_id": "<from bots.conversations>", "reply_to_provider_message_id": "<turn.provider_message_id>", "source_agent_id": "cursor-ops", "source_kind": "agent", "text": "Support: ticket closed — see summary below."}, "tool": "bots.staff_reply"}}], "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {k…", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["Success proof is outbound_job_id — do not hydrate bots.conversations for delivery", "Mailbox turns: bots.bus.inbox handle=<slug> reply_for_scope=pending", "bots.dlq_list when outbound worker fails"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["storage.upload", "bots.set_handoff", "bots.conversations", "bots.health"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_staff_reply", "semantic_input_mode": "inherit_workflow", "summary": "Enqueue staff/agent outbound to bots.outbound worker. MCP success is outbound_job_id only; use bots.conversations include_messages for provider_message_id and quote-reply index.", "title": "Bots Staff Reply", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "comms_not_manager_live": "Outbound queued but order_routing_live is false — bots.order_manager_bootstrap apply with sandbox env_uuid.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "bots.bus.inbox / bots.conversations for a live conversation_id.", "empty_body": "Provide text and/or attachments[].", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Multi-handle key — pass source_agent_id from bots.bus.whoami.", "handoff_not_active": "set_handoff active=true first, or pass require_handoff=false.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "not_manager_live": "A successful staff_reply does not set order_routing_live. Manager config is bots.order_manager_bootstrap (dry_run then apply with env_uuid).", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass source_agent_id this key owns, or bind one handle via bots.bus.handle.set.", "source_agent_unbound": "bots.bus.handle.set with this key first.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-uploa", "write_mode": null}, {"action": "bots.update", "ai_tips": "Always pass write_mode with commands. One /start object is merge, not replace. Studio Publish sends the full list with write_mode=replace. Empty commands=[] is blocked (commands_empty_blocked). A known phrase in reply_text: commands[].replacements [{find, replace}] (same editor as App Studio). agreement.replacements edits agreement.body. After bots.get, do not paste truncated reply_text or agreement.body — use allow_shrink only for a deliberate shorter string. See GET /mcp/actions write_modes and prompt agentstack_write_modes.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Sending commands: [{/start}] intending to edit welcome — that used to wipe the whole menu.", "anti_patterns": ["Sending commands: [{/start}] intending to edit welcome — that used to wipe the whole menu.", "Omitting write_mode on a full snapshot you meant as delete-missing (use write_mode=replace).", "Using path_updates and a partial commands list in the same call without write_mode.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "bots_atoms": ["BOTS_PATCH_SPEC"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.channel_identity.gen1"], "id": "bots.update", "mutation_risk": "low", "related_tools": ["bots.commands.upsert", "bots.get", "bots.ensure_mentor_commands"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Update"}, "collection_key": "trigger", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Change bot name, brain, commands, or agreement. Patch identity.auth_modes (email one-time code and/…", "kind": "mcp_domain", "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "bots.list projection=summary for fleet pick; bots.get for bot_spec. bots.simulate is one heavy LLM step per sync execute — use wait=false or options.async=true. Patch triggers with write_mode=merge; full menu publish uses replace.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.commands.upsert", "bots.get", "bots.ensure_mentor_commands"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_update", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Partial bot_spec update (commands, brain, name, …) — same as REST PUT. commands is a keyed list: pass write_mode (merge|replace|delete). A short commands array without write_mode merges by trigger and", "title": "Bots Update", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "commands_empty_blocked": "Use write_mode=delete with explicit triggers, not an empty list", "content_shrink_blocked": "Truncated reply_text or agreement.body — use commands[].replacements or allow_shrink=true", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "unified_diff did not apply on a string leaf in path_updates.", "replacement_not_found": "Substring not in reply_text — bots.get and retry search_replace", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head. Scoped diff-child writes only under an open head.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "Unknown write_mode.", "write_mode_unsupported": "append/prepend are not valid for commands."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Change bot name, brain, commands, or agreement. Patch identity.auth_modes (email one-time code and/or web_link site bind). Grant does not register users — /login in DM first. For one slash command pre", "write_mode": ["merge", "patch", "upsert", "replace", "write", "delete"], "write_mode_note": "Pass write_mode with commands. Prefer bots.commands.upsert for one command."}, {"action": "bots.commands.upsert", "ai_tips": "Pass commands as an array of full command objects (trigger + reply_text + buttons). Existing commands with other triggers stay. To remove a command use bots.update write_mode=delete with those triggers.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Using bots.update with a 1-item commands array (legacy wipe).", "anti_patterns": ["Using bots.update with a 1-item commands array (legacy wipe).", "Sending an empty commands list.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "bots_atoms": ["BOTS_PATCH_SPEC"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.commands.upsert", "mutation_risk": "low", "related_tools": ["bots.update", "bots.get", "bots.ensure_mentor_commands"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Commands Upsert"}, "collection_key": "trigger", "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Edit or add slash commands without sending the full menu snapshot. Bind generation_env_uuid (or rel…", "kind": "mcp_domain", "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "bots.list projection=summary for fleet pick; bots.get for bot_spec. bots.simulate is one heavy LLM step per sync execute — use wait=false or options.async=true. Patch triggers with write_mode=merge; full menu publish uses replace.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.update", "bots.get", "bots.ensure_mentor_commands"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_commands_upsert", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Merge one or more bot commands by trigger. Never replaces the command list. Use this instead of bots.update when editing /start, /help, or a single handler.", "title": "Bots Commands Upsert", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "commands_empty_blocked": "Refusing to wipe the menu.", "commands_required": "commands must be a non-empty array.", "content_shrink_blocked": "Pass allow_shrink=true only after a deliberate shorter reply", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "replacement_not_found": "replacements.find missing from that command reply_text", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head. Scoped diff-child writes only under an open head.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Edit or add slash commands without sending the full menu snapshot. Bind generation_env_uuid (or rely on MCP sandbox head). Post-mutate: three sync executes: generation.diff_vs_prod → generation.gates", "write_mode": null, "write_mode_note": "Always merge-by-trigger; never replaces the menu."}, {"action": "bots.ensure_mentor_commands", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Running unity_apply_mentor_copy_1444.py when MCP heal is available.", "anti_patterns": ["Running unity_apply_mentor_copy_1444.py when MCP heal is available.", "Healing only one channel bot when fleet has TG + MAX mentors.", "Skipping generation.promote after sandbox mutations.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.ensure_mentor_commands", "mutation_risk": "low", "related_tools": ["bots.get", "bots.commands.upsert", "bots.update", "generation.diff_vs_prod", "generation.promote", "knowledge.playground"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Ensure Mentor Commands"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Tenant mentor menu drift, missing /start nav buttons, or post-deploy TG/MAX parity fail. Prefer ove…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.get", "bots.commands.upsert", "bots.update", "generation.diff_vs_prod", "generation.promote", "knowledge.playground"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_ensure_mentor_commands", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Heal mentor /start+/menu+/operator commands + inline buttons (idempotent).", "title": "Bots Ensure Mentor Commands", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Tenant mentor menu drift, missing /start nav buttons, or post-deploy TG/MAX parity fail. Prefer over local ops scripts when MCP is available. UF_BOTS_HEAL / mcp_tenant_bots_heal_verify: idempotent men", "write_mode": null}, {"action": "bots.pause", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.pause", "mutation_risk": "low", "related_tools": ["bots.go_live", "bots.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Pause"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Pause bot and optionally deactivate webhook.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.go_live", "bots.get"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_pause", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Pause bot and optionally deactivate webhook.", "title": "Bots Pause", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Pause bot and optionally deactivate webhook.", "write_mode": null}, {"action": "bots.archive", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.archive", "mutation_risk": "low", "related_tools": ["bots.get", "bots.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Archive"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Archive a bot after go-live rollback or cleanup.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.get", "bots.list"], "required_cap": "bots_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "bots_archive", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Archive a bot after go-live rollback or cleanup.", "title": "Bots Archive", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Production fleet rows cannot be deleted/archived under an open sandbox head. Use diff-child tombstone (AA-11b) or clear generation env.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Archive a bot after go-live rollback or cleanup.", "write_mode": null}, {"action": "bots.set_brain", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.set_brain", "mutation_risk": "low", "related_tools": ["bots.get", "bots.simulate", "bots.go_live"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Set Brain"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"agent_uuid": "example_string", "allow_shrink": true, "bot_id": "example_string", "fallback_text": "example_string", "home": "example_string", "logic_id": "example_string", "mode": "example_string", "project_id": 123, "rag_collections": [], "replacements": [], "strict_diff": true, "unified_diff": "example_string"}, "example_request": {"action": "bots.set_brain", "params": {"agent_uuid": "example_string", "allow_shrink": true, "bot_id": "example_string", "fallback_text": "example_string", "home": "example_string", "logic_id": "example_string", "mode": "example_string", "project_id": 123, "rag_collections": [], "replacements": [], "strict_diff": true, "unified_diff": "example_string"}}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Wire Fleet agent or knowledge brain to the bot. Change one phrase in fallback_text with replacement…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.get", "bots.simulate", "bots.go_live"], "required_cap": "bots_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["bots.update", "generation.realign_to_prod"], "safe_action": "bots_set_brain", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Wire Fleet agent or knowledge brain to the bot. Change one phrase in fallback_text with replacements, not a full paste.", "title": "Bots Set Brain", "verification": ["bots.get", "bots.simulate"], "verify": [{"action": "bots.get", "predicate": "named resource is visible"}, {"action": "bots.simulate", "predicate": "named resource is visible"}], "when_blocked": {"content_shrink_blocked": "Use replacements or allow_shrink for a shorter fallback line", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "auto_generation_mode requires generation.fork (or env_uuid) before mutating fleet DNA.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "mode_required": "mode is required.", "replacement_not_found": "find string not in stored fallback_text", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "scoped_fleet_write_requires_diff_child": "Bind env_uuid / generation sandbox head before fleet writes. Card denorm routes to diff-child — not production entity patch_paths.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_blocked_recovery_codes": {"generation_fork_required": "generation_fork_required", "scoped_fleet_write_requires_diff_child": "scoped_fleet_write_requires_diff_child"}, "when_to_use": "Wire Fleet agent or knowledge brain to the bot. Change one phrase in fallback_text with replacements, not a full paste.", "write_mode": null}, {"action": "bots.broadcast", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not inline media bytes; same attachments envelope as bots.staff_reply.", "anti_patterns": ["Do not inline media bytes; same attachments envelope as bots.staff_reply.", "Do not assume all subscribers — dry_run may show inbox_truncated at max_recipients.", "Do not sync_fanout large lists — use default async fanout_job_id (>50 recipients).", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.broadcast", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.list", "bots.health", "bots.broadcast_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Broadcast"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Filtered mass outbound; same attachment envelope as bots.staff_reply (storage.upload → attachments[…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["storage.upload", "bots.list", "bots.health", "bots.broadcast_status"], "required_cap": "bots_admin", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "bots_broadcast", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Filtered mass outbound; same attachment envelope as bots.staff_reply (storage.upload → attachments[], no inline bytes; .md and archives as document). SMS and other no-media channels deliver files as l", "title": "Bots Broadcast", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_active": "Bot must be live or ready — bots.go_live or bots.pause off.", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id for this bot.", "empty_body": "Provide text and/or attachments[] after storage.upload.", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handoff_not_active": "Enable handoff or pass clear_handoff with staff reply.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Filtered mass outbound; same attachment envelope as bots.staff_reply (storage.upload → attachments[], no inline bytes; .md and archives as document). SMS and other no-media channels deliver files as l", "write_mode": null}, {"action": "bots.broadcast_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Read-only — does not enqueue sends or mutate 8DNA.", "Prefer fanout_job_id from bots.broadcast async response; plan_key alone works when job id expired.", "Default include_queues=false — pass include_queues=true only for SLO depth + dlq_count."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": true, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.broadcast_status", "related_tools": ["bots.broadcast", "bots.health", "bots.dlq_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Broadcast Status"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Read-only async broadcast progress after bots.broadcast returns fanout_job_id or plan_key. Surfaces…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.broadcast", "bots.health", "bots.dlq_list"], "required_cap": "bots_run", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "bots_broadcast_status", "semantic_input_mode": "inherit_workflow", "summary": "Read-only async broadcast progress after bots.broadcast returns fanout_job_id or plan_key. Surfaces coordinator job status, recipient_index vs plan_storage_ok recipient_total, and optional execute/out", "title": "Bots Broadcast Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "fanout_job_id_or_plan_key_required": "Pass fanout_job_id from bots.broadcast async response or plan_key from the same payload.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only async broadcast progress after bots.broadcast returns fanout_job_id or plan_key. Surfaces coordinator job status, recipient_index vs plan_storage_ok recipient_total, and optional execute/out", "write_mode": null}, {"action": "bots.send_commerce_offer", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Passing env_uuid when home is project_self or self.", "anti_patterns": ["Passing env_uuid when home is project_self or self.", "env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.send_commerce_offer", "related_tools": ["bots.conversations", "bots.health", "bots.staff_reply", "storage.upload"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Send Commerce Offer"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Enqueue marketplace listing card (listing_uuid, bot_id, conversation_id). Sync MCP errors: listing_…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.conversations", "bots.health", "bots.staff_reply", "storage.upload"], "required_cap": "bots_run", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "bots_send_commerce_offer", "semantic_input_mode": "inherit_workflow", "summary": "Send a commerce offer card to a bot conversation (listing UUID → outbound attachment).", "title": "Bots Send Commerce Offer", "when_blocked": {"bot_not_found": "Unknown bot_id — bots.list then retry.", "channel_not_found": "Channel binding missing on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id — bots.conversations.", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "listing_not_found": "Unknown listing_uuid — commerce catalog or bots.health shop linkage.", "no_channel": "Bot channel not resolved for this thread.", "offer_send_failed": "Offer delivery failed — verify listing_uuid, channel binding, and conversation_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enqueue marketplace listing card (listing_uuid, bot_id, conversation_id). Sync MCP errors: listing_not_found, bot_not_found, conversation_not_found, no_channel. Thumbnail delivery is async on outbound", "write_mode": null}, {"action": "bots.bus.handle.list", "aliases": ["bots.bus.handle.list_handles"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.handle.list", "related_tools": ["bots.bus.handle.set", "bots.bus.handle.release", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Handle List"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Read config.message_bus.handles for the project slice (env_uuid on sandbox).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.handle.set", "bots.bus.handle.release", "bots.bus.inbox"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_handle_list", "semantic_input_mode": "inherit_workflow", "summary": "List message-bus handles (config.message_bus.handles).", "title": "Bots Bus Handle List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read config.message_bus.handles for the project slice (env_uuid on sandbox).", "write_mode": null}, {"action": "bots.bus.whoami", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.whoami", "related_tools": ["bots.bus.handle.list", "bots.bus.handle.set", "bots.bus.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Whoami"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Which handle this key may speak as", "request": {"params": {"project_id": 1}, "tool": "bots.bus.whoami"}}], "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Introspect which @handles this MCP credential may speak as (allowed_source_agents, bound_handle). b…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["If bound_handle is null and allowed_source_agents is empty: bots.bus.handle.set", "If bound_handle is null and allowed_source_agents has entries: multi-handle — pass source_agent_id (not unbound)", "If handle_required on send: pass source_agent_id from allowed_source_agents", "Then bots.bus.inbox handle=<chosen> reply_for_scope=pending", "Budget-cheap ≠ wall-clock cheap under sticky sandbox — omit env_uuid for prod reads"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.handle.list", "bots.bus.handle.set", "bots.bus.deliver"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_whoami", "semantic_input_mode": "inherit_workflow", "summary": "Introspect message-bus handle ownership for the active MCP credential.", "title": "Bots Bus Whoami", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "null bound_handle + non-empty allowed_source_agents = multi-handle; pass source_agent_id (do not treat as unbound).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_unbound": "Empty allowed_source_agents — bots.bus.handle.set first.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Introspect which @handles this MCP credential may speak as (allowed_source_agents, bound_handle). bound_handle is set only when exactly one handle is allowed; null + non-empty allowed means multi-hand", "write_mode": null}, {"action": "bots.bus.handle.set", "aliases": ["bots.bus.handle.register"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["This call binds the handle to the current API key or session. Another key cannot speak as it.", "Calling set again adds another handle on this key. Then pass source_agent_id.", "Not a second Telegram bot — a logical sender on the project's live channel bot."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.handle.set", "mutation_risk": "low", "related_tools": ["bots.bus.handle.list", "bots.bus.handle.release", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Handle Set"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Register @handle on config.message_bus.handles and bind it to this API key or session. The same key…", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["bots.bus.handle.list — verify row", "bots.bus.inbox handle=<slug> reply_for_scope=pending", "Optional: bots.bus.webhook.connect for push wake"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.handle.list", "bots.bus.handle.release", "bots.bus.inbox"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_handle_set", "semantic_input_mode": "inherit_workflow", "summary": "Register or replace your logical @handle for mailbox routing.", "title": "Bots Bus Handle Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_charset": "Use lowercase alphanumeric + hyphen/underscore.", "handle_failed": "DNA write failed — check env_uuid / generation sandbox.", "handle_length": "Handle slug length out of allowed range", "handle_reserved": "Slug reserved — choose another.", "handle_taken": "Another key owns this handle — pick a new slug.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rate_limited": "Too many handle updates — retry after cooldown.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "signature_position_invalid": "Use prefix, suffix, or off.", "source_agent_unbound": "No API key or session on this call — cannot bind a handle.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Register @handle on config.message_bus.handles and bind it to this API key or session. The same key may own multiple handles (AgentGrok + AgentStackDev on one scoped key). Pass source_agent_id on send", "write_mode": null}, {"action": "bots.bus.handle.release", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.handle.release", "mutation_risk": "low", "related_tools": ["bots.bus.handle.set", "bots.bus.handle.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Handle Release"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Drop your handle row; does not delete conversation history.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.handle.set", "bots.bus.handle.list"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_handle_release", "semantic_input_mode": "inherit_workflow", "summary": "Release your @handle from config.message_bus.handles.", "title": "Bots Bus Handle Release", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_not_found": "No handle registered for this slug", "handle_not_owned": "Release only your handle row for this principal", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drop your handle row; does not delete conversation history.", "write_mode": null}, {"action": "bots.bus.inbox", "aliases": ["bots.bus.get", "bots.bus.get_message", "bots.bus.list", "bots.bus.message.get", "bots.bus.poll", "bots.bus.thread", "bots.inbox", "bots.mailbox.inbox", "bots.mailbox.list", "bots.mailbox.poll"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not use messaging.mailbox.* — this is the bot message bus.", "anti_patterns": ["Do not use messaging.mailbox.* — this is the bot message bus.", "Poll handle=<your bound slug>. Pending is unacked inbound for that mailbox.", "A webhook is only a wake. After POST bus.message.inbound, call bots.bus.inbox."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.inbox", "related_tools": ["bots.bus.reply", "bots.bus.ask", "bots.bus.ack", "bots.bus.deliver", "bots.conversations"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Inbox"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Pending mailbox poll", "request": {"params": {"bot_id": "<from bots.list>", "handle": "<your bound handle>", "messages_limit": 10, "reply_for_scope": "pending"}, "tool": "bots.bus.inbox"}}], "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Poll one agent mailbox: handle or source_agent_id maps to reply_for. reply_for_scope=pending + incl…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["Reply on the channel: bots.bus.reply (server stamps your handle)", "Ask the person in this thread: bots.bus.ask (same buttons as question on reply)", "Hand a note or work-graph task to another agent: bots.bus.deliver to_handle=<them>", "Read-only: bots.bus.ack message_id or provider_message_id", "Push wake: bots.bus.webhook.connect + recipe mcp_bot_message_bus_webhook_v1"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.reply", "bots.bus.ask", "bots.bus.ack", "bots.bus.deliver", "bots.conversations"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_inbox", "semantic_input_mode": "inherit_workflow", "summary": "Alias: bots.conversations with reply_for (mailbox pull). With reply_for_scope=pending and include_messages=true, returns only unacked inbound turns for that handle — not the full session transcript.", "title": "Bots Bus Inbox", "when_blocked": {"bot_not_found": "bots.list under the owning project_id, then retry inbox.", "bot_not_in_project": "bot_id is not on context.project_id — platform AgentBus lives on project_id=1.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Multi-handle key — pass handle from bots.bus.handle.list.", "internal_error": "Unexpected inbox shape — redeploy tools_bots; expect MCPResponse with conversations[].", "invalid_parameters": "Set context.project_id (or project_id param).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestrator_bot_unbound": "Bind orchestrator on message_bus or pass bot_id from bots.list (platform AgentBus: project_id=1).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass a handle this key owns, or omit source_agent_id.", "source_agent_unbound": "bots.bus.handle.set with this key first.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll one agent mailbox: handle or source_agent_id maps to reply_for. reply_for_scope=pending + include_messages=true returns only unacked inbound turns for that handle (not the full transcript). Ack w", "write_mode": null}, {"action": "bots.bus.inbox_counts", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.inbox_counts", "related_tools": ["bots.bus.inbox", "bots.conversations"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Inbox Counts"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Full inbox index counts for Bot Studio tab badges — not capped by conversations list limit. Use ins…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.inbox", "bots.conversations"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_inbox_counts", "semantic_input_mode": "inherit_workflow", "summary": "Full inbox index counts for tab badges (handoff, needs_reply, agent_mailbox, …).", "title": "Bots Bus Inbox Counts", "when_blocked": {"bot_not_found": "bots.list under the owning project_id, then retry inbox_counts.", "bot_not_in_project": "Explicit bot_id missing on project slice — list bots for context.project_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "Set context.project_id (or project_id param).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestrator_bot_unbound": "Bind orchestrator on message_bus or pass bot_id from bots.list (platform AgentBus: project_id=1).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Full inbox index counts for Bot Studio tab badges — not capped by conversations list limit. Use instead of bots.conversations limit=30 when summarizing handoff/needs_reply/agent_mailbox.", "write_mode": null}, {"action": "bots.bus.ack", "aliases": ["bots.mailbox.ack"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Ack only mail addressed to your handle. ack_forbidden means it is someone else's mailbox.", "anti_patterns": ["Ack only mail addressed to your handle. ack_forbidden means it is someone else's mailbox.", "Do not batch-ack turns for @cursor-ops when bound as AgentStackSharp/AgentGrok — use bots.bus.deliver instead.", "Prefer provider_message_id from the channel; message_id is the turn id or hlc."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.ack", "mutation_risk": "low", "related_tools": ["bots.bus.inbox", "bots.bus.reply", "bots.bus.ask", "bots.bus.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Ack"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Mark pending turn read", "request": {"params": {"bot_id": "<from bots.list>", "conversation_id": "<from inbox>", "handle": "<your bound handle>", "provider_message_id": "<preferred>"}, "tool": "bots.bus.ack"}}], "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Mark inbound turn read without outbound text. Prefer provider_message_id (Telegram message id, incl…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.inbox", "bots.bus.reply", "bots.bus.ask", "bots.bus.deliver"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_ack", "semantic_input_mode": "inherit_workflow", "summary": "Mark inbound turn acked (read) without outbound text.", "title": "Bots Bus Ack", "when_blocked": {"ack_forbidden": "Mailbox reply_target not owned by this key — bots.bus.whoami.", "bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "bot_not_in_project": "bot_id not on context.project_id — AgentBus platform bot needs project_id=1.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_id_required": "Poll bots.bus.inbox first — copy conversation_id and provider_message_id, then bots.bus.ack (bot_id optional on pid=1).", "conversation_not_found": "Wrong conversation_id — bots.bus.inbox then retry.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "This key owns more than one handle. Pass handle from bots.bus.handle.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "message_id_required": "Pass message_id or provider_message_id.", "message_not_found": "Turn stale — use provider_message_id from inbox (conversation ok).", "orchestrator_bot_unbound": "Bind orchestrator on message_bus or pass bot_id from bots.list (platform AgentBus: project_id=1).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass a handle this key owns, or omit source_agent_id.", "source_agent_unbound": "bots.bus.handle.set with this key first.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark inbound turn read without outbound text. Prefer provider_message_id (Telegram message id, including the quoted keyboard message of a button tap). message_id must match bots.bus.inbox / webhook tu", "write_mode": null}, {"action": "bots.bus.webhook.connect", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not store Bearer in 8DNA — authorization merges into Integration Hub secrets.", "On project_id=1 the connection is personal to the operator. Pass url; connection_id is optional.", "Webhook POST is one bus.message.inbound envelope, not a full inbox snapshot.", "After the wake, pull bots.bus.inbox. That list is the source of truth."], "bots_atoms": ["BOTS_BUS_WEBHOOK_PUSH", "BOTS_REPLY_MAILBOX", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.connect", "mutation_risk": "low", "related_tools": ["bots.bus.webhook.test", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook Connect"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Bind a push URL for config.message_bus.webhooks.{handle}. Pass url to create an outbound Integratio…", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["Pass url. connection_id is optional. Then bots.bus.webhook.test.", "On bus.message.inbound POST → bots.bus.inbox then reply or ack"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.webhook.test", "bots.bus.inbox"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_webhook_connect", "semantic_input_mode": "inherit_workflow", "summary": "Store outbound webhook connection for a handle (Integration Hub).", "title": "Bots Bus Webhook Connect", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "handle plus url or connection_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "test_hook_failed": "The leaf is already bound. Call bots.bus.webhook.test. Do not connect again.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_id_required": "This project stores the webhook on the operator user. Reconnect MCP so the call has a user.", "webhook_connect_failed": "Could not create the outbound connection for url", "webhook_url_invalid": "url rejected or connection update failed", "webhook_url_missing": "Connection has no outbound URL"}, "when_to_use": "Bind a push URL for config.message_bus.webhooks.{handle}. Pass url to create an outbound Integration Hub connection, or connection_id of an existing one. Ecosystem bot on project_id=1 stores the conne", "write_mode": null}, {"action": "bots.bus.webhook.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.list", "related_tools": ["bots.bus.webhook.connect", "bots.bus.webhook.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook List"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "List bound bus webhooks for this project slice. No secrets.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.webhook.connect", "bots.bus.webhook.status"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_webhook_list", "semantic_input_mode": "inherit_workflow", "summary": "List message-bus webhook bindings (connection id, no secrets).", "title": "Bots Bus Webhook List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List bound bus webhooks for this project slice. No secrets.", "write_mode": null}, {"action": "bots.bus.webhook.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.status", "related_tools": ["bots.bus.webhook.connect", "bots.bus.webhook.test"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook Status"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "One handle: connected, outbound url, has_authorization. No secret values.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.webhook.connect", "bots.bus.webhook.test"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_webhook_status", "semantic_input_mode": "inherit_workflow", "summary": "One handle webhook: connected, url, has_authorization. No secret values.", "title": "Bots Bus Webhook Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One handle: connected, outbound url, has_authorization. No secret values.", "write_mode": null}, {"action": "bots.bus.webhook.test", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.test", "mutation_risk": "low", "related_tools": ["bots.bus.webhook.status", "bots.bus.webhook.connect"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook Test"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "POST event bus.message.inbound.test to the bound URL.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.webhook.status", "bots.bus.webhook.connect"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_webhook_test", "semantic_input_mode": "inherit_workflow", "summary": "POST bus.message.inbound.test to the bound URL.", "title": "Bots Bus Webhook Test", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "test_hook_failed": "Probe failed. The leaf stays bound. Call bots.bus.webhook.test again.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "webhook_not_connected": "bots.bus.webhook.connect first"}, "when_to_use": "POST event bus.message.inbound.test to the bound URL.", "write_mode": null}, {"action": "bots.bus.webhook.disconnect", "ai_tips": "Clear config.message_bus.webhooks.{handle}. Connection row stays.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.disconnect", "mutation_risk": "low", "related_tools": ["bots.bus.webhook.connect", "bots.bus.webhook.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook Disconnect"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Clear config.message_bus.webhooks.{handle}. Connection row stays.", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.webhook.connect", "bots.bus.webhook.list"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_webhook_disconnect", "semantic_input_mode": "inherit_workflow", "summary": "Clear the webhook leaf for a handle. Does not delete the Integration Hub connection.", "title": "Bots Bus Webhook Disconnect", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "webhook_not_connected": "bots.bus.webhook.connect first, or handle already cleared"}, "when_to_use": "Clear config.message_bus.webhooks.{handle}. Connection row stays.", "write_mode": null}, {"action": "bots.bus.webhook.rotate_secret", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.webhook.rotate_secret", "mutation_risk": "low", "related_tools": ["bots.bus.webhook.status", "bots.bus.webhook.test"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Webhook Rotate Secret"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Rotate signing_secret on the Integration Hub connection. Secret is returned once.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.webhook.status", "bots.bus.webhook.test"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_webhook_rotate_secret", "semantic_input_mode": "inherit_workflow", "summary": "Rotate the webhook signing_secret. The new secret is returned once.", "title": "Bots Bus Webhook Rotate Secret", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "webhook_not_connected": "No connection_id on this handle"}, "when_to_use": "Rotate signing_secret on the Integration Hub connection. Secret is returned once.", "write_mode": null}, {"action": "bots.bus.settings.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.settings.get", "related_tools": ["bots.bus.settings.set", "bots.bus.handle.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Settings Get"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Read signature_position (prefix|suffix|off), platform_agent, sticky_minutes.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.settings.set", "bots.bus.handle.list"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_settings_get", "semantic_input_mode": "inherit_workflow", "summary": "Read message-bus settings: signature_position, platform_agent, sticky_minutes.", "title": "Bots Bus Settings Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read signature_position (prefix|suffix|off), platform_agent, sticky_minutes.", "write_mode": null}, {"action": "bots.bus.settings.set", "ai_tips": "Leaf-write config.message_bus.signature_position. Not a full message_bus blob.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.settings.set", "mutation_risk": "low", "related_tools": ["bots.bus.settings.get", "bots.bus.handle.set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Settings Set"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Leaf-write config.message_bus.signature_position. Not a full message_bus blob.", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.settings.get", "bots.bus.handle.set"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_settings_set", "semantic_input_mode": "inherit_workflow", "summary": "Set signature_position on config.message_bus (prefix, suffix, or off).", "title": "Bots Bus Settings Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "signature_position_invalid": "Use prefix, suffix, or off", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Leaf-write config.message_bus.signature_position. Not a full message_bus blob.", "write_mode": null}, {"action": "bots.reply_source.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.reply_source.get", "related_tools": ["bots.reply_source.set", "bots.bus.deliver", "ai.chat.settings.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Reply Source Get"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Before agents.orchestrate or staff reply: who owns the thread. Workspace: bot_id=workspace, chat_ke…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.reply_source.set", "bots.bus.deliver", "ai.chat.settings.get"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_reply_source_get", "semantic_input_mode": "inherit_workflow", "summary": "Read who answers a chat: ai (orchestrator, often Free.ai), manager (handoff), or bus agent. Workspace chats use bot_id=workspace and chat_key=workspace:{conversation_id}. When to use: before sending, ", "title": "Bots Reply Source Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "bot_id is required — bots.list then pass bot_uuid.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before agents.orchestrate or staff reply: who owns the thread. Workspace: bot_id=workspace, chat_key=workspace:{conversation_id}. Returns source ai|manager|agent and optional agent_handle.", "write_mode": null}, {"action": "bots.reply_source.set", "ai_tips": "Switch reply owner: ai (orchestrator), manager (handoff), agent (@handle via bus). Owner/admin only for workspace; fleet chats allow the staff user who claimed handoff on chat_key.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.reply_source.set", "mutation_risk": "low", "related_tools": ["bots.reply_source.get", "bots.bus.handle.set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Reply Source Set"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Switch reply owner: ai (orchestrator), manager (handoff), agent (@handle via bus). Owner/admin only…", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.reply_source.get", "bots.bus.handle.set"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_reply_source_set", "semantic_input_mode": "inherit_workflow", "summary": "Set who owns a chat. source=ai returns orchestration (use /release or set chat mode freeai). source=manager pairs with handoff so the bot brain stays quiet. source=agent requires agent_handle and rout", "title": "Bots Reply Source Set", "when_blocked": {"agent_handle_required": "source=agent — pass agent_handle or bind via bots.bus.handle.set.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "forbidden": "Project owner/admin required for bot_id=workspace; on fleet chats staff must hold handoff_claimed_by_user_id for that chat_key.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "bot_id and source (ai|manager|agent) required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "reply_source_failed": "Leaf write failed — check env_uuid / sandbox; bots.reply_source.get to verify.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Switch reply owner: ai (orchestrator), manager (handoff), agent (@handle via bus). Owner/admin only for workspace; fleet chats allow the staff user who claimed handoff on chat_key.", "write_mode": null}, {"action": "bots.bus.platform_agent.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.platform_agent.get", "related_tools": ["bots.bus.platform_agent.set", "bots.bus.inbox", "bots.simulate"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Platform Agent Get"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Read config.message_bus.platform_agent.enabled (leaf). runtime_ok is the LLM gate.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.platform_agent.set", "bots.bus.inbox", "bots.simulate"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_platform_agent_get", "semantic_input_mode": "inherit_workflow", "summary": "Read platform_agent.enabled from message_bus DNA leaf.", "title": "Bots Bus Platform Agent Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read config.message_bus.platform_agent.enabled (leaf). runtime_ok is the LLM gate.", "write_mode": null}, {"action": "bots.bus.platform_agent.set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.platform_agent.set", "mutation_risk": "low", "related_tools": ["bots.bus.platform_agent.get", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Platform Agent Set"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Patch only config.message_bus.platform_agent.enabled. Does not rewrite handles.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.platform_agent.get", "bots.bus.inbox"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_platform_agent_set", "semantic_input_mode": "inherit_workflow", "summary": "Set platform_agent.enabled on message_bus DNA leaf.", "title": "Bots Bus Platform Agent Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch only config.message_bus.platform_agent.enabled. Does not rewrite handles.", "write_mode": null}, {"action": "bots.bus.send", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not paste the file body into text — Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-upload to bots__outbound). MCP storage.upload does not take bytes. Do not paste the file body into text.", "anti_patterns": ["Do not paste the file body into text — Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scop", "Omit source_agent_id unless it is the handle already bound to this key.", "source_agent is an alias of source_agent_id. Do not pass handle= on send — that is inbox mailbox filter."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.send", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.staff_reply", "bots.bus.reply", "bots.bus.ask", "bots.bus.inbox", "bots.bus.ack"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Send"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Channel outbound (server stamps bound handle)", "request": {"params": {"bot_id": "<from bots.list>", "conversation_id": "<from bots.bus.inbox>", "text": "Bus report attached — please ack in mailbox."}, "tool": "bots.bus.send"}}], "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {k…", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["bots.bus.inbox reply_for_scope=pending before send when unsure of thread state", "Quote reply: bots.bus.reply with reply_to_provider_message_id", "Ask yes/no: bots.bus.ask with question.kind=yes_no"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["storage.upload", "bots.staff_reply", "bots.bus.reply", "bots.bus.ask", "bots.bus.inbox", "bots.bus.ack"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_send", "semantic_input_mode": "inherit_workflow", "summary": "Send bus outbound text and/or attachments[] (signature + outbox) via staff_reply rail.", "title": "Bots Bus Send", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_in_project": "AgentBus platform bot needs project_id=1.", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id for this bot.", "empty_body": "Provide text and/or attachments[].", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Multi-handle key — pass source_agent_id from bots.bus.whoami.", "handoff_not_active": "Enable handoff or pass clear_handoff with staff reply.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "orchestrator_bot_unbound": "Same as inbox — explicit bot_id or orchestrator binding on message_bus.", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Omit source_agent_id, or pass a handle this key owns (not inbox handle=).", "source_agent_unbound": "bots.bus.handle.set with this key first.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-uploa", "write_mode": null}, {"action": "bots.bus.reply", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not paste the file body into text — Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-upload to bots__outbound). MCP storage.upload does not take bytes. Do not paste the file body into text.", "anti_patterns": ["Do not paste the file body into text — Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scop", "Pass reply_to_provider_message_id to quote the inbound turn in the channel.", "Asking the person is bots.bus.ask, or question on this reply. Same buttons, same tap."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.reply", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.bus.send", "bots.bus.ack", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Reply"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Thread reply (handle stamped server-side)", "request": {"params": {"bot_id": "<from bots.list>", "conversation_id": "<from inbox>", "reply_to_provider_message_id": "<from inbox turn>", "text": "Done — see bus report."}, "tool": "bots.bus.reply"}}], "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {k…", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": [{"action": "bots.bus.handle.list", "why": "When source_agent_forbidden — pick a handle this API key owns."}, {"action": "bots.bus.reply", "params_hint": {"omit": "source_agent_id"}, "why": "Server stamps the speaker from the bound handle."}, {"action": "bots.bus.inbox", "params_hint": {"reply_for_scope": "pending"}, "why": "Poll pending before reply."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["storage.upload", "bots.bus.send", "bots.bus.ack", "bots.bus.inbox"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_reply", "semantic_input_mode": "inherit_workflow", "summary": "Quote-reply on bus rail (provider_message_id + signature).", "title": "Bots Bus Reply", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_in_project": "bot_id not on context.project_id — AgentBus platform bot needs project_id=1.", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "Unknown conversation_id for this bot.", "empty_body": "Provide text and/or attachments[] after storage.upload.", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "This key owns more than one handle. Pass source_agent_id from bots.bus.handle.list.", "handoff_not_active": "Enable handoff or pass clear_handoff with staff reply.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "not_manager_live": "Channel reply succeeded but order_routing_live is unchanged — run bots.order_manager_bootstrap (dry_run then apply with env_uuid).", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass source_agent_id (alias source_agent) from bots.bus.handle.list that this key owns. handle= is inbox-only — not the speaker on reply.", "source_agent_unbound": "bots.bus.handle.set with this key first.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-uploa", "write_mode": null}, {"action": "bots.bus.ask", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Same keyboard as question on bots.bus.reply and bots.bus.send. Do not invent another format.", "anti_patterns": ["Same keyboard as question on bots.bus.reply and bots.bus.send. Do not invent another format.", "Omit question for yes/no. Do not write Да/Нет only in the text.", "U15 mode: question.kind=mode → group_access:mode:* (or bots.acl.set_mode / Telegram /mode), not REST."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.bus.ask", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.bus.reply", "bots.bus.send", "bots.bus.inbox", "bots.acl.set_mode"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Ask"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Ask the person (yes/no buttons)", "request": {"params": {"bot_id": "<from bots.list>", "conversation_id": "<from bots.bus.inbox>", "text": "Confirm invoice total is correct?"}, "tool": "bots.bus.ask"}}, {"name": "U15 session mode keyboard (kind=mode)", "request": {"params": {"bot_id": "<from bots.list>", "conversation_id": "<group or owner thread>", "question": {"kind": "mode"}, "text": "Выберите режим работы в этом чате"}, "tool": "bots.bus.ask"}}], "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Ask the owner or the person already in conversation_id. Same buttons as question on bots.bus.reply …", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["Poll pending: bots.bus.inbox handle=<bound> reply_for_scope=pending", "After answer: bots.bus.reply or bots.bus.ack", "U15 mode: question.kind=mode → group_access:mode:* (or bots.acl.set_mode / Telegram /mode)"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["storage.upload", "bots.bus.reply", "bots.bus.send", "bots.bus.inbox", "bots.acl.set_mode"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_bus_ask", "semantic_input_mode": "inherit_workflow", "summary": "Ask the person in this channel thread. Same keyboard as question on bots.bus.reply and bots.bus.send. Default ✅ Да / ❌ Нет. question {kind:choice, options:[...]} for several answers.", "title": "Bots Bus Ask", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_in_project": "bot_id not on context.project_id — AgentBus platform bot needs project_id=1.", "broadcast_plan_missing": "Async fan-out lost recipient plan — worker retries; reload via bots.broadcast_status (plan_key). Plan JSON in storage bots/broadcast_plans; first job has recipients_bootstrap.", "channel_media_unsupported": "Worker could not render attachment for channel.", "channel_not_found": "Session channel not wired on bot spec.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "bots.bus.inbox for a live conversation_id.", "empty_body": "Provide text and/or attachments[].", "env_uuid_project_only": "env_uuid is only valid for home=project", "external_user_missing": "Conversation row lacks external_user_id.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Multi-handle key — pass source_agent_id from bots.bus.whoami.", "handoff_not_active": "Enable handoff or pass clear_handoff with staff reply.", "invalid_staff_user": "Operator user_id missing on MCP session.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "mode_keyboard": "question.kind=mode posts group_access:mode:consultation|order (U15); same leaf as bots.acl.set_mode / Telegram /mode — not a REST /mode route.", "no_channel": "Bot has no live channel binding — bots.attach_channel then go_live.", "outbound_global_shed": "Platform outbound RPS shed — retry shortly.", "provider_429": "Provider rate limit — worker retries with backoff; partial multi-photo sends resume.", "provider_4xx": "Hard provider 4xx on a single step — no retry. Multi-step partial 4xx saves outbound_req_resume and nacks the queue job until remaining HTTP steps complete (or resume TTL 1h). Partial session turn is deduped — do not re-append on retry.", "provider_5xx": "Provider server error — worker retries.", "provider_timeout": "HTTP timeout to provider — worker retries with resume cursor.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "Pass a handle this key owns (alias source_agent).", "source_agent_unbound": "bots.bus.handle.set first.", "storage_file_not_found": "storage_file_id missing at deliver time.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "whatsapp_session_closed_requires_template": "WhatsApp 24h window closed — use WABA template_name on broadcast or staff reply."}, "when_to_use": "Ask the owner or the person already in conversation_id. Same buttons as question on bots.bus.reply and bots.bus.send — not a second feature. text is the question. Omit question for ✅ Да / ❌ Нет. quest", "write_mode": null}, {"action": "bots.bus.deliver", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not paste the file body into text — Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-upload to bots__outbound). MCP storage.upload does not take bytes. Do not paste the file body into text.", "anti_patterns": ["Do not paste the file body into text — Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scop", "to_handle is the recipient, or @All for every other mailbox. Your name comes from this key.", "Pass task {node_id, plan_id, title, instruction, next_action} to hand off a work-graph node."], "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.deliver", "mutation_risk": "low", "related_tools": ["storage.upload", "bots.bus.send", "bots.bus.inbox", "bots.bus.handle.set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Deliver"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Mailbox handoff", "request": {"params": {"bot_id": "<from bots.list>", "source_agent_id": "cursor-deploy", "text": "Кому: @AgentStackDev\nТема: …\n\nBody.", "to_handle": "@AgentStackDev"}, "tool": "bots.bus.deliver"}}], "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {k…", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["Recipient: bots.bus.inbox handle=<to_handle> reply_for_scope=pending", "Reply path: bots.bus.deliver to_handle=<from_handle> with the result text", "If webhook_queued is false: bots.bus.webhook.connect on the recipient key"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["storage.upload", "bots.bus.send", "bots.bus.inbox", "bots.bus.handle.set"], "required_cap": "bots_run", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "bots_bus_deliver", "semantic_input_mode": "inherit_workflow", "summary": "Put text, attachments[], and/or task in another handle's mailbox. The sender is the caller's bound handle. Does not sign the message as the recipient. idempotency_key (or options.idempotency_key) make", "title": "Bots Bus Deliver", "when_blocked": {"attachment_validation_failed": "Fix attachments[] shape (kind, storage_file_id or https url).", "bot_not_in_project": "bot_id not on context.project_id — AgentBus platform bot needs project_id=1.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "delivery_timeout": "Retry once; do not duplicate via staff_reply.", "empty_body": "Provide text, attachments[], or task.", "env_uuid_project_only": "env_uuid is only valid for home=project", "fanout_limit": "@All exceeds the mailbox fan-out cap (48) — deliver to fewer handles or batch.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "grant_denied": "owner_messenger_grant task rejected — fix principal, bot_uuid, project_id_grant.", "graph_home_unknown": "home must be project, self, or project_self", "handle_required": "Pass source_agent_id when this key owns multiple handles.", "invalid_parameters": "bot_id and to_handle are required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_recipients": "@All needs other handles on the project.", "not_manager_live": "Mailbox delivery succeeded but manager routing is not live — bots.order_manager_bootstrap apply with sandbox env_uuid.", "orchestrator_bot_unbound": "Pass bot_id or bind orchestrator on message_bus before deliver.", "owner_grant_task_invalid": "task.kind=owner_messenger_grant needs principal, project_id_grant, bot_uuid, recipient_dm_chat_id — see when_to_use on bots.bus.deliver.", "recipient_not_found": "to_handle missing — bots.bus.handle.list on this project.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "self_deliver_forbidden": "to_handle is your own speaker — pick another handle from bots.bus.handle.list.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "source_agent_id must be a handle this key owns.", "source_agent_unbound": "bots.bus.handle.set with this MCP key before deliver.", "storage_file_not_found": "storage_file_id missing on disk — re-upload to bots__outbound.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Send a file as attachments[]: POST /api/storage/upload folder bots__outbound scope=project, then {kind, storage_file_id, filename}; or attachments[] with content_base64 on bots.bus.deliver (auto-uploa", "write_mode": null}, {"action": "bots.bus.onboard", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_BUS_AGENT_LADDER", "BOTS_BUS_WEBHOOK_PUSH", "BOTS_REPLY_MAILBOX", "BOTS_CONTINUATION_SIGNAL"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.onboard", "related_tools": ["bots.bus.handle.set", "bots.bus.inbox", "bots.bus.webhook.connect", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Onboard"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Start here. Read-only ladder for this project — prompt agentstack_bot_message_bus, recipes mcp_bot_…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["bots.bus.handle.set — register @handle", "bots.bus.inbox handle=<slug> reply_for_scope=pending include_messages=true", "recipe mcp_bot_message_bus_webhook_v1 when push wake needed"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.handle.set", "bots.bus.inbox", "bots.bus.webhook.connect", "discovery.describe"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_onboard", "semantic_input_mode": "inherit_workflow", "summary": "Read-only agent message bus onboarding ladder (prompt, recipes, verify).", "title": "Bots Bus Onboard", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Start here. Read-only ladder for this project — prompt agentstack_bot_message_bus, recipes mcp_bot_reply_mailbox_v1 / mcp_bot_message_bus_webhook_v1. Messages live on this project's bot: 200 turns per", "write_mode": null}, {"action": "bots.bus.health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "bots_atoms": ["BOTS_REPLY_MAILBOX", "BOTS_BUS_AGENT_LADDER"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.bus.health", "related_tools": ["bots.health", "bots.fleet_diagnostics"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Bus Health"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Queue depths + RED metrics for this bot (include=queues). error_rate_basis=window uses last 32 samp…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.health", "bots.fleet_diagnostics"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_bus_health", "semantic_input_mode": "inherit_workflow", "summary": "Message-bus ops health: queues + channel capabilities.", "title": "Bots Bus Health", "when_blocked": {"bot_not_found": "Unknown bot_id in this project — bots.list then bots.get", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Queue depths + RED metrics for this bot (include=queues). error_rate_basis=window uses last 32 samples; stale means no recent samples — check errors_lifetime and execute/outbound DLQ rows, not error_r", "write_mode": null}, {"action": "bots.fleet_diagnostics", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["env_uuid applies only when home=project (sandbox overlay). For personal plan leaves use home=project_self or self without env_uuid."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.fleet_diagnostics", "related_tools": ["bots.bus.health", "bots.list", "integrations.diagnose_telegram"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Fleet Diagnostics"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Bot Studio / ops triage; mirrors GET /api/projects/{id}/bots/fleet/diagnostics.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.health", "bots.list", "integrations.diagnose_telegram"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_fleet_diagnostics", "semantic_input_mode": "inherit_workflow", "summary": "Project bots fleet health (channel health, sessions) — project read RBAC.", "title": "Bots Fleet Diagnostics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bot Studio / ops triage; mirrors GET /api/projects/{id}/bots/fleet/diagnostics.", "write_mode": null}, {"action": "bots.flows.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not auto-execute manifest blocks — use bots.order_manager_bootstrap or recipe mcp_bot_order_manager_bootstrap_v1.", "Do not invent a second config schema — data.quick_start.blocks is the template (title, done_when, apply)."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1", "core.mcp.self_description.gen1"], "id": "bots.flows.get", "related_tools": ["bots.acl.list", "bots.order_manager_bootstrap", "discovery.recipes"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Flows Get"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Manifest + quick_start template", "request": {"params": {"flow_id": "order_manager_v1"}, "tool": "bots.flows.get"}}, {"name": "Template + live gates", "request": {"params": {"bot_uuid": "<uuid>", "external_chat_id": "<numeric home chat.id>", "provider": "telegram"}, "tool": "bots.flows.get"}}], "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Read validated AgentFlowManifestV1 (declarative blocks) + optional routing_gates snapshot. Default …", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["Read data.quick_start.blocks — titles, done_when, apply.params", "Run bots.order_manager_bootstrap (default dry_run) — quote readout.bus_text on the bus", "include_manifest=false when only routing_gates is needed"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.acl.list", "bots.order_manager_bootstrap", "discovery.recipes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_flows_get", "semantic_input_mode": "inherit_workflow", "summary": "Load AgentFlowManifestV1 (declarative MCP block list) with optional routing_gates snapshot. Execute via bots.order_manager_bootstrap or recipe mcp_bot_order_manager_bootstrap_v1.", "title": "Bots Flows Get", "when_blocked": {"bot_uuid_required": "When provider + external_chat_id are set, pass bot_uuid or bot_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dm_addressing_invalid": "external_chat_id must be numeric home chat.id (DM ok), not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "flow_manifest_invalid": "Fix manifest blocks/actions in DNA or pass valid inline structure.", "flow_manifest_not_found": "Set DNA leaf ecosystem.fleet.agent_flows.defaults.{flow_id} or use order_manager_v1.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "When building routing_gates, provider is required with external_chat_id.", "routing_context_incomplete": "Pass provider and external_chat_id together when you want routing_gates, or omit both for manifest-only (no bot_id required).", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read validated AgentFlowManifestV1 (declarative blocks) + optional routing_gates snapshot. Default flow_id=order_manager_v1; DNA override: ecosystem.fleet.agent_flows.defaults.{flow_id}. Pass bot_uuid", "write_mode": null}, {"action": "bots.flows.validate", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1", "core.mcp.self_description.gen1"], "id": "bots.flows.validate", "related_tools": ["bots.flows.get", "bots.acl.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Flows Validate"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Validate manifest JSON: whitelist actions, DAG requires[], no cycles. Optional vars replaces {{key}…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.flows.get", "bots.acl.list"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_flows_validate", "semantic_input_mode": "inherit_workflow", "summary": "Validate AgentFlowManifestV1 (whitelist + DAG). Optional inline manifest or DNA load + vars substitution.", "title": "Bots Flows Validate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "flow_manifest_invalid": "Whitelist/DAG failed — fix blocks, requires[], or unknown action ids.", "flow_manifest_not_found": "No DNA leaf for flow_id and not built-in order_manager_v1 — set leaf or pass manifest=.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Validate manifest JSON: whitelist actions, DAG requires[], no cycles. Optional vars replaces {{key}} in block params strings. Pass flow_id to load from DNA or inline manifest= for a dry check.", "write_mode": null}, {"action": "bots.order_manager_bootstrap", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not set dry_run=false on production without env_uuid and generation gates.", "Do not nest agentstack.execute for each manifest block — this tool runs the ladder in-process.", "Do not bots.bus.deliver that launch is not ready from dry_run=true. status=planned did not write DNA. Quote data.readout.bus_text (verdict PLAN)."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.group_access.gen1", "core.mcp.self_description.gen1"], "id": "bots.order_manager_bootstrap", "mutation_risk": "low", "related_tools": ["generation.fork", "generation.env_snapshot", "generation.supply_status", "bots.flows.get", "bots.acl.list", "bots.acl.responsible.set"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Order Manager Bootstrap"}, "domain_title": "Bots Fleet MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"bot_id": "example_string", "bot_uuid": "example_string", "connect_webhook_url": "example_string", "display": "example_string", "dry_run": true, "external_chat_id": "example_string", "manager_slug": "example_string", "project_id": 123, "provider": "example_string", "thread_id": "example_string"}, "example_request": {"action": "bots.order_manager_bootstrap", "params": {"bot_id": "example_string", "bot_uuid": "example_string", "connect_webhook_url": "example_string", "display": "example_string", "dry_run": true, "external_chat_id": "example_string", "manager_slug": "example_string", "project_id": 123, "provider": "example_string", "thread_id": "example_string"}}, "examples": [{"name": "DM manager dry_run plan", "request": {"params": {"bot_uuid": "<uuid>", "dry_run": true, "external_chat_id": "<DM chat.id>", "manager_slug": "<slug>", "project_id": 1, "provider": "telegram"}, "tool": "bots.order_manager_bootstrap"}, "response": {"data": {"dry_run": true, "dry_run_planning": {"apply_needs_env_uuid": true, "planning_ok_when_gate_closed": true, "requires_apply_ready": false}, "flow_id": "order_manager_v1", "order_routing_live": false, "readout": {"bus_text": "Plan only; no writes planned. Confirm sandbox Gate A before apply with dry_run=false and env_uuid. This is not a failed launch.", "verdict": "PLAN"}, "sandbox_gate": {"apply_ready": false, "planning_carve_out": true, "reason": "no_open_anchor"}, "steps": [{"action": "bots.acl.list", "status": "planned"}]}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_GATE_AFTER_FORK": "After generation.fork, reuse data.env_uuid for mutations and Gate A probes — generation.env_snapshot (lightest) then bootstrap dry_run=true; generation.supply_status only when tier/quota needed. Batch context honors params.env_uuid when list lags (hydrate + memo bust).", "GENERATION_NEXT_ACTIONS_HINTS_ONLY": "next_actions and recovery_hint on gate reads are navigation hints, not operator consent to mutate prod. When sandbox_gate.apply_ready=false, STOP — do not auto-run generation.fork or dry_run=false bootstrap from agent loops. Exception: bots.order_manager_bootstrap dry_run=true is planning only — it does not require apply_ready; pass env_uuid from generation.fork before dry_run=false apply (Gate B)."}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Idempotent server runner for order_manager_v1: bus slug, responsible_handle, mode=order, verify rou…", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["Gate A: generation.env_snapshot with env_uuid from generation.fork (lightest); generation.supply_status when tier/quota needed", "dry_run_planning: dry_run=true does not require sandbox_gate.apply_ready", "apply_ready=false blocks dry_run=false apply only — dry_run=true planning does not require apply_ready", "Quote data.readout.bus_text — verdict PLAN is not a failed launch", "dry_run=true: status=planned did not write DNA; template at bots.flows.get quick_start", "dry_run=false only in sandbox generation (env_uuid) after Gate B consent"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["generation.fork", "generation.env_snapshot", "generation.supply_status", "bots.flows.get", "bots.acl.list", "bots.acl.responsible.set"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_order_manager_bootstrap", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Idempotent server runner for order_manager_v1: bus slug, responsible_handle, mode=order, verify routing_gates. Pass thread_id for forum topics (U15).", "title": "Bots Order Manager Bootstrap", "when_blocked": {"acl_leaf_missing_after_load": "Could not materialize by_chat config after negative cache — retry or bust bot:group_acl cache.", "bootstrap_failed": "Non-domain runner error — inspect steps[] and server logs; dry_run=true to replan.", "bot_uuid_required": "Pass bot_uuid or bot_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_id_required": "Pass thread_id for forum topics or fix home chat.id.", "dm_addressing_invalid": "Home channel must be numeric chat.id (DM ok), not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "dry_run=false needs env_uuid (or a role that may write production). generation.fork → generation.env_snapshot once with receipt env_uuid (Gate A) → retry dry_run=false with that env_uuid.", "graph_home_unknown": "home must be project, self, or project_self", "group_access_config_invalid": "ACL leaf failed Pydantic validation on write — fix payload; readout steps[] for step id.", "handle_failed": "Bus handle write failed — after generation.fork: generation.env_snapshot with env_uuid; dry_run=false only when sandbox_gate.apply_ready.", "handle_not_found": "bots.bus.handle.list → bots.bus.handle.set → retry responsible step.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "manager_slug_required": "Pass manager_slug (bus handle without @).", "order_blocked": "Resolve routing_gates blockers before apply — bots.acl.list readout.", "order_needs_responsible_handle": "bots.acl.responsible.set before set_mode=order.", "provider_required": "Pass provider (telegram, …).", "sandbox_gate_closed": "Gate A — generation.env_snapshot (env_uuid from fork) before dry_run=false; dry_run=true is planning-only.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_unbound": "Register slug with bots.bus.handle.set; retry with dry_run=false in sandbox (env_uuid).", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix provider + external_chat_id + bot_uuid before apply."}, "when_to_use": "Idempotent server runner for order_manager_v1: bus slug, responsible_handle, mode=order, verify routing_gates. Default dry_run=true — set dry_run=false only in sandbox (env_uuid); generation auto-fork", "write_mode": null}, {"action": "bots.acl.list", "aliases": ["bots.group_access", "bots.group_access.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not treat config:null as a load failure — bots.acl.grant writes messenger_grants on the user, not the by_chat leaf; add responsible/session via bots.acl.responsible.set or PATCH, then promote.", "Do not call bots.acl.get_mode only to read mode after list — session_mode is already on list.", "OpenAPI /docs is not the repo — use docs/operations/BOT_GROUP_ACCESS_RUNBOOK.md, not /docs/plans/*."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.list", "related_tools": ["bots.acl.grant", "bots.acl.chats.list", "bots.acl.get_mode", "bots.acl.set_mode", "bots.acl.audit.list", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl List"}, "domain_title": "Bot group access organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"bot_id": "example_string", "bot_uuid": "example_string", "conversation_id": "example_string", "external_chat_id": "example_string", "project_id": 123, "provider": "example_string", "thread_id": "example_string"}, "example_request": {"action": "bots.acl.list", "params": {"bot_id": "example_string", "bot_uuid": "example_string", "conversation_id": "example_string", "external_chat_id": "example_string", "project_id": 123, "provider": "example_string", "thread_id": "example_string"}}, "examples": [{"bot_uuid": "550e8400-e29b-41d4-a716-446655440000", "external_chat_id": "-100123456789", "provider": "telegram"}], "execution_class": "plain_read", "genetic_tags": ["core.bots.group_access.gen1", "core.bots.fleet.gen1"], "instruction_hint": "Omit env_uuid: reads config.active_env_uuid when set (parity with projects.get_data follow_active_g…", "kind": "organelle", "mutation_kind": "none", "next_actions": [{"action": "bots.acl.responsible.set", "why": "creates the home-channel by_chat leaf and sets responsible_handle; requires a registered bus slug (bots.bus.handle.list / handle.set first)"}, {"action": "bots.order_manager_bootstrap", "why": "generation.fork → generation.env_snapshot (Gate A); order_manager_v1 dry_run default; dry_run=false with env_uuid to apply"}, {"action": "bots.acl.grant", "why": "grant messenger user on account (home channel = external_chat_id); does not create the by_chat leaf"}, {"action": "bots.acl.set_mode", "why": "persist U15 session mode (order needs responsible_handle)"}, {"action": "bots.acl.chats.list", "why": "discover indexed home chat_keys"}, {"action": "preflight.check", "why": "before sandbox mutate"}], "onboarding_tier": "domain_playbook", "organ_id": "bots.group_access", "owner_gene": "core.bots.group_access.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.acl.grant", "bots.acl.chats.list", "bots.acl.get_mode", "bots.acl.set_mode", "bots.acl.audit.list", "preflight.check"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_acl_list", "semantic_input_mode": "inherit_workflow", "summary": "List group_access config for a home channel (DM, group, or supergroup).", "title": "Bots Acl List", "when_blocked": {"bot_uuid_required": "Pass bot_uuid or bot_id (fleet alias).", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dm_addressing_invalid": "external_chat_id must be the numeric messenger home chat id, not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "Pass provider (telegram|max|…). No silent telegram default.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_key_mismatch": "Omit conversation_id or align with provider+external_chat_id derived leaf.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Omit env_uuid: reads config.active_env_uuid when set (parity with projects.get_data follow_active_generation). Explicit env_uuid wins; sticky sandbox applies only to fleet DNA mutators (grant/revoke/g", "write_mode": null}, {"action": "bots.acl.chats.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not invent chat_keys — call bots.acl.chats.list for indexed home keys, then bots.acl.list with provider + external_chat_id."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.chats.list", "related_tools": ["bots.acl.list", "bots.acl.grant", "bots.acl.audit.list", "bots.acl.get_mode"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Chats List"}, "domain_title": "Bot group access organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"bot_id": "example_string", "bot_uuid": "example_string", "project_id": 123}, "example_request": {"action": "bots.acl.chats.list", "params": {"bot_id": "example_string", "bot_uuid": "example_string", "project_id": 123}}, "examples": [{"bot_uuid": "550e8400-e29b-41d4-a716-446655440000"}], "execution_class": "plain_read", "genetic_tags": ["core.bots.group_access.gen1", "core.bots.fleet.gen1"], "instruction_hint": "List indexed home-channel chat_keys for one bot (bot:provider:external_chat_id). chat_keys:[] means…", "kind": "organelle", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "bots.group_access", "owner_gene": "core.bots.group_access.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.acl.list", "bots.acl.grant", "bots.acl.audit.list", "bots.acl.get_mode"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_acl_chats_list", "semantic_input_mode": "inherit_workflow", "summary": "List indexed home-channel chat_keys for one bot (bot:provider:external_chat_id).", "title": "Bots Acl Chats List", "when_blocked": {"bot_uuid_required": "Pass bot_uuid or bot_id (fleet alias).", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List indexed home-channel chat_keys for one bot (bot:provider:external_chat_id). chat_keys:[] means no home-channel rows indexed yet (empty index). Account-level grants do not add chat_keys until a ho", "write_mode": null}, {"action": "bots.acl.grant", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not append a per-chat allowlist row — the grant is stored on the AgentStack user.", "Do not expect grant alone to set responsible_handle or order mode — entitlement (messenger_grants) is separate from manager config (by_chat on the same home channel id via bots.acl.responsible.set or bots.order_manager_bootstrap).", "Do not grant without external_chat_id — it is the home channel (DM chat.id ok), not optional.", "Do not use bots.acl.grant to register a person. Identity is the messenger external_user_id. Do not call ensure_messenger_account for grant — use DM /login (email OTP or web_link) then grant; messenger_not_linked means resolve returned 0. Anonymous until DM /login links channel_identities (email OTP registers unknown mailboxes; grant does not).", "Do not call projects.add_user to grant group chat access.", "Do not omit provider — the default used to be telegram and wrote the wrong chat leaf.", "Do not use bots.acl for email, web push, or in-app events — use channels.*.", "Do not send role — the tool wants principal + project_id_grant (+ optional expires_at)."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.grant", "mutation_risk": "low", "related_tools": ["bots.acl.list", "bots.acl.revoke", "bots.acl.audit.list", "preflight.check", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Grant"}, "domain_title": "Bot group access organelle", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"bot_id": "example_string", "bot_uuid": "example_string", "expires_at": "example_string", "external_chat_id": "example_string", "grantor_user_id": 123, "principal": "example_string", "project_id": 123, "project_id_grant": 123, "provider": "example_string"}, "example_request": {"action": "bots.acl.grant", "params": {"bot_id": "example_string", "bot_uuid": "example_string", "expires_at": "example_string", "external_chat_id": "example_string", "grantor_user_id": 123, "principal": "example_string", "project_id": 123, "project_id_grant": 123, "provider": "example_string"}}, "examples": [{"bot_uuid": "550e8400-e29b-41d4-a716-446655440000", "expires_at": "", "external_chat_id": "-100123456789", "principal": "424242", "project_id_grant": 2, "provider": "max"}], "execution_class": "cheap", "genetic_tags": ["core.bots.group_access.gen1", "core.bots.fleet.gen1"], "instruction_hint": "Grant messenger entitlement (messenger_grants on the linked account) for one project_id the grantor…", "kind": "organelle", "mutation_kind": "entity", "next_actions": ["generation.diff_vs_prod → generation.gates → generation.promote (separate sync executes)", "bots.acl.list (home channel) to verify responsible_handle / order_routing_live"], "onboarding_tier": "domain_playbook", "organ_id": "bots.group_access", "owner_gene": "core.bots.group_access.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.acl.list", "bots.acl.revoke", "bots.acl.audit.list", "preflight.check", "generation.promote"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_acl_grant", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Grant a messenger user on their AgentStack account for one project_id inside the grantor's membership.", "title": "Bots Acl Grant", "when_blocked": {"batch_grant_partial": "Inspect data.results[].error_code — earlier rows may have committed.", "bot_uuid_required": "Pass bot_uuid or bot_id.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dm_addressing_invalid": "Grant targets home channel — numeric chat.id for DM.", "env_uuid_project_only": "env_uuid is only valid for home=project", "expires_at_invalid": "ISO-8601, future, within 90 days. Omit for the 30-day default.", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "grant_denied_not_member": "project_id_grant must be in grantor accessible_project_ids.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "messenger_not_linked": "resolve returned 0 — messenger id missing from channel_roster.known. Person must /login in DM first (email OTP or web_link; bots.update identity.auth_modes, empty list defaults to web_link).", "principal_required": "Pass principal or principals[] (max 10), not both empty.", "principals_batch_too_large": "At most 10 principals per call.", "provider_required": "Pass provider — wrong channel writes the wrong by_chat leaf.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Grant messenger entitlement (messenger_grants on the linked account) for one project_id the grantor may administer — not project membership via projects.add_user. principal must resolve (project 1 cha", "write_mode": null}, {"action": "bots.acl.revoke", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.revoke", "mutation_risk": "high", "related_tools": ["bots.acl.list", "bots.acl.grant", "bots.acl.audit.list"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Revoke"}, "domain_title": "Bot group access organelle", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "example_params": {"bot_id": "example_string", "bot_uuid": "example_string", "external_chat_id": "example_string", "principal": "example_string", "project_id": 123, "project_id_revoke": 123, "provider": "example_string"}, "example_request": {"action": "bots.acl.revoke", "params": {"bot_id": "example_string", "bot_uuid": "example_string", "external_chat_id": "example_string", "principal": "example_string", "project_id": 123, "project_id_revoke": 123, "provider": "example_string"}}, "execution_class": "cheap", "genetic_tags": ["core.bots.group_access.gen1", "core.bots.fleet.gen1"], "instruction_hint": "Revoke the messenger user's account grant (optional project_id_revoke drops one project). external_…", "kind": "organelle", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "bots.group_access", "owner_gene": "core.bots.group_access.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.acl.list", "bots.acl.grant", "bots.acl.audit.list"], "required_cap": "bots_run", "requires_preflight": true, "risk_class": "destructive", "safe_action": "bots_acl_revoke", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Revoke the messenger user's account grant (optional project_id_revoke drops one project).", "title": "Bots Acl Revoke", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "provider_required": "Pass provider; chat_key = bot:provider:chat.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke the messenger user's account grant (optional project_id_revoke drops one project). external_chat_id is context, not the grant key.", "write_mode": null}, {"action": "bots.acl.responsible.set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not invent bots.group_access.get — use bots.acl.list / bots.acl.responsible.set.", "Do not GET /api/bots/group_access for live config — that path returns migration JSON only (error_code legacy_group_access_path).", "Do not pass a display name — pass a bus slug listed on bots.bus.handle.list (strip @).", "Do not expect grant to create the by_chat leaf — bots.acl.responsible.set creates it."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.responsible.set", "mutation_risk": "low", "related_tools": ["bots.bus.handle.list", "bots.bus.handle.set", "bots.acl.list", "bots.acl.set_mode", "bots.acl.grant"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Responsible Set"}, "domain_title": "Bot group access organelle", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"bot_id": "example_string", "bot_uuid": "example_string", "external_chat_id": "example_string", "handle": "example_string", "project_id": 123, "provider": "example_string"}, "example_request": {"action": "bots.acl.responsible.set", "params": {"bot_id": "example_string", "bot_uuid": "example_string", "external_chat_id": "example_string", "handle": "example_string", "project_id": 123, "provider": "example_string"}}, "execution_class": "cheap", "genetic_tags": ["core.bots.group_access.gen1", "core.bots.fleet.gen1"], "instruction_hint": "Set the chat manager: ordered ladder — (1) bots.bus.handle.list to confirm slugs; (2) bots.bus.hand…", "kind": "organelle", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "bots.group_access", "owner_gene": "core.bots.group_access.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.bus.handle.list", "bots.bus.handle.set", "bots.acl.list", "bots.acl.set_mode", "bots.acl.grant"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_acl_responsible_set", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Set responsible_handle to a registered message-bus slug. One config.message_bus registry read per call; empty registry, unknown slug, or unreadable bus leaf → handle_not_found (fail closed). Same pred", "title": "Bots Acl Responsible Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dm_addressing_invalid": "external_chat_id must be numeric home chat.id, not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "handle_not_found": "Registry empty, slug missing, or message_bus leaf unreadable — bots.bus.handle.list, bots.bus.handle.set, then retry bots.acl.responsible.set.", "handle_required": "Pass handle (manager @slug without @).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "Pass provider for the bound chat.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Set the chat manager: ordered ladder — (1) bots.bus.handle.list to confirm slugs; (2) bots.bus.handle.set if the registry is empty or the slug is missing; (3) bots.acl.responsible.set with bot_uuid, p", "write_mode": null}, {"action": "bots.acl.set_mode", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not invent REST POST …/mode — use bots.acl.set_mode or Telegram /mode.", "Do not PATCH group-access to set session mode — use bots.acl.set_mode; REST PATCH returns unknown_patch_keys for other fields.", "Do not treat the raw external_chat_id as the session leaf key.", "Do not confuse session mode with ACL grants — grants stay bots.acl.grant."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.bots.fleet.gen1", "core.bots.group_access.gen1"], "id": "bots.acl.set_mode", "mutation_risk": "low", "related_tools": ["bots.acl.get_mode", "bots.bus.ask", "bots.acl.list", "bots.bus.send"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Set Mode"}, "domain_title": "Bot group access organelle", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"bot_id": "example_string", "bot_uuid": "example_string", "conversation_id": "example_string", "external_chat_id": "example_string", "mode": "example_string", "project_id": 123, "provider": "example_string", "thread_id": "example_string"}, "example_request": {"action": "bots.acl.set_mode", "params": {"bot_id": "example_string", "bot_uuid": "example_string", "conversation_id": "example_string", "external_chat_id": "example_string", "mode": "example_string", "project_id": 123, "provider": "example_string", "thread_id": "example_string"}}, "examples": [{"bot_uuid": "550e8400-e29b-41d4-a716-446655440000", "external_chat_id": "-100123456789", "mode": "order", "provider": "telegram"}], "execution_class": "cheap", "genetic_tags": ["core.bots.group_access.gen1", "core.bots.fleet.gen1"], "instruction_hint": "U15: write group session mode consultation|order (leaf ecosystem.fleet.group_access.session_by_conv…", "kind": "organelle", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "bots.group_access", "owner_gene": "core.bots.group_access.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.acl.get_mode", "bots.bus.ask", "bots.acl.list", "bots.bus.send"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "bots_acl_set_mode", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "U15: set group session mode consultation|order. Pass conversation_id, or provider + external_chat_id so the server derives stable_conversation_id. Raw chat id is not the leaf key. Same leaf as Telegra", "title": "Bots Acl Set Mode", "when_blocked": {"acl_missing_by_chat": "No by_chat leaf — bots.acl.responsible.set creates it.", "bus_registry_unreadable": "config.message_bus unreadable — bots.bus.handle.list / handle.set.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_id_required": "Pass conversation_id, or provider + external_chat_id. The server stores stable_conversation_id, not the raw chat id.", "dm_addressing_invalid": "external_chat_id must be the numeric messenger home chat id, not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "mode_invalid": "Pass mode=consultation|order (Telegram /mode parity).", "order_needs_responsible_handle": "mode=order requires provider + external_chat_id and a registered responsible_handle.", "provider_required": "Omit conversation_id only when provider is set. No silent telegram.", "responsible_not_in_message_bus_handles": "responsible_handle not on config.message_bus.handles — bots.bus.handle.set then retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "U15: write group session mode consultation|order (leaf ecosystem.fleet.group_access.session_by_conversation). consultation may use conversation_id or provider + external_chat_id. mode=order requires p", "write_mode": null}, {"action": "bots.acl.get_mode", "aliases": ["bots.group_access.get"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not call with only external_chat_id — that is provider_required.", "Do not treat mode_source=legacy_external_chat_id as the canonical leaf — set_mode rewrites it.", "When passing explicit conversation_id with provider + external_chat_id, mode is read on conversation_id — not the derived stable_conversation_id; omit conversation_id to align with list.", "Do not call get_mode after list for routing_gates — list already returns routing_gates."], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.group_access.gen1"], "id": "bots.acl.get_mode", "related_tools": ["bots.acl.set_mode", "bots.acl.list", "bots.bus.ask"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Get Mode"}, "domain_title": "Bot group access organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"bot_id": "example_string", "bot_uuid": "example_string", "conversation_id": "example_string", "external_chat_id": "example_string", "include_routing_gates": true, "project_id": 123, "provider": "example_string", "thread_id": "example_string"}, "example_request": {"action": "bots.acl.get_mode", "params": {"bot_id": "example_string", "bot_uuid": "example_string", "conversation_id": "example_string", "external_chat_id": "example_string", "include_routing_gates": true, "project_id": 123, "provider": "example_string", "thread_id": "example_string"}}, "examples": [{"bot_uuid": "550e8400-e29b-41d4-a716-446655440000", "external_chat_id": "-100123456789", "provider": "telegram"}], "execution_class": "plain_read", "genetic_tags": ["core.bots.group_access.gen1", "core.bots.fleet.gen1"], "instruction_hint": "Read U15 group session mode (default consultation when leaf missing). external_chat_id alone return…", "kind": "organelle", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "bots.group_access", "owner_gene": "core.bots.group_access.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.acl.set_mode", "bots.acl.list", "bots.bus.ask"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_acl_get_mode", "semantic_input_mode": "inherit_workflow", "summary": "Read U15 group session mode. Pass conversation_id, or provider + external_chat_id. A hit only on the old raw chat-id leaf returns mode_source=legacy_external_chat_id (read-only; set_mode rewrites cano", "title": "Bots Acl Get Mode", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_id_required": "Pass conversation_id, or provider + external_chat_id.", "dm_addressing_invalid": "external_chat_id must be the numeric messenger home chat id, not conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_required": "external_chat_id alone is not enough. Pass provider, or pass conversation_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_key_mismatch": "Response field when conversation_id disagrees with derived U15 leaf — omit override.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read U15 group session mode (default consultation when leaf missing). external_chat_id alone returns provider_required — pass conversation_id, or provider + external_chat_id. When provider + external_", "write_mode": null}, {"action": "bots.acl.audit.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.group_access.gen1"], "id": "bots.acl.audit.list", "related_tools": ["bots.acl.list", "bots.acl.grant", "bots.acl.revoke"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Bots Acl Audit List"}, "domain_title": "Bot group access organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"bot_id": "example_string", "bot_uuid": "example_string", "chat_key": "example_string", "limit": 50, "project_id": 123}, "example_request": {"action": "bots.acl.audit.list", "params": {"bot_id": "example_string", "bot_uuid": "example_string", "chat_key": "example_string", "limit": 50, "project_id": 123}}, "execution_class": "plain_read", "genetic_tags": ["core.bots.group_access.gen1", "core.bots.fleet.gen1"], "instruction_hint": "Read recent group_access ECS audit after grant/revoke. Requires bot_uuid; optional chat_key exact f…", "kind": "organelle", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "bots.group_access", "owner_gene": "core.bots.group_access.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.acl.list", "bots.acl.grant", "bots.acl.revoke"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_acl_audit_list", "semantic_input_mode": "inherit_workflow", "summary": "Read recent group_access ECS audit after grant/revoke.", "title": "Bots Acl Audit List", "when_blocked": {"bot_uuid_required": "Pass bot_uuid (optional chat_key for one group).", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read recent group_access ECS audit after grant/revoke. Requires bot_uuid; optional chat_key exact filter (bot:provider:chat). When items is empty but DNA wrote last_change, response may include dna_la", "write_mode": null}, {"action": "bots.orders.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not use bots.bus.inbox or bots.conversations for the manager order queue — bots.orders.list is the C20 read model keyed by chat_key bot:provider:external_chat_id.", "Do not treat success with empty items as consultation mode — MCP fail-closed returns error_code session_mode_not_order when U15 session_mode is not order.", "Do not skip bots.acl.list before bootstrap — confirm session_mode, then bots.order_manager_bootstrap dry_run=true (recipe mcp_bot_order_manager_bootstrap_v1).", "Do not call on hosted /s/{pid}/mcp cookie plane — bots.orders.* needs operator bots_run."], "bots_atoms": ["BOTS_ORDERS_READ"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.manager_dm.gen1", "core.mcp.self_description.gen1"], "id": "bots.orders.list", "related_tools": ["bots.orders.get", "bots.acl.list", "bots.order_manager_bootstrap", "bots.bus.inbox"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Orders List"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Manager DM order projection. Pass chat_key as bot:provider:external_chat_id. Optional env_uuid for …", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["session_mode_not_order → bots.acl.list then bots.order_manager_bootstrap dry_run=true", "Empty items while session_mode=order → bots.bus.inbox reply_for_scope=pending"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.orders.get", "bots.acl.list", "bots.order_manager_bootstrap", "bots.bus.inbox"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_orders_list", "semantic_input_mode": "inherit_workflow", "summary": "Read-model list of manager DM orders (TG1692 C20 projection).", "title": "Bots Orders List", "when_blocked": {"chat_key_required": "Pass chat_key bot:provider:external_chat_id before listing orders.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "order_routing_unscoped": "order_routing_live without responsible_handle — bots.acl.list grant responsible_handle or pin conversation_id before bots.orders.list.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_mode_not_order": "U15 session_mode is not order — bots.acl.list then bots.order_manager_bootstrap.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Manager DM order projection. Pass chat_key as bot:provider:external_chat_id. Optional env_uuid for sandbox slice; reply_for_scope pending|history when routing live. Does not call Telegram. session_mod", "write_mode": null}, {"action": "bots.orders.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not send replies from get — trail is read-only; use bots.staff_reply or bots.bus.reply.", "Do not omit bot_uuid — get requires bot_uuid with order_id (conversation thread).", "Pass chat_key when session_mode guard is required — mirrors list fail-closed contract.", "Do not invent commerce SKU orders — order_id is the bus conversation_id."], "bots_atoms": ["BOTS_ORDERS_READ"], "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.bots.manager_dm.gen1", "core.mcp.self_description.gen1"], "id": "bots.orders.get", "related_tools": ["bots.orders.list", "bots.acl.list", "bots.order_manager_bootstrap"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Bots Orders Get"}, "domain_title": "Bots Fleet MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "One conversation thread. Pass order_id plus bot_uuid. Trail is capped; does not send a reply.", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["conversation_not_found → bots.bus.inbox or verify order_id / bot_uuid", "After bootstrap → bots.acl.list for routing_gates"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "owner_gene": "core.bots.fleet.gen1", "plane": "Bots: bots.list, then bots.attach_channel. Outbound notice: notifications.deliver.", "plane_chooser": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.orders.list", "bots.acl.list", "bots.order_manager_bootstrap"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "bots_orders_get", "semantic_input_mode": "inherit_workflow", "summary": "Read one manager order by id (TG1692 C20).", "title": "Bots Orders Get", "when_blocked": {"bot_uuid_required": "Pass bot_uuid to load the conversation thread.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "conversation_not_found": "No thread for order_id — verify bots.bus.inbox or conversation_id.", "env_uuid_project_only": "env_uuid is only valid for home=project", "generation_fork_required": "generation.fork → generation.env_snapshot with same env_uuid (Gate A) → pass env_uuid on mutating batch before group_access DNA writes.", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "order_id_required": "order_id is required.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_mode_not_order": "Pass chat_key for ACL guard — session_mode is not order (bots.acl.list first).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One conversation thread. Pass order_id plus bot_uuid. Trail is capped; does not send a reply.", "write_mode": null}], "buffs": [{"action": "buffs.create_buff", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Don't apply buff before creating it", "anti_patterns": ["Don't apply buff before creating it", "Don't create multiple identical buffs - reuse templates", "Don't forget to set revert_on_expire for temporary effects"], "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.create_buff", "mutation_risk": "low", "related_tools": ["buffs.apply_buff", "buffs.get_buff", "buffs.list_active_buffs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Create Buff"}, "do_not_use_when": "Do not use create+apply for platform premium/vip/scale grants — use buffs.grant_subscription. Tenant buyers: prefer buffs.grant_tenant_subscription over raw create+apply.", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Create a trial buff for premium features", "name": "Create 7-day trial buff", "request": {"params": {"category": "subscription", "duration_days": 7, "effects": {"data.limits.api_calls": 10000}, "entity_id": 1, "entity_kind": "user", "name": "7-Day Premium Trial", "type": "trial"}, "tool": "buffs.create_buff"}, "response": {"data": {"buff_id": "uuid-here", "created_at": "2025-01-20T10:00:00Z", "state": "pending"}, "success": true}}, {"description": "Create a promotional buff for an event", "name": "Create promotional buff", "request": {"params": {"category": "event", "duration_days": 30, "effects": {"data.limits.api_calls": 50000}, "entity_id": 1, "entity_kind": "project", "name": "Black Friday 2024", "type": "promo"}, "tool": "buffs.create_buff"}, "response": {"data": {"buff_id": "uuid-here", "created_at": "2025-01-20T10:00:00Z", "state": "pending"}, "success": true}}, {"description": "Create a permanent upgrade buff", "name": "Create permanent upgrade", "request": {"params": {"category": "permanent", "config": {"persistent": true}, "duration_days": 365, "effects": {"data.features.premium": true}, "entity_id": 1, "entity_kind": "user", "name": "Premium Package", "type": "purchase"}, "tool": "buffs.create_buff"}, "response": {"data": {"buff_id": "uuid-here", "created_at": "2025-01-20T10:00:00Z", "state": "pending"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.apply_buff", "buffs.get_buff", "buffs.list_active_buffs"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "buffs_create_buff", "semantic_input_mode": "inherit_workflow", "summary": "Create a buff template in PENDING state.", "title": "Buffs Create Buff", "tool_chains": ["user_with_trial", "payment_to_subscription", "apply_custom_buff_to_user"], "when_blocked": {"buff_creation_failed": "Internal error — retry; check entity_kind and project_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_buff_forbidden": "Tenant projects cannot create ecosystem-scoped buff templates", "invalid_entity": "Entity not found — verify entity_id and entity_kind", "invalid_parameters": "name and category required — see buffs.apply_*_effect for trials", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not use create+apply for platform premium/vip/scale grants — use buffs.grant_subscription. Tenant buyers: prefer buffs.grant_tenant_subscription over raw create+apply.", "when_to_use": "Define buff template (admin) — tenants use apply_*_effect.", "write_mode": null}, {"action": "buffs.apply_buff", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not create+apply for platform tier grants — use buffs.grant_subscription.", "anti_patterns": ["Do not create+apply for platform tier grants — use buffs.grant_subscription.", "Tenant buyers: prefer buffs.grant_tenant_subscription over raw create+apply."], "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.apply_buff", "mutation_risk": "low", "related_tools": ["buffs.create_buff", "buffs.get_buff", "buffs.list_active_buffs", "buffs.get_effective_limits"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Apply Buff"}, "do_not_use_when": "Do not use create+apply for platform premium/vip/scale grants — use buffs.grant_subscription. Tenant buyers: prefer buffs.grant_tenant_subscription over raw create+apply.", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Activate a trial buff for a user", "name": "Apply trial buff", "request": {"params": {"buff_id": "uuid-here", "entity_id": 123, "entity_kind": "user", "project_id": 1}, "tool": "buffs.apply_buff"}, "response": {"data": {"applied_at": "2025-01-20T10:00:00Z", "buff_id": "uuid-here", "expires_at": "2025-01-27T10:00:00Z", "state": "active"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.create_buff", "buffs.get_buff", "buffs.list_active_buffs", "buffs.get_effective_limits"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "buffs_apply_buff", "semantic_input_mode": "inherit_workflow", "summary": "Apply a buff to an entity (user or project).", "title": "Buffs Apply Buff", "tool_chains": ["user_with_trial", "apply_custom_buff_to_user", "marketing_campaign"], "when_blocked": {"apply_failed": "Failed to apply buff — check buff_id and entity_kind", "buff_not_found": "buffs.list_active_buffs then buffs.create_buff or grant_subscription", "buff_not_pending": "Buff is not in PENDING state — use extend_buff or grant rails", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_entity": "bind context.project_id; user plane needs entity_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not use create+apply for platform premium/vip/scale grants — use buffs.grant_subscription. Tenant buyers: prefer buffs.grant_tenant_subscription over raw create+apply.", "when_to_use": "Low-level buff apply — prefer apply_temporary_effect for trials.", "write_mode": null}, {"action": "buffs.extend_buff", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.extend_buff", "related_tools": ["buffs.get_buff", "buffs.list_active_buffs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Extend Buff"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Extend a subscription buff by 30 days", "name": "Extend by 30 days", "request": {"params": {"additional_days": 30, "buff_id": "uuid-here", "entity_id": 123, "entity_kind": "user"}, "tool": "buffs.extend_buff"}, "response": {"data": {"buff_id": "uuid-here", "expires_at": "2025-02-20T10:00:00Z", "state": "active"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_buff", "buffs.list_active_buffs"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "buffs_extend_buff", "semantic_input_mode": "inherit_workflow", "summary": "Extend the duration of an active buff.", "title": "Buffs Extend Buff", "when_blocked": {"buff_not_active": "Only active buffs extend — check state in list_active_buffs", "buff_not_found": "buffs.list_active_buffs or buffs.get_buff with buff_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "extend_failed": "Retry extend_buff or buffs.grant_tenant_subscription for SKU", "extension_not_supported": "Buff category may not support extend — use grant rails", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Prolong active buff window.", "write_mode": null}, {"action": "buffs.revert_buff", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.revert_buff", "related_tools": ["buffs.get_buff", "buffs.cancel_buff"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Revert Buff"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "examples": [{"description": "Revert an active buff and restore original state", "name": "Revert active buff", "request": {"params": {"buff_id": "uuid-here", "entity_id": 123, "entity_kind": "user", "project_id": 1}, "tool": "buffs.revert_buff"}, "response": {"data": {"buff_id": "uuid-here", "reverted": true}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_buff", "buffs.cancel_buff"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "buffs_revert_buff", "semantic_input_mode": "inherit_workflow", "summary": "Revert an active buff - restore original state from snapshot.", "title": "Buffs Revert Buff", "tool_chains": ["trial_to_paid_tier", "trial_to_premium"], "when_blocked": {"buff_not_active": "revert_buff requires active state", "buff_not_found": "buffs.get_buff — buff_id must be active application id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "persistent_buff": "Use cancel_buff for persistent subscriptions", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "revert_failed": "Check permissions and buff_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Undo last buff mutation on a user.", "write_mode": null}, {"action": "buffs.cancel_buff", "aliases": ["buffs.revoke"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.cancel_buff", "related_tools": ["buffs.get_buff", "buffs.revert_buff"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Cancel Buff"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "examples": [{"description": "Cancel a buff that hasn't been applied yet", "name": "Cancel pending buff", "request": {"params": {"buff_id": "uuid-here", "entity_id": 123, "entity_kind": "user"}, "tool": "buffs.cancel_buff"}, "response": {"data": {"buff_id": "uuid-here", "cancelled": true, "deleted": true, "reverted": false}, "success": true}}, {"description": "Force cancel an active buff (requires admin rights)", "name": "Force cancel active buff", "request": {"params": {"buff_id": "uuid-here", "entity_id": 123, "entity_kind": "user"}, "tool": "buffs.cancel_buff"}, "response": {"data": {"buff_id": "uuid-here", "cancelled": true, "deleted": true, "reverted": true}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_buff", "buffs.revert_buff"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "buffs_cancel_buff", "semantic_input_mode": "inherit_workflow", "summary": "Cancel a buff in any state (force cancellation).", "title": "Buffs Cancel Buff", "when_blocked": {"buff_id_required": "buff_id param required", "buff_not_found": "buffs.list_active_buffs then pass buff_id", "cancel_failed": "Retry cancel_buff; verify buff_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project write or buffs.write cap required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "End active buff before expiry.", "write_mode": null}, {"action": "buffs.get_buff", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.get_buff", "related_tools": ["buffs.list_active_buffs", "buffs.apply_buff", "buffs.extend_buff"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Get Buff"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve information about a buff", "name": "Get buff info", "request": {"params": {"buff_id": "uuid-here", "entity_id": 123, "entity_kind": "user", "project_id": 1}, "tool": "buffs.get_buff"}, "response": {"data": {"buff_id": "uuid-here", "expires_at": "2025-01-27T10:00:00Z", "is_active": true, "name": "7-Day Premium Trial", "state": "active"}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.list_active_buffs", "buffs.apply_buff", "buffs.extend_buff"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "buffs_get_buff", "semantic_input_mode": "inherit_workflow", "summary": "Get information about a specific buff.", "title": "Buffs Get Buff", "when_blocked": {"buff_not_found": "buff_id from create_buff, apply_buff, or list_active_buffs", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect one buff definition or active instance.", "write_mode": null}, {"action": "buffs.list_active_buffs", "aliases": ["buffs.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.list_active_buffs", "related_tools": ["buffs.get_buff", "buffs.get_effective_limits", "buffs.extend_buff"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs List Active Buffs"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Get all active buffs for a user", "name": "List all active buffs", "request": {"params": {"entity_id": 123, "entity_kind": "user", "project_id": 1}, "tool": "buffs.list_active_buffs"}, "response": {"data": {"active_buffs": [{"buff_id": "uuid-here", "expires_at": "2025-01-27T10:00:00Z", "name": "Premium Trial", "state": "active"}], "entity_id": 123, "entity_kind": "user"}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_buff", "buffs.get_effective_limits", "buffs.extend_buff"], "required_cap": "mcp_read", "requires_preflight": false, "returns_hint": "active_buffs[].buff_id is the applied instance; application_id alias when present. Project plane: entity_kind=project, entity_id=project_id. include_ecosystem=true merges ecosystem templates (pid=1 storage).", "risk_class": "read", "safe_action": "buffs_list_active_buffs", "semantic_input_mode": "inherit_workflow", "summary": "List active buffs for an entity.", "title": "Buffs List Active Buffs", "tool_chains": ["payment_to_subscription", "apply_custom_buff_to_user"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_entity": "entity_id + entity_kind required — project plane: entity_kind=project, entity_id=project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_failed": "buffs.get_effective_limits to verify plane; on pid=1 dedupe enterprise rows in response", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List entitlements before get_effective_limits.", "write_mode": null}, {"action": "buffs.get_effective_limits", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.get_effective_limits", "related_tools": ["buffs.list_active_buffs", "buffs.apply_buff"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Get Effective Limits"}, "do_not_use_when": "Not for the full Profile billing dashboard (owned projects list, subscription narrative, per-project usage meters). Use REST GET /api/billing/overview (session auth) or @agentstack/sdk AgentBilling.getOverview for that aggregate.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Get effective limits for a user with all buffs", "name": "Get effective limits", "request": {"params": {"entity_id": 123, "entity_kind": "user", "project_id": 1}, "tool": "buffs.get_effective_limits"}, "response": {"data": {"effective_limits": {"api_calls": 10000, "logic_engine_calls": 5000}, "entity_id": 123, "entity_kind": "user"}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "none", "next_actions": ["limits/entitlements after grant → buffs.get_effective_limits (entity_kind user|project, optional project_id)", "finance hub KPIs → finance.dashboard_bundle", "SPA subscription shell → GET /api/billing/overview"], "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.list_active_buffs", "buffs.apply_buff"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "buffs_get_effective_limits", "semantic_input_mode": "inherit_workflow", "summary": "Get effective limits for an entity with all buffs applied.", "title": "Buffs Get Effective Limits", "when_blocked": {"billing_service_unavailable": "Billing service not available — retry or operator session", "calculation_failed": "Failed to calculate effective limits", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_entity": "entity_kind user|project; optional project_id for user-scoped limits", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Not for the full Profile billing dashboard (owned projects list, subscription narrative, per-project usage meters). Use REST GET /api/billing/overview (session auth) or @agentstack/sdk AgentBilling.getOverview for that aggregate.", "when_to_use": "Read merged limits for gating UI and server-side checks.", "write_mode": null}, {"action": "buffs.apply_temporary_effect", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.apply_temporary_effect", "mutation_risk": "low", "related_tools": ["buffs.get_effective_limits", "payments.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Apply Temporary Effect"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Quickly apply a 2-day bonus", "name": "Apply weekend bonus", "request": {"params": {"duration_days": 2, "effects": {"data.limits.api_calls": 5000}, "entity_id": 123, "entity_kind": "user", "name": "Weekend Bonus"}, "tool": "buffs.apply_temporary_effect"}, "response": {"data": {"applied_at": "2025-01-20T10:00:00Z", "buff_id": "uuid-here", "expires_at": "2025-01-22T10:00:00Z", "state": "active"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_effective_limits", "payments.create"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "buffs_apply_temporary_effect", "semantic_input_mode": "inherit_workflow", "summary": "Quickly apply a temporary effect (creates and applies buff in one step).", "title": "Buffs Apply Temporary Effect", "tool_chains": ["scheduled_rewards", "usage_monitoring"], "when_blocked": {"apply_failed": "apply_buff path failed after create — see error_code", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "Template create failed — check name/category/effects", "ecosystem_buff_forbidden": "Use tenant plane buffs on PID>1", "invalid_entity": "entity_id + entity_kind required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Time-boxed trial or promo tier — prefer over custom subscription tables.", "write_mode": null}, {"action": "buffs.apply_persistent_effect", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.apply_persistent_effect", "mutation_risk": "low", "related_tools": ["buffs.create_buff", "buffs.apply_buff", "buffs.apply_temporary_effect"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Buffs Apply Persistent Effect"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Quickly apply a permanent premium upgrade", "name": "Apply lifetime premium", "request": {"params": {"effects": {"data.features.premium": true, "data.limits.api_calls": 1000000}, "entity_id": 123, "entity_kind": "user", "name": "Lifetime Premium"}, "tool": "buffs.apply_persistent_effect"}, "response": {"data": {"applied_at": "2025-01-20T10:00:00Z", "buff_id": "uuid-here", "persistent": true, "state": "active"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "operator_glossary": {"two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing.", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.create_buff", "buffs.apply_buff", "buffs.apply_temporary_effect"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "buffs_apply_persistent_effect", "semantic_input_mode": "inherit_workflow", "summary": "Quickly apply a persistent effect (creates and applies permanent buff).", "title": "Buffs Apply Persistent Effect", "when_blocked": {"apply_failed": "apply_buff path failed after create", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "Template create failed — check plan_id slug", "ecosystem_buff_forbidden": "Tenant SKU grants via commerce checkout or grant_tenant_subscription", "invalid_entity": "entity_id + entity_kind required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Grant durable entitlement after payment or admin action.", "write_mode": null}, {"action": "buffs.grant_subscription", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not use buffs.grant_subscription for tenant-app SKU sales — use commerce + buffs.grant_tenant_subscription.", "anti_patterns": ["Do not use buffs.grant_subscription for tenant-app SKU sales — use commerce + buffs.grant_tenant_subscription.", "Do not raw create_buff+apply_buff for platform premium/vip/scale — use this grant rail."], "buffs_atoms": {"BUFFS_GRANT_OPERATOR_PLANE": "Ecosystem operator jurisdiction: buffs.grant_subscription with operator session on ecosystem ops context — personal premium/vip or project launch/business/scale. preflight.check before grant. Not tenant SKU sales."}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Ecosystem operator grants platform subscription tier.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1", "shared.subscription.two_plane.gen1"], "id": "buffs.grant_subscription", "mutation_risk": "high", "related_tools": ["buffs.get_effective_limits", "buffs.create_buff", "buffs.apply_buff"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Buffs Grant Subscription"}, "doc_audience": "operator", "effect": {"conditional_mutate": "Ecosystem operator grants platform subscription tier.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Ecosystem operator grants platform subscription tier.", "kind": "mutate", "read_only_hint": false}, "example_params": {"duration_days": 123, "entity_id": 1170, "plane": "personal", "tier": "vip", "verify": true}, "example_request": {"action": "buffs.grant_subscription", "params": {"duration_days": 123, "entity_id": 1170, "plane": "personal", "tier": "vip", "verify": true}}, "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "operator_glossary": {"platform_owner_grant": "Ecosystem operator: buffs.grant_subscription (plane, tier, entity_id) or recipe mcp_platform_subscription_grant. Personal: entity_kind=user, project_id=1. Project: entity_kind=project. Business $69: tier=basic (not slug business). Prompt: agentstack_platform_subscription_grant.", "two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Ecosystem operator jurisdiction: buffs.grant_subscription with operator session on ecosystem ops context — personal premium/vip or project launch/business/scale. preflight.check before grant. Not tenant SKU sales.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_effective_limits", "buffs.create_buff", "buffs.apply_buff"], "required_cap": "mcp_read", "requires_preflight": true, "returns_hint": "buff_id = active application id after apply; template_buff_id when a PENDING template was cloned. verify=true attaches flattened effective_limits.limits/features.", "risk_class": "low_write", "safe_action": "buffs_grant_subscription", "semantic_input_mode": "inherit_workflow", "summary": "Platform operator: grant AgentStack subscription tier in one step (resolve → create_buff → apply_buff).", "title": "Buffs Grant Subscription", "tool_chains": ["multi_tenant_onboarding"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem operator only — operator session on ecosystem ops; not tenant SKU sales", "grant_failed": "buffs.get_effective_limits verify; check entity_id and plane", "invalid_tier": "plane+tier from platform grant table (personal premium/vip or project launch+)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "preflight.check with ecosystem ops context bound before grant", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "buffs.write cap on API key — widen service_caps or operator session", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "tier_denied": "tier/cap denied — buffs.get_effective_limits first; verify plane+entity_kind", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem operator grants personal premium/vip or project launch/business/scale.", "write_mode": null}, {"action": "buffs.grant_tenant_subscription", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not call buffs.grant_subscription on tenant PID — platform operator only.", "anti_patterns": ["Do not call buffs.grant_subscription on tenant PID — platform operator only.", "Do not hand-roll subscription tables — tenant paid path is commerce.sell.activate + webhook/C24."], "buffs_atoms": {"BUFFS_GRANT_TENANT_SELF_SERVE": "Tenant operator jurisdiction: buffs.grant_tenant_subscription on tenant project (project write) — manual comp to buyer. Paid checkout auto-grants via webhook/C24. Not buffs.grant_subscription."}, "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Tenant project grants subscription/comp to buyer user.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.buffs.hub.gen1", "shared.subscription.two_plane.gen1"], "id": "buffs.grant_tenant_subscription", "mutation_risk": "high", "related_tools": ["buffs.list_active_buffs", "buffs.create_buff", "commerce.participant.grant_holding", "commerce.sell.activate"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Buffs Grant Tenant Subscription"}, "doc_audience": "operator", "effect": {"conditional_mutate": "Tenant project grants subscription/comp to buyer user.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Tenant project grants subscription/comp to buyer user.", "kind": "mutate", "read_only_hint": false}, "example_params": {"billing_cycle": "monthly", "buff_template_id": "example_string", "plan_id": "pro_monthly", "project_id": 123, "user_id": 12345, "verify": true}, "example_request": {"action": "buffs.grant_tenant_subscription", "params": {"billing_cycle": "monthly", "buff_template_id": "example_string", "plan_id": "pro_monthly", "project_id": 123, "user_id": 12345, "verify": true}}, "execution_class": "cheap", "instruction_hint": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one …", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "operator_glossary": {"tenant_owner_grant": "Tenant operator: buffs.grant_tenant_subscription (user_id, plan_id) or commerce.participant.grant_holding for inventory. Project write on PID>1. Prompt agentstack_tenant_buff_grant. Not buffs.grant_subscription.", "two_plane_billing": "Personal user tiers free/spotlight/premium/vip (entity_kind=user). Spotlight $15 aims gates at one Free project. Business project tiers launch/basic/scale (entity_kind=project). API slug for Business $69 is basic. Never a personal buff on project quotas."}, "plane": "Plan limits: buffs.get_effective_limits. Personal plane: entity_kind=user (free, spotlight, premium, vip). Business plane: entity_kind=project (sandbox, launch/starter, business/basic, scale/pro, enterprise). access_tier on projects.get_users is RBAC membership, not billing. Grant routing: platform buffs.grant_subscription; tenant buffs.grant_tenant_subscription; paid tenant webhook/C24; inventory commerce.participant.grant_holding.", "plane_chooser": "Tenant operator jurisdiction: buffs.grant_tenant_subscription on tenant project (project write) — manual comp to buyer. Paid checkout auto-grants via webhook/C24. Not buffs.grant_subscription.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.list_active_buffs", "buffs.create_buff", "commerce.participant.grant_holding", "commerce.sell.activate"], "required_cap": "buffs.write", "requires_preflight": true, "risk_class": "low_write", "safe_action": "buffs_grant_tenant_subscription", "semantic_input_mode": "inherit_workflow", "summary": "Tenant operator: grant subscription entitlement to an end user in your project (one-shot).", "title": "Buffs Grant Tenant Subscription", "tool_chains": ["trial_to_paid_tier", "trial_to_premium"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "authenticated operator + project_id > 1 — never grant_subscription on tenant PID", "insufficient_permissions": "project write on tenant PID — not personal Premium/VIP", "invalid_project": "context.project_id or params.project_id required (PID>1)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "tenant_grant_failed": "buffs.create_buff SKU first or check plan_id slug", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Tenant agent grants subscription/comp to buyer user_id in tenant project. Support, trials, manual entitlement — not platform AgentStack tiers.", "write_mode": null}], "business": [{"action": "business.get_org", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.business.organism.gen1"], "id": "business.get_org", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Get Org"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"project_id": 123}, "example_request": {"action": "business.get_org", "params": {"project_id": 123}}, "execution_class": "plain_read", "instruction_hint": "Get business org config and children index for a head project.", "mutation_kind": "none", "next_actions": ["business.command_snapshot"], "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "business_get_org", "semantic_input_mode": "inherit_workflow", "summary": "Get business org config and children index for a head project.", "title": "Business Get Org", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get business org config and children index for a head project.", "write_mode": null}, {"action": "business.list_children", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.business.organism.gen1"], "id": "business.list_children", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business List Children"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"limit": 123, "project_id": 123}, "example_request": {"action": "business.list_children", "params": {"limit": 123, "project_id": 123}}, "execution_class": "plain_read", "instruction_hint": "List child organ projects for a business head.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "business_list_children", "semantic_input_mode": "inherit_workflow", "summary": "List child organ projects for a business head.", "title": "Business List Children", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List child organ projects for a business head.", "write_mode": null}, {"action": "business.attach_child", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Federates child organ with head business org.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.attach_child", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Attach Child"}, "do_not_use_when": "Do not re-attach organs create_composite already returned. Single-project edits — use projects.* on that child.", "effect": {"conditional_mutate": "Federates child organ with head business org.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Federates child organ with head business org.", "kind": "mutate", "read_only_hint": false}, "example_params": {"display_name": "example_string", "idempotency_key": "example_string", "organ": "example_string", "preset_id": "example_string", "project_id": 123}, "example_request": {"action": "business.attach_child", "params": {"display_name": "example_string", "idempotency_key": "example_string", "organ": "example_string", "preset_id": "example_string", "project_id": 123}}, "execution_class": "cheap", "instruction_hint": "Add one missing organ to an existing head. Do not call this for organs business.create_composite al…", "mutation_kind": "entity", "next_actions": ["business.list_children"], "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "business_attach_child", "semantic_input_mode": "inherit_workflow", "summary": "Attach a child organ project to a business head.", "title": "Business Attach Child", "when_blocked": {"business_quota_exceeded": "Reduce organs — business.list_children then tariff", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "organ_already_attached": "business.list_children — detach before re-attach", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Do not re-attach organs create_composite already returned. Single-project edits — use projects.* on that child.", "when_to_use": "Add one missing organ to an existing head. Do not call this for organs business.create_composite already created. Stay under the tariff child cap.", "write_mode": null}, {"action": "business.link_child", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "business.link_child", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Business Link Child"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Link an existing owned project as a business organ (adopt).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "business_link_child", "semantic_input_mode": "inherit_workflow", "summary": "Link an existing owned project as a business organ (adopt).", "title": "Business Link Child", "when_blocked": {"business_quota_exceeded": "Detach or upgrade tariff before link", "child_access_denied": "Actor must admin both head and child project", "child_same_as_head": "existing_project_id must differ from head project_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry with idempotency_key unchanged", "existing_project_id_required": "business.list_adopt_candidates on head project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Link an existing owned project as a business organ (adopt).", "write_mode": null}, {"action": "business.list_adopt_candidates", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "business.list_adopt_candidates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Business List Adopt Candidates"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List projects eligible for adopt/link into a business head.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "business_list_adopt_candidates", "semantic_input_mode": "inherit_workflow", "summary": "List projects eligible for adopt/link into a business head.", "title": "Business List Adopt Candidates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List projects eligible for adopt/link into a business head.", "write_mode": null}, {"action": "business.list_composite_adopt_candidates", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "business.list_composite_adopt_candidates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Business List Composite Adopt Candidates"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List standalone projects eligible for adopt during composite business create.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "business_list_composite_adopt_candidates", "semantic_input_mode": "inherit_workflow", "summary": "List standalone projects eligible for adopt during composite business create.", "title": "Business List Composite Adopt Candidates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry — list standalone projects for adopt[]", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List standalone projects eligible for adopt during composite business create.", "write_mode": null}, {"action": "business.transfer_preflight", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "business.transfer_preflight", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Business Transfer Preflight"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Scan transfer blockers before listing a project for sale.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "financial", "safe_action": "business_transfer_preflight", "semantic_input_mode": "inherit_workflow", "summary": "Scan transfer blockers before listing a project for sale.", "title": "Business Transfer Preflight", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; inspect blockers[] on success with can_transfer=false", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_project_owner": "Only project owner may run sale/transfer preflight", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Scan transfer blockers before listing a project for sale.", "write_mode": null}, {"action": "business.detach_child", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Removes child from head org; revokes federation/channels/access.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.detach_child", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Detach Child"}, "effect": {"conditional_mutate": "Removes child from head org; revokes federation/channels/access.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Removes child from head org; revokes federation/channels/access.", "kind": "mutate", "read_only_hint": false}, "example_params": {"child_project_id": 123, "project_id": 123}, "example_request": {"action": "business.detach_child", "params": {"child_project_id": 123, "project_id": 123}}, "execution_class": "cheap", "instruction_hint": "Detach a child organ from business head.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "business_detach_child", "semantic_input_mode": "inherit_workflow", "summary": "Detach a child organ from business head.", "title": "Business Detach Child", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Detach a child organ from business head.", "write_mode": null}, {"action": "business.command_snapshot", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.command_snapshot", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Command Snapshot"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"include_integrations": true, "project_id": 123}, "example_request": {"action": "business.command_snapshot", "params": {"include_integrations": true, "project_id": 123}}, "execution_class": "cheap", "instruction_hint": "Primary BFF read for business head — not projects.get_data blob.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "business_command_snapshot", "semantic_input_mode": "inherit_workflow", "summary": "Business command center aggregate (finance + CRM + org).", "title": "Business Command Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once after project_id bind", "forbidden": "business command read — finance/CRM membership on head", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Primary BFF read for business head — not projects.get_data blob.", "write_mode": null}, {"action": "business.create_composite", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.create_composite", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Create Composite"}, "do_not_use_when": "Head already exists — use business.attach_child or business.link_child for one extra organ. Do not call create_composite again for the same company.", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"adopt": [], "name": "example_string", "organs": [], "tariff_template_id": "example_string"}, "example_request": {"action": "business.create_composite", "params": {"adopt": [], "name": "example_string", "organs": [], "tariff_template_id": "example_string"}}, "execution_class": "cheap", "instruction_hint": "New company only: one call returns head_project_id and children[].project_id. Do not business.attac…", "mutation_kind": "entity", "next_actions": ["business.list_children", "business.resolve_child"], "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "business_create_composite", "semantic_input_mode": "inherit_workflow", "summary": "Create business head + attach organ children from template.", "title": "Business Create Composite", "when_blocked": {"business_quota_exceeded": "Reduce organs[] — check max_business_children on tariff", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Inspect saga rollback — list_children before retry", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "organs_empty": "Omit organs for crm+storefront default or pass adopt[]", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Head already exists — use business.attach_child or business.link_child for one extra organ. Do not call create_composite again for the same company.", "when_to_use": "New company only: one call returns head_project_id and children[].project_id. Do not business.attach_child those organs again. CRM contacts use the CRM child project_id from children[] (resolve_child", "write_mode": null}, {"action": "business.resolve_child", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.business.organism.gen1"], "id": "business.resolve_child", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Business Resolve Child"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "After business.create_composite: map organ display_name to child project_id for crm.* on that organ…", "mutation_kind": "none", "next_actions": ["crm.get_crm_config", "crm.upsert_contact"], "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "business_resolve_child", "semantic_input_mode": "inherit_workflow", "summary": "Resolve child organ project_id by display_name under a business head.", "title": "Business Resolve Child", "when_blocked": {"ambiguous_display_name": "Narrow organ= or use unique display_name", "child_not_found": "business.list_children — confirm display_name and organ=crm", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "display_name required": "Pass exact display_name from business.list_children", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "project_admin or head read membership required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After business.create_composite: map organ display_name to child project_id for crm.* on that organ. Prefer children[] from create_composite — avoid extra list_children when the recipe already returne", "write_mode": null}, {"action": "business.list_tariff_templates", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.business.organism.gen1"], "id": "business.list_tariff_templates", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business List Tariff Templates"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"project_id": 123}, "example_request": {"action": "business.list_tariff_templates", "params": {"project_id": 123}}, "execution_class": "plain_read", "instruction_hint": "List business tariff templates available for a head project.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "business_list_tariff_templates", "semantic_input_mode": "inherit_workflow", "summary": "List business tariff templates available for a head project.", "title": "Business List Tariff Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List business tariff templates available for a head project.", "write_mode": null}, {"action": "business.apply_tariff", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.apply_tariff", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Apply Tariff"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"project_id": 123, "template_id": "example_string"}, "example_request": {"action": "business.apply_tariff", "params": {"project_id": 123, "template_id": "example_string"}}, "execution_class": "cheap", "instruction_hint": "Apply a tariff template to a business head project.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "business_apply_tariff", "semantic_input_mode": "inherit_workflow", "summary": "Apply a tariff template to a business head project.", "title": "Business Apply Tariff", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "template_id_required": "business.list_tariff_templates — pick template_id", "unauthorized": "auth.get_profile — operator session required", "unknown_tariff_template": "template_id from list_tariff_templates catalog", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply a tariff template to a business head project.", "write_mode": null}, {"action": "business.patch_org_settings", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.business.organism.gen1"], "id": "business.patch_org_settings", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Business Patch Org Settings"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"project_id": 123, "settings": {}}, "example_request": {"action": "business.patch_org_settings", "params": {"project_id": 123, "settings": {}}}, "execution_class": "cheap", "instruction_hint": "Patch business head org settings (config.org leaf).", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Company tree: business.command_snapshot, then business.list_children.", "plane_chooser": "New company: business.create_composite once — do not attach_child those organs again. Org head: business.command_snapshot — finance+CRM+children aggregate. Tree: business.get_org / list_children before attach_child / link_child. Tariffs: business.list_tariff_templates → business.apply_tariff. Risk: business.transfer_preflight before detach_child. Operator + Telegram fleet: options.recipe_id mcp_tenant_business_assistant_v1 on head project_id — not agents.orchestrate for the default batch.", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_tenant_business_assistant", "agentstack_business_flows"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "business_patch_org_settings", "semantic_input_mode": "inherit_workflow", "summary": "Patch business head org settings (config.org leaf).", "title": "Business Patch Org Settings", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; business.get_org before mutations", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_admin_required": "Head project admin — not read-only member", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "settings_required": "Pass settings object — partial org config leaf", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch business head org settings (config.org leaf).", "write_mode": null}], "calendar": [{"action": "calendar.events", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "calendar", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.calendar.gen1"], "id": "calendar.events", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Calendar Events"}, "domain_title": "Calendar MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.calendar.gen1"], "instruction_hint": "Show project calendar month view before upserting manual events.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.calendar", "owner_gene": "core.mcp.calendar.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "calendar_events", "semantic_input_mode": "inherit_workflow", "summary": "List calendar events merged from CRM deals, activities, invoices, manual.", "title": "Calendar Events", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Show project calendar month view before upserting manual events.", "write_mode": null}, {"action": "calendar.event.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "calendar", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.calendar.gen1"], "id": "calendar.event.upsert", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Calendar Event Upsert"}, "domain_title": "Calendar MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"event": {}, "project_id": 123}, "example_request": {"action": "calendar.event.upsert", "params": {"event": {}, "project_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.mcp.calendar.gen1"], "instruction_hint": "Add or edit a manual calendar block after calendar.events.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.calendar", "owner_gene": "core.mcp.calendar.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["calendar.event.delete"], "safe_action": "calendar_event_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Create or update a manual calendar event on ecosystem.calendar.manual_events.", "title": "Calendar Event Upsert", "verification": ["calendar.events"], "verify": [{"action": "calendar.events", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add or edit a manual calendar block after calendar.events.", "write_mode": null}, {"action": "calendar.event.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "calendar", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.calendar.gen1"], "id": "calendar.event.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Calendar Event Delete"}, "domain_title": "Calendar MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.calendar.gen1"], "instruction_hint": "Remove a manual event by id from calendar.events.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.calendar", "owner_gene": "core.mcp.calendar.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "calendar_event_delete", "semantic_input_mode": "inherit_workflow", "summary": "Delete a manual calendar event by id.", "title": "Calendar Event Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove a manual event by id from calendar.events.", "write_mode": null}], "cardgame": [{"action": "cardgame.dna.read_rows", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "cardgame", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.cardgame.gen1"], "id": "cardgame.dna.read_rows", "related_tools": ["commands.execute", "cardgame.rules.execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Cardgame Dna Read Rows"}, "domain_title": "Cardgame MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.cardgame.gen1"], "instruction_hint": "Read public or owner-scoped cardgame state for reasoning before proposing a move.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.cardgame", "owner_gene": "core.mcp.cardgame.gen1", "related_tools": ["commands.execute", "cardgame.rules.execute"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "cardgame_dna_read_rows", "semantic_input_mode": "inherit_workflow", "summary": "List up to ``limit`` rows for a cardgame 8DNA entity type using DNA CRUD get (same permission model as the SPA). Use for match room / cell snapshots when building agent context.", "title": "Cardgame Dna Read Rows", "when_to_use": "Read public or owner-scoped cardgame state for reasoning before proposing a move.", "write_mode": null}, {"action": "cardgame.rules.execute", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "cardgame", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.cardgame.gen1"], "id": "cardgame.rules.execute", "related_tools": ["cardgame.dna.read_rows", "logic.execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Cardgame Rules Execute"}, "domain_title": "Cardgame MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.cardgame.gen1"], "instruction_hint": "Let an agent take a turn or advance match flow after validating legality server-side.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.cardgame", "owner_gene": "core.mcp.cardgame.gen1", "related_tools": ["cardgame.dna.read_rows", "logic.execute"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "cardgame_rules_execute", "semantic_input_mode": "inherit_workflow", "summary": "Execute a Logic Engine command for ArcaneStack (e.g. ``cardgame.match.play_card``) with the same payload shape as the game client. Requires authenticated MCP context.", "title": "Cardgame Rules Execute", "when_to_use": "Let an agent take a turn or advance match flow after validating legality server-side.", "write_mode": null}], "channels": [{"action": "channels.list_identities", "aliases": ["channel.list_identities"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.list_identities", "related_tools": ["notifications.deliver", "bots.list", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels List Identities"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.deliver", "bots.list", "notifications.list_prefs"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "channels_list_identities", "semantic_input_mode": "inherit_workflow", "summary": "List linked bot channel identities for the signed-in user.", "title": "Channels List Identities", "when_blocked": {"unauthorized": "auth.get_profile — linked bot identities are per signed-in user"}, "when_to_use": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first.", "write_mode": null}, {"action": "channels.enroll_source", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.channel_plane.gen1"], "id": "channels.enroll_source", "related_tools": ["channels.delete_source", "channels.list_identities", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Enroll Source"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "ReachabilityHub enroll or bot /notify_on parity. User must /login in bot first.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.delete_source", "channels.list_identities", "notifications.list_prefs"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "channels_enroll_source", "semantic_input_mode": "inherit_workflow", "summary": "Upsert a notification source (bot channel, web_push, email enrollment).", "title": "Channels Enroll Source", "when_blocked": {"bot_channel_mismatch": "bots.list — source bot_id must match linked channel identity", "bot_not_accessible": "bots.list — bot missing, not live, or actor lacks project access", "channel_not_linked": "channels.list_identities — user must /login in the bot or complete OAuth link first", "forbidden": "auth.get_profile — enroll only for self unless admin", "invalid_parameters": "NotificationSource schema invalid — kind, bot_id, channel required where applicable", "validation_error": "Fix NotificationSource JSON — compare notifications.list_prefs sources shape"}, "when_to_use": "ReachabilityHub enroll or bot /notify_on parity. User must /login in bot first.", "write_mode": null}, {"action": "channels.delete_source", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.channel_plane.gen1"], "id": "channels.delete_source", "related_tools": ["channels.enroll_source", "notifications.delete_source"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Delete Source"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Profile unenroll / revoke bot notify source.", "mutation_kind": "entity", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.enroll_source", "notifications.delete_source"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "channels_delete_source", "semantic_input_mode": "inherit_workflow", "summary": "Remove a notification source by id.", "title": "Channels Delete Source", "when_blocked": {"invalid_parameters": "source_id required — notifications.list_prefs → prefs.delivery.sources", "unauthorized": "auth.get_profile — source delete is user-scoped"}, "when_to_use": "Profile unenroll / revoke bot notify source.", "write_mode": null}, {"action": "channels.deliver", "aliases": ["channel.deliver", "channels.notify", "channels.send"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Not a reply on the user's @agentstack.tech thread — messaging.inbox.reply.", "anti_patterns": ["Not a reply on the user's @agentstack.tech thread — messaging.inbox.reply.", "Not outbound personal mail from the claimed address — messaging.mail.send.", "Not claiming an address — messaging.mailbox.claim."], "capability_descriptor": {"complexity": "intermediate", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.deliver", "related_tools": ["channels.resolve_routing", "notifications.list_prefs", "bots.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Deliver"}, "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Eligibility dry_run with fallback_chain", "request": {"category": "security", "channels": ["telegram"], "dry_run": true, "fallback_chain": ["email", "in_app"], "message": "No send — dry_run only.", "title": "Channel plane check"}}], "execution_class": "cheap", "instruction_hint": "One call, explicit channels. OS-only push remains notifications.send_push.", "mutation_kind": "entity", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.resolve_routing", "notifications.list_prefs", "bots.list"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "channels_deliver", "semantic_input_mode": "inherit_workflow", "summary": "Send via unified channel plane (same bus as notifications.deliver).", "title": "Channels Deliver", "when_blocked": {"channel_disabled": "notifications.list_prefs — user turned channel off or Mail Hub email is disabled", "channel_not_linked": "channels.create_bind_link — user must complete Telegram bind or /login in bot; not a batch DAG dependency_error", "dependency_error": "Batch DAG: fix the first failed step_id or poll verification_action — not a Telegram binding bug. Standalone deliver: channels.list_identities + user /login in bot for external_user_id", "digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — deliver to another user_id only as project admin", "handle_required": "This key owns several handles. Pass source_agent_id or start the text with @handle.", "invalid_parameters": "title or message required; channels[] via normalize_deliver_channels — discovery.describe. handle_required when this key owns several handles and neither source_agent_id nor @handle is set. Quote-reply on the sent turn routes to the stamped mailbox. Leading @handle on text stamps author only; @OtherHandle in the body wakes that mailbox webhook. Cross-agent mailbox writes use bots.bus.deliver to_handle.", "no_channel_target": "bots.list + user /login in the bot — deliver skips channels without external_user_id", "no_eligible_channels": "notifications.list_prefs + notifications.update_prefs — transport/prefs intersection empty; dry_run:true to preview skip_reasons before send", "operation_failed": "channels.delivery_status with correlation_key — provider rejected; check bot token and channel id", "orchestration_step_violation": "preflight.check then notifications.deliver — or follow packet.next_action / inverse_resume; do not call deliver outside the current workflow step allow-list", "prefs_filter_failed": "notifications.list_prefs — corrupt prefs leaf; list_prefs re-seeds plane or fix JSON via update_prefs", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "quota": "buffs.get_effective_limits — project notice caps before retry; not rag_embed_quota or storage_quota", "source_agent_forbidden": "source_agent_id or @handle must be a mailbox bound to this API key", "source_not_enrolled": "channels.enroll_source after channels.list_identities — source not enrolled for user", "template_missing": "projects.config.notifications.templates — pass title/message or notifications.register_category with a matching template name", "unauthorized": "auth.get_profile — signed-in user or service key with notify caps"}, "when_to_use": "One call, explicit channels. OS-only push remains notifications.send_push.", "write_mode": null}, {"action": "channels.delivery_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": true, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.delivery_status", "related_tools": ["channels.test_delivery", "channels.list_failed_deliveries", "notifications.delivery_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Delivery Status"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Track OTP / alert / test ping outcome after channels.test_delivery.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.test_delivery", "channels.list_failed_deliveries", "notifications.delivery_status"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "channels_delivery_status", "semantic_input_mode": "inherit_workflow", "summary": "Read delivery receipts for a correlation_key from user DNA.", "title": "Channels Delivery Status", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "invalid_parameters": "correlation_key required — pass key from channels.deliver result", "not_found": "No receipts yet — deliver first or channels.delivery_snapshot for recent rows"}, "when_to_use": "Track OTP / alert / test ping outcome after channels.test_delivery.", "write_mode": null}, {"action": "channels.delivery_snapshot", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.channel_plane.gen1", "core.messaging.delivery.gen1"], "id": "channels.delivery_snapshot", "related_tools": ["channels.delivery_status", "channels.digest_depth", "notifications.list_prefs", "channels.list_failed_deliveries"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Delivery Snapshot"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Profile reachability / matrix — same as GET /users/me/notification-delivery-status.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.delivery_status", "channels.digest_depth", "notifications.list_prefs", "channels.list_failed_deliveries"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "channels_delivery_snapshot", "semantic_input_mode": "inherit_workflow", "summary": "Reachability snapshot: recent receipts, failed subset, and can_deliver flags (same as GET /users/me/notification-delivery-status).", "title": "Channels Delivery Snapshot", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "unauthorized": "auth.get_profile — reachability snapshot requires signed-in user"}, "when_to_use": "Profile reachability / matrix — same as GET /users/me/notification-delivery-status.", "write_mode": null}, {"action": "channels.sources_health", "aliases": ["channel.sources_health", "channels.list_sources_health"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.channel_plane.gen1", "core.messaging.delivery.gen1"], "id": "channels.sources_health", "related_tools": ["notifications.list_prefs", "channels.delivery_snapshot", "channels.enroll_source"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Sources Health"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "SourcesList health dots — prefer one call over per-source GET.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.list_prefs", "channels.delivery_snapshot", "channels.enroll_source"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "channels_sources_health", "semantic_input_mode": "inherit_workflow", "summary": "Batch health for all enrolled notification sources (same as GET /users/me/notification-sources/health).", "title": "Channels Sources Health", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "unauthorized": "auth.get_profile — sources health is user-scoped"}, "when_to_use": "SourcesList health dots — prefer one call over per-source GET.", "write_mode": null}, {"action": "channels.source_health", "aliases": ["channel.source_health", "channels.get_source_health"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.channel_plane.gen1", "core.messaging.delivery.gen1"], "id": "channels.source_health", "related_tools": ["channels.sources_health", "channels.enroll_source", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Source Health"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Diagnose one SourcesList dot — REST GET …/notification-sources/{source_id}/health.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.sources_health", "channels.enroll_source", "notifications.list_prefs"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "channels_source_health", "semantic_input_mode": "inherit_workflow", "summary": "Health for one enrolled notification source (REST GET /users/me/notification-sources/{source_id}/health).", "title": "Channels Source Health", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "invalid_parameters": "source_id required", "unauthorized": "auth.get_profile — per-source health is user-scoped"}, "when_to_use": "Diagnose one SourcesList dot — REST GET …/notification-sources/{source_id}/health.", "write_mode": null}, {"action": "channels.test_delivery", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Not a reply on the user's corporate mail thread — messaging.inbox.reply.", "anti_patterns": ["Not a reply on the user's corporate mail thread — messaging.inbox.reply.", "Not ecosystem admin SMTP — messaging.send_email."], "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.test_delivery", "related_tools": ["channels.delivery_status", "channels.deliver", "channels.resolve_routing"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Test Delivery"}, "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Profile Reachability test ping; defaults correlation channel:test:{user_id}.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.delivery_status", "channels.deliver", "channels.resolve_routing"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "channels_test_delivery", "semantic_input_mode": "inherit_workflow", "summary": "Enqueue a short test message on one channel (self or admin).", "title": "Channels Test Delivery", "when_blocked": {"channel_disabled": "notifications.list_prefs — user turned channel off or Mail Hub email is disabled", "channel_not_linked": "channels.create_bind_link — user must complete Telegram bind or /login in bot; not a batch DAG dependency_error", "dependency_error": "Batch DAG: fix the first failed step_id or poll verification_action — not a Telegram binding bug. Standalone deliver: channels.list_identities + user /login in bot for external_user_id", "digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — deliver to another user_id only as project admin", "handle_required": "This key owns several handles. Pass source_agent_id or start the text with @handle.", "invalid_parameters": "title or message required; channels[] via normalize_deliver_channels — discovery.describe. handle_required when this key owns several handles and neither source_agent_id nor @handle is set. Quote-reply on the sent turn routes to the stamped mailbox. Leading @handle on text stamps author only; @OtherHandle in the body wakes that mailbox webhook. Cross-agent mailbox writes use bots.bus.deliver to_handle.", "no_channel_target": "bots.list + user /login in the bot — deliver skips channels without external_user_id", "no_eligible_channels": "notifications.list_prefs + notifications.update_prefs — transport/prefs intersection empty; dry_run:true to preview skip_reasons before send", "operation_failed": "channels.delivery_status with correlation_key — provider rejected; check bot token and channel id", "orchestration_step_violation": "preflight.check then notifications.deliver — or follow packet.next_action / inverse_resume; do not call deliver outside the current workflow step allow-list", "prefs_filter_failed": "notifications.list_prefs — corrupt prefs leaf; list_prefs re-seeds plane or fix JSON via update_prefs", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "quota": "buffs.get_effective_limits — project notice caps before retry; not rag_embed_quota or storage_quota", "source_agent_forbidden": "source_agent_id or @handle must be a mailbox bound to this API key", "source_not_enrolled": "channels.enroll_source after channels.list_identities — source not enrolled for user", "template_missing": "projects.config.notifications.templates — pass title/message or notifications.register_category with a matching template name", "unauthorized": "auth.get_profile — signed-in user or service key with notify caps"}, "when_to_use": "Profile Reachability test ping; defaults correlation channel:test:{user_id}.", "write_mode": null}, {"action": "channels.resolve_routing", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.resolve_routing", "related_tools": ["channels.deliver", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Resolve Routing"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Preview security routing", "request": {"category": "security", "channels": ["email", "in_app"]}}], "execution_class": "plain_read", "instruction_hint": "Routing read before deliver. Sending the notice is notifications.deliver.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.deliver", "notifications.deliver"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "channels_resolve_routing", "semantic_input_mode": "inherit_workflow", "summary": "Preview effective channels after prefs ∩ sources ∩ project policy. Reads those prefs on the server and does not return the profile.", "title": "Channels Resolve Routing", "when_blocked": {"forbidden": "auth.get_profile — resolve routing for another user_id only as admin", "not_found": "notifications.list_prefs — user or category routing missing"}, "when_to_use": "Routing read before deliver. Sending the notice is notifications.deliver.", "write_mode": null}, {"action": "channels.list_failed_deliveries", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.list_failed_deliveries", "related_tools": ["channels.delivery_status", "channels.test_delivery"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels List Failed Deliveries"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Profile delivery troubleshooting before re-test.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.delivery_status", "channels.test_delivery"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "channels_list_failed_deliveries", "semantic_input_mode": "inherit_workflow", "summary": "Recent failed/skipped delivery receipts for the user.", "title": "Channels List Failed Deliveries", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "unauthorized": "auth.get_profile — failed delivery log is user-scoped"}, "when_to_use": "Profile delivery troubleshooting before re-test.", "write_mode": null}, {"action": "channels.list_event_triggers", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.channel_plane.gen1"], "id": "channels.list_event_triggers", "related_tools": ["logic.create", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels List Event Triggers"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Attach Logic rules to delivery/enrollment/MFA channel events.", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["logic.create", "notifications.deliver"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "channels_list_event_triggers", "semantic_input_mode": "inherit_workflow", "summary": "Catalog of normalized channel neural_event kinds for Logic subscriptions.", "title": "Channels List Event Triggers", "when_blocked": {"unauthorized": "auth.get_profile — event trigger catalog requires signed-in user"}, "when_to_use": "Attach Logic rules to delivery/enrollment/MFA channel events.", "write_mode": null}, {"action": "channels.digest_depth", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.digest_depth", "related_tools": ["channels.flush_digest", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Digest Depth"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read pending quiet-hours / digest_mode queue before flush. REST GET /users/me/notify-digest-depth. …", "mutation_kind": "none", "next_actions": ["channels.flush_digest", "notifications.list_prefs"], "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.flush_digest", "notifications.list_prefs"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "channels_digest_depth", "semantic_input_mode": "inherit_workflow", "summary": "Pending quiet-hours / digest_mode queue depth (same as GET /users/me/notify-digest-depth).", "title": "Channels Digest Depth", "when_blocked": {"forbidden": "auth.get_profile — query another user_id only as admin", "unauthorized": "Signed-in user required"}, "when_to_use": "Read pending quiet-hours / digest_mode queue before flush. REST GET /users/me/notify-digest-depth. Not notifications.deliver.", "write_mode": null}, {"action": "channels.flush_digest", "aliases": ["notifications.flush_digest", "notify.flush_digest"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "channels.flush_digest", "related_tools": ["channels.digest_depth", "notifications.list_prefs", "channels.delivery_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Flush Digest"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Deliver batched user alerts now. Call channels.digest_depth first when unsure. REST POST /users/me/…", "mutation_kind": "none", "next_actions": ["channels.digest_depth", "channels.delivery_snapshot", "notifications.list_prefs"], "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.digest_depth", "notifications.list_prefs", "channels.delivery_snapshot"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "channels_flush_digest", "semantic_input_mode": "inherit_workflow", "summary": "Flush pending quiet-hours / digest notifications for the signed-in user.", "title": "Channels Flush Digest", "when_blocked": {"digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — query another user_id only as admin", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "unauthorized": "Signed-in user required"}, "when_to_use": "Deliver batched user alerts now. Call channels.digest_depth first when unsure. REST POST /users/me/notify-flush-digest. Not Mail Hub messaging.send_email.", "write_mode": null}, {"action": "channels.route", "ai_tips": "Bind the signed-in user's source channel to a delivery category, an agent, or a logic rule. The leaf is user.data.channel_routes on that user row. The first put keeps the email-to-chat template.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not subscribe the same logic_id to channel.event.inbound_message. This tool already queues that rule.", "anti_patterns": ["Do not subscribe the same logic_id to channel.event.inbound_message. This tool already queues that rule.", "Do not store message bodies on the route. The leaf holds ids and channel names only.", "An explicit items list replaces the email template. Remove the email-template row only when chat delivery should stop."], "capability_descriptor": {"complexity": "intermediate", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.channel_plane.gen1", "core.messaging.delivery.gen1"], "id": "channels.route", "related_tools": ["messaging.mailbox.agent.set", "messaging.inbox.list", "notifications.list_prefs", "channels.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Route"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Bind source channel to category, agent, or logic. op=list returns rows and email plan. Read ok/succ…", "mutation_kind": "path", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["messaging.mailbox.agent.set", "messaging.inbox.list", "notifications.list_prefs", "channels.deliver"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "channels_route", "semantic_input_mode": "inherit_workflow", "summary": "List, put, or remove one channel binding for the signed-in user. op=list returns the stored rows and the email plan.", "title": "Channels Route", "when_blocked": {"invalid_parameters": "op list|put|remove; remove needs id", "not_found": "user row missing — confirm auth.get_profile user id", "route_cap": "Replace an existing route id — cap is ROUTE_CAP rows; see decorator anti_patterns", "unauthorized": "auth.get_profile — channel_routes are per signed-in user"}, "when_to_use": "Bind source channel to category, agent, or logic. op=list returns rows and email plan. Read ok/success on put/remove — not HTTP status.", "write_mode": null}, {"action": "channels.create_bind_link", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.channel_plane.gen1"], "id": "channels.create_bind_link", "related_tools": ["channels.list_identities", "channels.enroll_source", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Create Bind Link"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Telegram deliver blocked — list_identities empty (ch-02).", "mutation_kind": "entity", "next_actions": ["channels.list_identities", "channels.enroll_source", "notifications.deliver"], "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.list_identities", "channels.enroll_source", "notifications.deliver"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "channels_create_bind_link", "semantic_input_mode": "inherit_workflow", "summary": "Self-serve Telegram deep link (/start bind_*) for the signed-in user.", "title": "Channels Create Bind Link", "when_blocked": {"bot_not_accessible": "bots.list — no live bot or create_telegram_bind_deeplink failed; complete bots.go_live before bind", "invalid_parameters": "project_id required in params or context", "unauthorized": "auth.get_profile — bind link is per signed-in user"}, "when_to_use": "Telegram deliver blocked — list_identities empty (ch-02).", "write_mode": null}, {"action": "channels.setup", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.channel_plane.gen1", "core.mcp.self_description.gen1"], "id": "channels.setup", "related_tools": ["channels.create_bind_link", "bots.list", "notifications.list_prefs", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Channels Setup"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Single entry before notifications.deliver when channel plane is unfamiliar.", "mutation_kind": "none", "next_actions": ["bots.list", "notifications.list_prefs", "channels.create_bind_link", "notifications.deliver"], "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.create_bind_link", "bots.list", "notifications.list_prefs", "notifications.deliver"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "channels_setup", "semantic_input_mode": "inherit_workflow", "summary": "Guided notification channel setup (recipe mcp_notify_channels_v1 ladder).", "title": "Channels Setup", "when_blocked": {"dependency_error": "Batch DAG blocked step — fix upstream step_id; standalone: run ladder tools in order", "no_channel_target": "channels.create_bind_link then user /start bind_* in Telegram — or channels.enroll_source after list_identities", "unauthorized": "auth.get_profile — ladder is user-scoped"}, "when_to_use": "Single entry before notifications.deliver when channel plane is unfamiliar.", "write_mode": null}], "checklist": [{"action": "checklist.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "checklist", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.checklist.gen1", "core.work.checklist.gen1"], "id": "checklist.get", "related_tools": ["checklist.toggle_item", "checklist.append_item", "crm.get_deal"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Checklist Get", "visitor_callable": false}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"params": {"entity_id": "deal-abc", "entity_type": "crm_deal", "project_id": 1}}], "execution_class": "plain_read", "instruction_hint": "Read deal or task checklist before toggling items.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Before go-live: preflight.check, then checklist.get.", "plane_chooser": "Before go-live: preflight.check, then checklist.get.", "related_prompts": ["agentstack_hosted_vertical"], "related_tools": ["checklist.toggle_item", "checklist.append_item", "crm.get_deal"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "checklist_get", "semantic_input_mode": "inherit_workflow", "summary": "Get checklist for an entity (e.g. crm_deal).", "title": "Checklist Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied — project membership or CRM read cap required.", "invalid_parameters": "entity_id required — pass CRM entity id.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Malformed params — fix entity_type / entity_id."}, "when_to_use": "Read deal or task checklist before toggling items.", "write_mode": null}, {"action": "checklist.set", "ai_tips": "Replace full checklist snapshot on a CRM deal or work item (write_mode=replace only).", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "checklist", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.checklist.gen1", "core.work.checklist.gen1"], "id": "checklist.set", "related_tools": ["checklist.get", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Checklist Set", "visitor_callable": false}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"entity_id": "example_string", "entity_type": "example_string", "items": [], "project_id": 123, "write_mode": "replace"}, "example_request": {"action": "checklist.set", "params": {"entity_id": "example_string", "entity_type": "example_string", "items": [], "project_id": 123, "write_mode": "replace"}}, "examples": [{"name": "Replace deal checklist snapshot", "params": {"entity_id": "deal-abc", "entity_type": "crm_deal", "items": [{"id": "step-1", "label": "Confirm budget", "status": "open"}], "project_id": 1, "write_mode": "replace"}}], "execution_class": "cheap", "instruction_hint": "Replace full checklist template on a CRM deal or work item.", "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "plane": "Before go-live: preflight.check, then checklist.get.", "plane_chooser": "Before go-live: preflight.check, then checklist.get.", "related_prompts": ["agentstack_hosted_vertical"], "related_tools": ["checklist.get", "preflight.check"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "rollback": ["checklist.set"], "safe_action": "checklist_set", "semantic_input_mode": "inherit_workflow", "summary": "Replace checklist items for an entity.", "title": "Checklist Set", "verification": ["checklist.get"], "verify": [{"action": "checklist.get", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied for checklist write on this entity.", "invalid_parameters": "items must be a non-empty array; entity_id required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Item objects need id + label and valid status enum.", "write_mode_unsupported": "checklist.set only supports write_mode=replace."}, "when_to_use": "Replace full checklist template on a CRM deal or work item.", "write_mode": ["replace"], "write_mode_note": "checklist.set replaces the full items list — write_mode defaults to replace."}, {"action": "checklist.toggle_item", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "checklist", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.checklist.gen1", "core.work.checklist.gen1"], "id": "checklist.toggle_item", "related_tools": ["checklist.get", "crm.get_deal"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Checklist Toggle Item", "visitor_callable": false}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"params": {"entity_id": "deal-abc", "entity_type": "crm_deal", "item_id": "step-1", "project_id": 1, "status": "done"}}], "execution_class": "cheap", "instruction_hint": "Mark one checklist step done or reopen after checklist.get.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Before go-live: preflight.check, then checklist.get.", "plane_chooser": "Before go-live: preflight.check, then checklist.get.", "related_prompts": ["agentstack_hosted_vertical"], "related_tools": ["checklist.get", "crm.get_deal"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "checklist_toggle_item", "semantic_input_mode": "inherit_workflow", "summary": "Toggle or set status on one checklist item.", "title": "Checklist Toggle Item", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied for checklist mutate.", "invalid_parameters": "item_id and entity_id required.", "item_not_found": "Unknown item_id — checklist.get first.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark one checklist step done or reopen after checklist.get.", "write_mode": null}, {"action": "checklist.append_item", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "checklist", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.checklist.gen1", "core.work.checklist.gen1"], "id": "checklist.append_item", "related_tools": ["checklist.get", "checklist.set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Checklist Append Item", "visitor_callable": false}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Append CRM deal step", "params": {"entity_id": "deal-abc", "entity_type": "crm_deal", "label": "Send contract draft", "project_id": 1}}], "execution_class": "cheap", "instruction_hint": "Add a new step to an existing entity checklist.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Before go-live: preflight.check, then checklist.get.", "plane_chooser": "Before go-live: preflight.check, then checklist.get.", "related_prompts": ["agentstack_hosted_vertical"], "related_tools": ["checklist.get", "checklist.set"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "checklist_append_item", "semantic_input_mode": "inherit_workflow", "summary": "Append a checklist step.", "title": "Checklist Append Item", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied for checklist mutate.", "invalid_parameters": "label and entity_id required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add a new step to an existing entity checklist.", "write_mode": null}, {"action": "checklist.clear", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "checklist", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.checklist.gen1", "core.work.checklist.gen1"], "id": "checklist.clear", "related_tools": ["checklist.get", "checklist.set"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Checklist Clear", "visitor_callable": false}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"entity_id": "example_string", "entity_type": "example_string", "project_id": 123}, "example_request": {"action": "checklist.clear", "params": {"entity_id": "example_string", "entity_type": "example_string", "project_id": 123}}, "execution_class": "cheap", "instruction_hint": "Reset deal or work-item checklist before cert cleanup or template swap.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Before go-live: preflight.check, then checklist.get.", "plane_chooser": "Before go-live: preflight.check, then checklist.get.", "related_prompts": ["agentstack_hosted_vertical"], "related_tools": ["checklist.get", "checklist.set"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "checklist_clear", "semantic_input_mode": "inherit_workflow", "summary": "Clear all checklist items for an entity.", "title": "Checklist Clear", "verification": ["checklist.get"], "verify": [{"action": "checklist.get", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "RBAC denied for checklist mutate.", "invalid_parameters": "entity_id required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reset deal or work-item checklist before cert cleanup or template swap.", "write_mode": null}], "commands": [{"action": "commands.execute", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commands", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.commands.gen1"], "id": "commands.execute", "mutation_risk": "low", "related_tools": ["commands.execute_batch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commands Execute"}, "domain_title": "Commands MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Retrieve project information using DNA_CRUD command", "name": "Get a project by ID", "request": {"params": {"command_name": "get_project", "command_type": "dna_crud", "payload": {"filters": {"project_id": 123}, "operation_type": "get", "target_entity": "data_projects_8dna"}, "priority": 5, "timeout_ms": 30000}, "tool": "commands.execute"}, "response": {"data": {"command_uuid": "550e8400-e29b-41d4-a716-446655440000", "execution_time_ms": 45.2, "result": {"description": "Project description", "id": 123, "is_active": true, "name": "My Project"}, "status": "completed"}, "execution_time_ms": 45.2, "success": true, "trace_id": "trace-123"}}, {"description": "Create a new project using DNA_CRUD command", "name": "Create a new project", "request": {"params": {"command_name": "create_project", "command_type": "dna_crud", "payload": {"input_data": {"description": "Project description", "is_active": true, "name": "My New Project"}, "operation_type": "create", "target_entity": "data_projects_8dna"}}, "tool": "commands.execute"}, "response": {"data": {"command_uuid": "550e8400-e29b-41d4-a716-446655440001", "execution_time_ms": 78.5, "result": {"created_at": "2025-01-20T10:00:00Z", "id": 124, "name": "My New Project"}, "status": "completed"}, "success": true}}, {"description": "Update existing project using DNA_CRUD command", "name": "Update project", "request": {"params": {"command_name": "update_project", "command_type": "dna_crud", "payload": {"filters": {"project_id": 123}, "operation_type": "update", "target_entity": "data_projects_8dna", "updates": {"description": "Updated description", "name": "Updated Project Name"}}}, "tool": "commands.execute"}, "response": {"data": {"command_uuid": "550e8400-e29b-41d4-a716-446655440002", "result": {"id": 123, "name": "Updated Project Name", "updated_at": "2025-01-20T10:05:00Z"}, "status": "completed"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.commands.gen1"], "instruction_hint": "Low-level Protein bus when no domain MCP action fits — prefer projects.patch_data, logic.*, hosting…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commands", "owner_gene": "core.mcp.commands.gen1", "plane": "App commands: commands.execute. Processor list: processors.list.", "plane_chooser": "App commands: commands.execute. Processor list: processors.list.", "related_tools": ["commands.execute_batch"], "required_cap": "logic_write|mcp.execute", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commands_execute", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Execute a single Protein Command via universal API.", "title": "Commands Execute", "tool_chains": ["game_setup"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_failed": "Command execution failed. Check error message for details", "insufficient_permissions": "RBAC denied — bind context.project_id; check project membership and service caps.", "invalid_command_type": "Prefer domain MCP (projects.patch_data, logic.*, hosting.*) — commands.execute is low-level Protein bus only when no action fits.", "invalid_payload": "Payload needs target_entity and operation_type — discovery.describe for domain actions before raw dna_crud.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "timeout": "Command execution timed out", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Low-level Protein bus when no domain MCP action fits — prefer projects.patch_data, logic.*, hosting.*, etc. Mutates when payload.operation_type is create|update|delete|delta. Omit generation_env_uuid", "write_mode": null}, {"action": "commands.execute_batch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commands", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.commands.gen1"], "id": "commands.execute_batch", "mutation_risk": "low", "related_tools": ["commands.execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commands Execute Batch"}, "domain_title": "Commands MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Execute two commands concurrently to get project and user data", "name": "Execute multiple commands in parallel", "request": {"params": {"commands": [{"command_name": "get_project", "command_type": "dna_crud", "payload": {"filters": {"project_id": 123}, "operation_type": "get", "target_entity": "data_projects_8dna"}}, {"command_name": "get_users", "command_type": "dna_crud", "payload": {"filters": {"project_id": 123}, "operation_type": "get", "target_entity": "data_projects_8dna"}}], "execute_parallel": true, "fail_fast": false}, "tool": "commands.execute_batch"}, "response": {"data": {"failed_commands": 0, "results": [{"command_uuid": "uuid-1", "result": {"id": 123, "name": "My Project"}, "status": "completed"}, {"command_uuid": "uuid-2", "result": [{"email": "user@example.com", "user_id": 1}], "status": "completed"}], "successful_commands": 2, "total_commands": 2, "total_execution_time_ms": 125.5}, "success": true}}, {"description": "Execute commands one after another, where second command depends on first", "name": "Execute commands sequentially", "request": {"params": {"commands": [{"command_name": "create_project", "command_type": "dna_crud", "payload": {"input_data": {"name": "New Project"}, "operation_type": "create", "target_entity": "data_projects_8dna"}}, {"command_name": "create_api_key", "command_type": "dna_crud", "payload": {"input_data": {"project_id": "{{result[0].id}}"}, "operation_type": "create", "target_entity": "api_keys"}}], "execute_parallel": false, "fail_fast": true}, "tool": "commands.execute_batch"}, "response": {"data": {"failed_commands": 0, "results": [{"command_uuid": "uuid-1", "result": {"id": 123}, "status": "completed"}], "successful_commands": 2, "total_commands": 2, "total_execution_time_ms": 250.0}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.commands.gen1"], "instruction_hint": "Batch Protein commands — same fork/accumulation rules as commands.execute. Use fail_fast to stop on…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commands", "owner_gene": "core.mcp.commands.gen1", "plane": "App commands: commands.execute. Processor list: processors.list.", "plane_chooser": "App commands: commands.execute. Processor list: processors.list.", "related_tools": ["commands.execute"], "required_cap": "logic_write|mcp.execute", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commands_execute_batch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Execute multiple Protein Commands in batch.", "title": "Commands Execute Batch", "when_blocked": {"batch_execution_failed": "Inspect per-index results — fail_fast stops on first error; fix upstream command.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_commands": "Pass non-empty commands list — same shape as commands.execute params.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Batch Protein commands — same fork/accumulation rules as commands.execute. Use fail_fast to stop on first error.", "write_mode": null}], "commerce": [{"action": "commerce.channel_pass.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.channel_pass.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "commerce.channel_pass.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Channel Pass Status", "visitor_callable": false}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1", "core.commerce.channel_pass.gen1"], "instruction_hint": "Read stacked channel-pass expiry for a telegram subject.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["commerce.channel_pass.configure", "shop.products.upsert", "shop.enablement.status"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_channel_pass_status", "semantic_input_mode": "inherit_workflow", "summary": "Read channel pass entitlement for a buyer subject.", "title": "Commerce Channel Pass Status", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Read stacked channel-pass expiry for a telegram subject.", "write_mode": null}, {"action": "commerce.channel_pass.binding.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.channel_pass.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "commerce.channel_pass.binding.get", "related_tools": ["commerce.channel_pass.configure", "shop.products.upsert", "scheduler.create_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Channel Pass Binding Get", "visitor_callable": false}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"binding_id": "library", "project_id": "<context.project_id>"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1", "core.commerce.channel_pass.gen1"], "instruction_hint": "Read-only verify one channel binding leaf after configure — prefer over projects.get_data when you …", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["commerce.channel_pass.configure", "commerce.channel_pass.sweep", "shop.products.upsert", "scheduler.create_task"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.channel_pass.configure", "shop.products.upsert", "scheduler.create_task"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_channel_pass_binding_get", "semantic_input_mode": "inherit_workflow", "summary": "Read one ecosystem.commerce.channels.{binding_id} leaf (no full project blob).", "title": "Commerce Channel Pass Binding Get", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "channel_binding_missing": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Read-only verify one channel binding leaf after configure — prefer over projects.get_data when you only need chat_id/bot_id/channel_only.", "write_mode": null}, {"action": "commerce.channel_pass.sweep", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.channel_pass.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "commerce.channel_pass.sweep", "related_tools": ["scheduler.create_task", "commerce.channel_pass.configure", "commerce.channel_pass.status", "shop.orders.list", "shop.fulfill"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Channel Pass Sweep", "visitor_callable": false}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1", "core.commerce.channel_pass.gen1"], "instruction_hint": "Owner on-demand wake_index sweep: expiry notices + Telegram revoke.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["scheduler.create_task", "commerce.channel_pass.configure", "commerce.channel_pass.status"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["scheduler.create_task", "commerce.channel_pass.configure", "commerce.channel_pass.status", "shop.orders.list", "shop.fulfill"], "required_cap": "project_admin", "requires_preflight": false, "returns": {"processed": "int — rows revoked or notices sent", "revoke_failed": "int optional — Telegram ban failures", "wake_save_failed": "bool optional — wake_index DNA write failed"}, "risk_class": "read", "safe_action": "commerce_channel_pass_sweep", "scheduler_create_task_example": {"cron": "15 * * * *", "enabled": true, "name": "channel_pass_sweep", "payload": {"action": "commerce.channel_pass.sweep", "project_id": "<context.project_id>"}}, "semantic_input_mode": "inherit_workflow", "summary": "Process channel_pass wake_index: expiry notices and Telegram revoke for lapsed access.", "title": "Commerce Channel Pass Sweep", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Owner on-demand wake_index sweep: expiry notices + Telegram revoke.", "write_mode": null}, {"action": "commerce.channel_pass.configure", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.channel_pass.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "commerce.channel_pass.configure", "related_tools": ["commerce.channel_pass.binding.get", "commerce.channel_pass.sweep", "shop.products.upsert", "scheduler.create_task", "shop.enablement.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Channel Pass Configure", "visitor_callable": false}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"binding_id": "library", "bot_id": "<bot uuid>", "channel_only": true, "chat_id": "-100123", "menu_intro": "Choose a period. Access stacks when you pay again.", "notify_before_days": [3, 1]}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1", "core.commerce.channel_pass.gen1"], "instruction_hint": "Owner: bind one Telegram channel the project bot can invite into and later remove from.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["shop.products.upsert", "scheduler.create_task", "shop.enablement.status"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.channel_pass.binding.get", "commerce.channel_pass.sweep", "shop.products.upsert", "scheduler.create_task", "shop.enablement.status"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_channel_pass_configure", "scheduler_create_task_example": {"cron": "15 * * * *", "enabled": true, "name": "channel_pass_sweep", "payload": {"action": "commerce.channel_pass.sweep", "project_id": "<context.project_id>"}}, "semantic_input_mode": "inherit_workflow", "summary": "Bind a Telegram channel for paid access: invite link after pay, ban when the pass expires.", "title": "Commerce Channel Pass Configure", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Owner: bind one Telegram channel the project bot can invite into and later remove from.", "write_mode": null}, {"action": "commerce.ai.generate_products", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "heavy_llm", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.ai.generate_products", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Ai Generate Products"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "heavy", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Dry-run catalog SKUs before assets.create — not a store publish.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_ai_generate_products", "semantic_input_mode": "inherit_workflow", "summary": "Dry-run AI product generation — returns wizard answer dicts only. Mirrors POST /api/commerce/ai/generate-products.", "title": "Commerce Ai Generate Products", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id + prompt constraints from assets.list", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rate_limited": "Backoff — tier limits via buffs.get_effective_limits", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run catalog SKUs before assets.create — not a store publish.", "write_mode": null}, {"action": "commerce.ai.magic_fill", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "heavy_llm", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.ai.magic_fill", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Ai Magic Fill"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "heavy", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Parse listing copy into assets wizard answers — pair with assets.create.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_ai_magic_fill", "semantic_input_mode": "inherit_workflow", "summary": "Parse text into product wizard answers. Mirrors POST /api/commerce/ai/magic-fill.", "title": "Commerce Ai Magic Fill", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Plan tier — buffs.get_effective_limits", "invalid_parameters": "asset id or draft row from assets.create", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Parse listing copy into assets wizard answers — pair with assets.create.", "write_mode": null}, {"action": "commerce.coupon.list", "aliases": ["commerce.list_coupons"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.coupon.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Coupon List"}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "List project-scoped promo codes from 8DNA commerce.coupon_registry. Mirrors GET /api/commerce/merch…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_coupon_list", "semantic_input_mode": "inherit_workflow", "summary": "List project-scoped promo codes from 8DNA commerce.coupon_registry. Mirrors GET /api/commerce/merchant/coupons.", "title": "Commerce Coupon List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List project-scoped promo codes from 8DNA commerce.coupon_registry. Mirrors GET /api/commerce/merchant/coupons.", "write_mode": null}, {"action": "commerce.coupon.create", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.coupon.create", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Coupon Create"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Create discount coupon for checkout — not Stripe SDK.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commerce_coupon_create", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a shop promo code (percent or fixed USDT off). Optional listing_uuids scopes the code to specific listings. Mirrors POST /api/commerce/merchant/coupons.", "title": "Commerce Coupon Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create discount coupon for checkout — not Stripe SDK.", "write_mode": null}, {"action": "commerce.coupon.update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.coupon.update", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Coupon Update"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Update a project promo code. Mirrors PUT /api/commerce/merchant/coupons/{code}.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commerce_coupon_update", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Update a project promo code. Mirrors PUT /api/commerce/merchant/coupons/{code}.", "title": "Commerce Coupon Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update a project promo code. Mirrors PUT /api/commerce/merchant/coupons/{code}.", "write_mode": null}, {"action": "commerce.coupon.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.coupon.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Coupon Delete"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Delete a project promo code. Mirrors DELETE /api/commerce/merchant/coupons/{code}.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": true, "risk_class": "destructive", "safe_action": "commerce_coupon_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete a project promo code. Mirrors DELETE /api/commerce/merchant/coupons/{code}.", "title": "Commerce Coupon Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete a project promo code. Mirrors DELETE /api/commerce/merchant/coupons/{code}.", "write_mode": null}, {"action": "commerce.participant.grant_holding", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.participant.grant_holding", "mutation_risk": "low", "related_tools": ["assets.list", "buffs.grant_tenant_subscription", "commerce.sell.activate"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Participant Grant Holding"}, "doc_audience": "operator", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Tenant operator grants digital goods / inventory to a buyer or member user.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["assets.list", "buffs.grant_tenant_subscription", "commerce.sell.activate"], "required_cap": "assets_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commerce_participant_grant_holding", "semantic_input_mode": "inherit_workflow", "summary": "Grant catalog asset holdings to an end user in your tenant project.", "title": "Commerce Participant Grant Holding", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — operator session required", "grant_failed": "assets.list — confirm asset_id; buffs path for subscription SKUs", "insufficient_permissions": "require_tenant_project_write — project admin on tenant PID", "invalid_project": "Bind context.project_id or pass project_id (>1 tenant PID)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Tenant operator grants digital goods / inventory to a buyer or member user.", "write_mode": null}, {"action": "commerce.refund.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.refund.status", "related_tools": ["payments.get", "commerce.refund.psp_refund", "commerce.refund.manual_complete", "commerce.refund.manual_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Refund Status"}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "After commerce order refund request. Wallet rail finishes in refund_compensation. Fiat rail: paymen…", "kind": "mcp_domain", "mutation_kind": "none", "navigation": ["commerce.refund.status", "payments.get", "commerce.refund.psp_refund", "payments.refund", "commerce.refund.manual_complete"], "next_actions": ["payments.get", "commerce.refund.psp_refund"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "receipt_rule": "Fiat rail: payments.get until wallet_credit=ok before PSP refund; then manual_complete with external_refund_id.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["payments.get", "commerce.refund.psp_refund", "commerce.refund.manual_complete", "commerce.refund.manual_list"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "safe_action": "commerce_refund_status", "semantic_input_mode": "inherit_workflow", "summary": "Poll refund request + compensation for an order. Mirrors GET /api/commerce/orders/{order_id}/refund-request.", "title": "Commerce Refund Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem_owner_required for manual refund plane", "invalid_parameters": "buyer_project_id, buyer_user_id, order_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "commerce.refund.status with buyer_project_id, buyer_user_id, order_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After commerce order refund request. Wallet rail finishes in refund_compensation. Fiat rail: payments.get until wallet_credit=ok, then commerce.refund.psp_refund or payments.refund, then commerce.refu", "write_mode": null}, {"action": "commerce.refund.manual_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.refund.manual_list", "related_tools": ["commerce.refund.status", "commerce.refund.manual_complete"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Refund Manual List"}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Ecosystem admin: list refund_requested orders awaiting manual compensation for a buyer commerce sli…", "kind": "mcp_domain", "mutation_kind": "none", "navigation": ["commerce.refund.status", "payments.get", "commerce.refund.psp_refund", "payments.refund", "commerce.refund.manual_complete"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "receipt_rule": "Fiat rail: payments.get until wallet_credit=ok before PSP refund; then manual_complete with external_refund_id.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.refund.status", "commerce.refund.manual_complete"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "safe_action": "commerce_refund_manual_list", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem admin: list refund_requested orders awaiting manual compensation for a buyer commerce slice. Mirrors GET /api/admin/commerce/manual-refunds.", "title": "Commerce Refund Manual List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Finances / ecosystem owner session — not tenant buyer", "forbidden": "auth.get_profile then ecosystem admin role", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem admin: list refund_requested orders awaiting manual compensation for a buyer commerce slice. Mirrors GET /api/admin/commerce/manual-refunds.", "write_mode": null}, {"action": "commerce.refund.psp_refund", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.refund.psp_refund", "related_tools": ["commerce.refund.status", "payments.get", "payments.refund", "commerce.refund.manual_complete"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Refund Psp Refund"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "After commerce.refund.status shows payments_fiat + payment_id. Requires payments.get wallet_credit=…", "kind": "mcp_domain", "mutation_kind": "none", "navigation": ["commerce.refund.status", "payments.get", "commerce.refund.psp_refund", "payments.refund", "commerce.refund.manual_complete"], "next_actions": ["commerce.refund.manual_complete"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "receipt_rule": "Fiat rail: payments.get until wallet_credit=ok before PSP refund; then manual_complete with external_refund_id.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.refund.status", "payments.get", "payments.refund", "commerce.refund.manual_complete"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "safe_action": "commerce_refund_psp_refund", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem admin: run payments.refund for order.metadata.payment_id on payments_fiat rail (seller claw + Stripe/Tochka). Call before commerce.refund.manual_complete.", "title": "Commerce Refund Psp Refund", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Finances / ecosystem owner — seller claw + PSP", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_payment_id": "Order metadata.payment_id missing — payments.get from checkout receipt", "order_not_found": "commerce.refund.status — verify buyer_project_id, buyer_user_id, order_id", "rail_not_fiat": "Wallet rail auto-compensates — no PSP step", "refund_exceeds_capture": "Partial amount must be ≤ captured major units", "refund_in_progress": "Retry with same idempotency_key or poll payments.get", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After commerce.refund.status shows payments_fiat + payment_id. Requires payments.get wallet_credit=ok. Then commerce.refund.manual_complete with external_refund_id.", "write_mode": null}, {"action": "commerce.refund.manual_complete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.refund.manual_complete", "related_tools": ["commerce.refund.status", "commerce.refund.psp_refund", "payments.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Refund Manual Complete"}, "do_not_use_when": "After PSP/claw — not before commerce.refund.psp_refund or external PSP refund.", "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "example_params": {"buyer_project_id": 123, "buyer_user_id": 123, "external_refund_id": "example_string", "order_id": "example_string"}, "example_request": {"action": "commerce.refund.manual_complete", "params": {"buyer_project_id": 123, "buyer_user_id": 123, "external_refund_id": "example_string", "order_id": "example_string"}}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "After fiat money moved: commerce.refund.psp_refund or external PSP, then pass external_refund_id.", "kind": "mcp_domain", "mutation_kind": "none", "navigation": ["commerce.refund.status", "payments.get", "commerce.refund.psp_refund", "payments.refund", "commerce.refund.manual_complete"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "receipt_rule": "Fiat rail: payments.get until wallet_credit=ok before PSP refund; then manual_complete with external_refund_id.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.refund.status", "commerce.refund.psp_refund", "payments.get"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "rollback": [], "safe_action": "commerce_refund_manual_complete", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem admin: mark fiat/manual refund compensated — revoke entitlements, set order refunded. Mirrors POST /api/admin/commerce/manual-refunds/complete.", "title": "Commerce Refund Manual Complete", "verification": ["commerce.refund.status", "commerce.refund.manual_list"], "verify": [{"action": "commerce.refund.status", "predicate": "named resource is visible"}, {"action": "commerce.refund.manual_list", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Same as manual_list — operator refund completion", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "commerce.refund.manual_list row id", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "After PSP/claw — not before commerce.refund.psp_refund or external PSP refund.", "when_to_use": "After fiat money moved: commerce.refund.psp_refund or external PSP, then pass external_refund_id.", "write_mode": null}, {"action": "commerce.storefront.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.commerce.gen1"], "id": "commerce.storefront.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront List"}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Browse ECS listings before commerce.sell.activate or buyer checkout.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_storefront_list", "semantic_input_mode": "inherit_workflow", "summary": "List storefront listings via StorefrontReadFacade (ECS organelle). Mirrors GET /api/commerce/storefront/listings. Guest global marketplace: scope=global, type=auction, sort=ending. Filters: status=act", "title": "Commerce Storefront List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project read + commerce caps", "invalid_parameters": "project_id required — catalog before seed_apply", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Browse ECS listings before commerce.sell.activate or buyer checkout.", "write_mode": null}, {"action": "commerce.storefront.health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.commerce.gen1"], "id": "commerce.storefront.health", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Health"}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Storefront index + ECS organelle health (admin diagnostics slice).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_storefront_health", "semantic_input_mode": "inherit_workflow", "summary": "Storefront index + ECS organelle health (admin diagnostics slice).", "title": "Commerce Storefront Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Storefront index + ECS organelle health (admin diagnostics slice).", "write_mode": null}, {"action": "commerce.reconcile", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.reconcile", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Reconcile"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Ops escrow reconciliation (ecosystem owner).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": true, "risk_class": "destructive", "safe_action": "commerce_reconcile", "semantic_input_mode": "inherit_workflow", "summary": "Ops: find marketplace deals stuck after confirm without transfer. Example: {\"dry_run\": true, \"project_id\": 1}", "title": "Commerce Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner — finances PID plane", "invalid_parameters": "date range + project scope", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops escrow reconciliation (ecosystem owner).", "write_mode": null}, {"action": "commerce.checkout.session", "ai_tips": "Start marketplace checkout. Does not confirm or move money. Wallet confirm is finance.pay.execute. Card confirm is payments.create, then poll payments.get until wallet_credit=ok (personal wallet on project 1 or treasury).", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.checkout.session", "mutation_risk": "low", "related_tools": ["finance.pay.execute", "payments.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Checkout Session"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Start marketplace checkout. Does not confirm or move money. Wallet confirm is finance.pay.execute. …", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["finance.pay.execute", "payments.create"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commerce_checkout_session", "semantic_input_mode": "inherit_workflow", "summary": "Create a marketplace checkout session. Real money is not moved here. Confirm a wallet quote with finance.pay.execute. Card capture uses payments.create. Credits land on L0 project 1 or L2 treasury, ne", "title": "Commerce Checkout Session", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; finance.pay.execute confirms wallet rail after session create", "idempotency_mismatch": "Same idempotency_key with different listing — use a new key per listing", "invalid_parameters": "listing_uuid required; buyer_project_id defaults to context.project_id", "invalid_price": "Listing price ≤ 0 — seller must fix asset/listing price before checkout", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "listing_not_active": "Seller delisted SKU — pick another listing_uuid from storefront browse", "listing_not_found": "assets.list or storefront index — listing_uuid must be live marketplace row", "marketplace_unavailable": "Marketplace index offline — retry; agentstack_diagnose if persistent", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Buyer checkout — not commerce.sell.activate; widen payments cap on API key", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "showcase_guest_checkout_disabled": "auth.login — showcase seller blocks anonymous marketplace checkout", "unauthorized": "auth.get_profile — marketplace checkout requires signed-in buyer", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Start marketplace checkout. Does not confirm or move money. Wallet confirm is finance.pay.execute. Card confirm is payments.create, then poll payments.get until wallet_credit=ok (personal wallet on pr", "write_mode": null}, {"action": "commerce.sell.activate", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.sell.gen1"], "id": "commerce.sell.activate", "mutation_risk": "high", "related_tools": ["commerce.storefront.seed_apply", "payments.create", "assets.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Commerce Sell Activate"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"ai_prompt": "example_string", "bucket_name": "example_string", "idempotency_key": "example_string", "products": [], "project_id": 123, "publish_hosted": true, "storefront_public": true, "track": "example_string", "use_ai": true, "use_starter": true, "user_id": 123}, "example_request": {"action": "commerce.sell.activate", "params": {"ai_prompt": "example_string", "bucket_name": "example_string", "idempotency_key": "example_string", "products": [], "project_id": 123, "publish_hosted": true, "storefront_public": true, "track": "example_string", "use_ai": true, "use_starter": true, "user_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "First shop: earnings wallet, product seed, public storefront, optional /s/ publish. user_id is requ…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Paid tenant SKU: webhook/C24 auto-grant — not buffs.apply_buff after payments.create.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.storefront.seed_apply", "payments.create", "assets.create"], "required_cap": "payments|project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "commerce_sell_activate", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "One-shot seller activation: earnings wallet, product seed, public policy, storefront index upsert, optional hosted vitrine. Mirrors POST /api/commerce/sell/activate.", "title": "Commerce Sell Activate", "tool_chains": ["payment_to_subscription", "trial_to_paid_tier"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Tenant operator — commerce.sell.activate vs buffs.grant; buyers use commerce.checkout.session", "idempotency_mismatch": "Same idempotency_key with a different product set or publish flag — mint a new key", "invalid_parameters": "SKU / activation payload from storefront list", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Project write + commerce cap — not buyer marketplace checkout session", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "First shop: earnings wallet, product seed, public storefront, optional /s/ publish. user_id is required. Later products use commerce.storefront.seed_plan, not a second activate.", "write_mode": null}, {"action": "commerce.storefront.seed_plan", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.seed_plan", "related_tools": ["commerce.storefront.seed_apply", "commerce.storefront.seed_undo"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Seed Plan"}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Preview assets and listings before seed_apply. Pass specs[] and/or pack_id. seed_apply takes the re…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.storefront.seed_apply", "commerce.storefront.seed_undo"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_storefront_seed_plan", "semantic_input_mode": "inherit_workflow", "summary": "Dry-run Storefront Studio seed — compose asset/listing drafts and guidance hints. Mirrors POST /api/commerce/storefront/seed/plan.", "title": "Commerce Storefront Seed Plan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Preview assets and listings before seed_apply. Pass specs[] and/or pack_id. seed_apply takes the returned plan, not pack_id.", "write_mode": null}, {"action": "commerce.storefront.seed_apply", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.seed_apply", "mutation_risk": "low", "related_tools": ["commerce.storefront.hosted_publish", "commerce.storefront.hosted_manifest"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Seed Apply"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Write the plan from seed_plan: asset upsert, listing, storefront index. Pass params.plan from the p…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.storefront.hosted_publish", "commerce.storefront.hosted_manifest"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commerce_storefront_seed_apply", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Apply a Storefront Studio seed plan (asset upsert → listing → index). Mirrors POST /api/commerce/storefront/seed/apply.", "title": "Commerce Storefront Seed Apply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Write the plan from seed_plan: asset upsert, listing, storefront index. Pass params.plan from the previous step. Undo with seed_undo and run_id.", "write_mode": null}, {"action": "commerce.storefront.seed_undo", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.seed_undo", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Seed Undo"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Undo a prior seed run — cancel listings and remove from storefront index. Mirrors POST /api/commerc…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commerce_storefront_seed_undo", "semantic_input_mode": "inherit_workflow", "summary": "Undo a prior seed run — cancel listings and remove from storefront index. Mirrors POST /api/commerce/storefront/seed/undo.", "title": "Commerce Storefront Seed Undo", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Undo a prior seed run — cancel listings and remove from storefront index. Mirrors POST /api/commerce/storefront/seed/undo.", "write_mode": null}, {"action": "commerce.storefront.seed_ingest", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.seed_ingest", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Seed Ingest"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Parse bulk source (csv/json/ai_batch/magic/clone) into ProductSpec rows. Mirrors POST /api/commerce…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commerce_storefront_seed_ingest", "semantic_input_mode": "inherit_workflow", "summary": "Parse bulk source (csv/json/ai_batch/magic/clone) into ProductSpec rows. Mirrors POST /api/commerce/storefront/seed/ingest.", "title": "Commerce Storefront Seed Ingest", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Parse bulk source (csv/json/ai_batch/magic/clone) into ProductSpec rows. Mirrors POST /api/commerce/storefront/seed/ingest.", "write_mode": null}, {"action": "commerce.storefront.one_click_fill", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.one_click_fill", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront One Click Fill"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Catalog assets exist but have no active listing. Creates listings only — does not invent new produc…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "commerce_storefront_one_click_fill", "semantic_input_mode": "inherit_workflow", "summary": "Create listings for eligible catalog assets without active listings. Mirrors POST /api/commerce/storefront/seed/one-click-fill.", "title": "Commerce Storefront One Click Fill", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Catalog assets exist but have no active listing. Creates listings only — does not invent new products.", "write_mode": null}, {"action": "commerce.storefront.hosted_manifest", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.hosted_manifest", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Hosted Manifest"}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Read hosted vitrine manifest (bucket, hosted_dirty, merchandising). Mirrors GET /api/commerce/store…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "commerce_storefront_hosted_manifest", "semantic_input_mode": "inherit_workflow", "summary": "Read hosted vitrine manifest (bucket, hosted_dirty, merchandising). Mirrors GET /api/commerce/storefront/hosted/manifest.", "title": "Commerce Storefront Hosted Manifest", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read hosted vitrine manifest (bucket, hosted_dirty, merchandising). Mirrors GET /api/commerce/storefront/hosted/manifest.", "write_mode": null}, {"action": "commerce.storefront.hosted_publish", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.hosted_publish", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Commerce Storefront Hosted Publish"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Publish hosted /s/ vitrine from storefront index.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Catalog: assets.list. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "plane_chooser": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": true, "risk_class": "production_publish", "safe_action": "commerce_storefront_hosted_publish", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Publish hosted vitrine static bundle + tenant boot JSON when dist is on server. Mirrors POST /api/commerce/storefront/hosted/publish.", "title": "Commerce Storefront Hosted Publish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "user_id + project_id — build dist before publish", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "publish_failed": "commerce.storefront.health — bucket + hosted manifest", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Publish hosted /s/ vitrine from storefront index.", "write_mode": null}], "commerce_rest": [{"action": "rest.marketplace.create_listing", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.storefront.seed_plan", "path": "POST /api/marketplace/listings", "related_tools": ["commerce.storefront.seed_plan", "preflight.check"], "safe_action": "rest_marketplace_create_listing", "summary": "Create listing (types: sale, buy, exchange, auction). Not an MCP action.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.marketplace.list_listings", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.storefront.list", "path": "GET /api/marketplace/listings", "related_tools": ["commerce.storefront.list", "preflight.check"], "safe_action": "rest_marketplace_list_listings", "summary": "List marketplace listings with filters.", "surface": "rest", "when_blocked": {"insufficient_permissions": "Project membership or cap required for seller catalog", "invalid_parameters": "Listing filters must match commerce.storefront.list params", "unauthorized": "Authenticate before marketplace browse REST"}}, {"action": "rest.marketplace.place_bid", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/marketplace/listings/{listing_id}/bids", "safe_action": "rest_marketplace_place_bid", "summary": "Place bid on auction listing. Body: amount, currency (USD→USDT), optional expected_revision. Header Idempotency-Key (scoped; mismatch 409). X-Project-ID via resolve_commerce_project_id for wallet lane", "surface": "rest"}, {"action": "rest.marketplace.list_bids", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/marketplace/listings/{listing_id}/bids", "safe_action": "rest_marketplace_list_bids", "summary": "Public bid ladder (bidder_label only). 404 when listing missing (not empty ladder).", "surface": "rest"}, {"action": "rest.commerce.storefront.list_global", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.storefront.list", "path": "GET /api/commerce/storefront/listings?scope=global", "related_tools": ["commerce.storefront.list", "preflight.check"], "safe_action": "rest_commerce_storefront_list_global", "summary": "Guest marketplace browse (TG 1810). Filters: project_id=seller, type, search, sort=ending. Prefer over GET /api/marketplace/listings for catalog.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.marketplace.accept_listing", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "finance.pay.execute", "path": "POST /api/marketplace/listings/{listing_id}/accept", "related_tools": ["finance.pay.execute", "preflight.check"], "safe_action": "rest_marketplace_accept_listing", "summary": "Accept deal / settle listing. X-Project-ID for buyer_project_id. 409 listing_has_active_deal for other buyer; same buyer 200 resumed. Terminal executed/cancelled deals allow re-accept.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.marketplace.close_auction", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/marketplace/listings/{listing_id}/close-auction", "safe_action": "rest_marketplace_close_auction", "summary": "Seller or worker closes auction after ends_at. Bridges winning bid lock into deal escrow, confirms, execute_deal. REST-only (no MCP parity).", "surface": "rest"}, {"action": "rest.commerce.scheduler.close_expired_auctions", "domain": "commerce_rest", "mcp_executable": false, "path": "scheduler action commerce.close_expired_auctions", "safe_action": "rest_commerce_scheduler_close_expired_auctions", "summary": "Worker batch: scan global auction index, authoritative DNA ends_at check, close_auction. Interval COMMERCE_CLOSE_AUCTIONS_INTERVAL_S (default 300s).", "surface": "rest"}, {"action": "rest.commerce.merchant.dashboard", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.sell.activate", "path": "GET /api/commerce/merchant/dashboard", "related_tools": ["commerce.sell.activate", "preflight.check"], "safe_action": "rest_commerce_merchant_dashboard", "summary": "Seller Command Center KPIs and recommended actions.", "surface": "rest", "when_blocked": {"forbidden": "Tenant operator — commerce.sell.activate vs buffs.grant; buyers use commerce.checkout.session", "invalid_parameters": "SKU / activation payload from storefront list", "service_cap_denied": "Project write + commerce cap — not buyer marketplace checkout session"}}, {"action": "rest.commerce.merchant.list_listings", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.storefront.list", "path": "GET /api/commerce/merchant/listings", "related_tools": ["commerce.storefront.list", "preflight.check"], "safe_action": "rest_commerce_merchant_list_listings", "summary": "Admin listings table for seller project (all statuses).", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller PID", "service_cap_denied": "Project write + payments cap for merchant admin BFF", "unauthorized": "Seller operator session — auth.get_profile before merchant REST"}}, {"action": "rest.commerce.merchant.incoming_orders", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.sell.activate", "path": "GET /api/commerce/merchant/orders-incoming", "related_tools": ["commerce.sell.activate", "preflight.check"], "safe_action": "rest_commerce_merchant_incoming_orders", "summary": "Incoming sales for seller project.", "surface": "rest", "when_blocked": {"forbidden": "Tenant operator — commerce.sell.activate vs buffs.grant; buyers use commerce.checkout.session", "invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.merchant.update_listing", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "assets.update", "path": "PUT /api/commerce/merchant/listings/{listing_uuid}", "related_tools": ["assets.update", "preflight.check"], "safe_action": "rest_commerce_merchant_update_listing", "summary": "Update listing status or price (seller admin).", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.merchant.sync_price", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "assets.update", "path": "POST /api/commerce/merchant/listings/{listing_uuid}/sync-price", "related_tools": ["assets.update", "preflight.check"], "safe_action": "rest_commerce_merchant_sync_price", "summary": "Sync listing price from catalog asset.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.merchant.reindex", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "assets.reindex", "path": "POST /api/commerce/merchant/listings/{listing_uuid}/reindex", "related_tools": ["assets.reindex", "preflight.check"], "safe_action": "rest_commerce_merchant_reindex", "summary": "Rebuild shop index row for one listing.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.merchant.bulk_sync_prices", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "assets.bulk_update", "path": "POST /api/commerce/merchant/listings/bulk-sync-prices", "related_tools": ["assets.bulk_update", "preflight.check"], "safe_action": "rest_commerce_merchant_bulk_sync_prices", "summary": "Sync all stale listing prices for project.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.merchant.bulk_deactivate", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "assets.bulk_update", "path": "POST /api/commerce/merchant/listings/bulk-deactivate", "related_tools": ["assets.bulk_update", "preflight.check"], "safe_action": "rest_commerce_merchant_bulk_deactivate", "summary": "Deactivate multiple listings.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.guidance.checklist", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/commerce/guidance/checklist", "safe_action": "rest_commerce_guidance_checklist", "summary": "Operator shop setup checklist (catalog + shelf).", "surface": "rest"}, {"action": "rest.commerce.guidance.catalog_hints", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/commerce/guidance/catalog-hints", "safe_action": "rest_commerce_guidance_catalog_hints", "summary": "Per-asset listing eligibility and stale price hints.", "surface": "rest"}, {"action": "rest.commerce.guidance.listing_draft", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/commerce/guidance/listing-draft", "safe_action": "rest_commerce_guidance_listing_draft", "summary": "Suggested listing draft defaults for one asset.", "surface": "rest"}, {"action": "rest.commerce.participant.holdings", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/commerce/participant/holdings", "safe_action": "rest_commerce_participant_holdings", "summary": "User holdings in a project (participant plane, not catalog).", "surface": "rest"}, {"action": "rest.commerce.participant.grant_holding", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/commerce/participant/grant-holding", "safe_action": "rest_commerce_participant_grant_holding", "summary": "Operator grant inventory to project member (requires write).", "surface": "rest"}, {"action": "rest.commerce.merchant.featured", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.storefront.list", "path": "GET|PUT /api/commerce/merchant/featured", "related_tools": ["commerce.storefront.list", "preflight.check"], "safe_action": "rest_commerce_merchant_featured", "summary": "Project featured listing UUIDs in 8DNA storefront config.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.merchant.coupons", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.coupon.list", "path": "GET|POST /api/commerce/merchant/coupons", "related_tools": ["commerce.coupon.list", "preflight.check"], "safe_action": "rest_commerce_merchant_coupons", "summary": "List or create project promo codes (8DNA commerce.coupon_registry).", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.merchant.coupon_by_code", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "commerce.coupon.update", "path": "PUT|DELETE /api/commerce/merchant/coupons/{code}", "related_tools": ["commerce.coupon.update", "preflight.check"], "safe_action": "rest_commerce_merchant_coupon_by_code", "summary": "Update or delete a project promo code.", "surface": "rest", "when_blocked": {"invalid_parameters": "Bind context.project_id to seller project", "service_cap_denied": "Widen payments/project write caps on API key or OAuth reconnect", "unauthorized": "Operator session — auth.get_profile before merchant REST BFF"}}, {"action": "rest.commerce.cart.apply_coupon", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/commerce/cart/apply-coupon", "safe_action": "rest_commerce_cart_apply_coupon", "summary": "Apply or clear coupon on authenticated cart (listing scope enforced).", "surface": "rest"}, {"action": "rest.commerce.cart.checkout", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/commerce/cart/checkout", "safe_action": "rest_commerce_cart_checkout", "summary": "Create checkout session from cart (wallet_internal or payments_fiat rail).", "surface": "rest"}, {"action": "rest.commerce.my_purchases", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/commerce/my-purchases", "safe_action": "rest_commerce_my_purchases", "summary": "Buyer purchases BFF — orders merged with active entitlements and delivery URLs.", "surface": "rest"}, {"action": "rest.commerce.delivery.refresh", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/commerce/delivery/refresh", "safe_action": "rest_commerce_delivery_refresh", "summary": "Re-issue signed delivery download token for a fulfilled order line.", "surface": "rest"}, {"action": "rest.commerce.orders.refund_request", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/commerce/orders/refund-request", "safe_action": "rest_commerce_orders_refund_request", "summary": "Request refund; wallet rail auto-compensates USDT. Fiat (payments_fiat) skips wallet credit — manual ops via admin manual-refunds.", "surface": "rest"}, {"action": "rest.commerce.orders.refund_status", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/commerce/orders/{order_id}/refund-request", "safe_action": "rest_commerce_orders_refund_status", "summary": "Poll refund request status and compensation snapshot for an order.", "surface": "rest"}, {"action": "rest.commerce.events.refund_stream", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/commerce/events/refund-stream", "safe_action": "rest_commerce_events_refund_stream", "summary": "SSE stream for refund lifecycle (commerce.refund.updated) — buyer/merchant cache refresh.", "surface": "rest"}, {"action": "rest.admin.commerce.refund_sse_health", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/admin/commerce/refund-sse-health", "safe_action": "rest_admin_commerce_refund_sse_health", "summary": "Ops: in-process refund SSE subscriber counts on this worker (connection_count, pg_bus_enabled).", "surface": "rest"}, {"action": "rest.admin.commerce.metrics_scrape", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/admin/commerce/metrics/scrape", "safe_action": "rest_admin_commerce_metrics_scrape", "summary": "Prometheus scrape for commerce funnel gauges (header X-Metrics-Token, env COMMERCE_METRICS_SCRAPE_TOKEN).", "surface": "rest"}, {"action": "rest.admin.commerce.settlement_funnel", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/admin/commerce/settlement-funnel", "safe_action": "rest_admin_commerce_settlement_funnel", "summary": "Ops: stuck escrow scan + checkout funnel OpTrace + refund_sse_health snapshot.", "surface": "rest"}, {"action": "rest.exchange.quote", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/exchange/quote", "safe_action": "rest_exchange_quote", "summary": "Cross-project exchange quote (not protein command_type exchange).", "surface": "rest"}, {"action": "rest.exchange.execute", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/exchange/execute", "safe_action": "rest_exchange_execute", "summary": "Execute cross-project currency/asset exchange.", "surface": "rest"}, {"action": "rest.commerce.checkout.create_session", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/commerce/checkout/sessions", "safe_action": "rest_commerce_checkout_create_session", "summary": "Create checkout session for listing or cart lines. Send Idempotency-Key header for safe retries.", "surface": "rest"}, {"action": "rest.commerce.checkout.confirm_session", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/commerce/checkout/sessions/{session_id}/confirm", "safe_action": "rest_commerce_checkout_confirm_session", "summary": "Confirm checkout session (wallet_internal or payments_fiat rail). 402 insufficient_balance, 409 partial_failure — use Idempotency-Key.", "surface": "rest"}, {"action": "rest.commerce.checkout.get_session", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/commerce/checkout/sessions/{session_id}", "safe_action": "rest_commerce_checkout_get_session", "summary": "Poll checkout session status until completed/failed/expired.", "surface": "rest"}, {"action": "rest.admin.commerce.manual_refunds_list", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/admin/commerce/manual-refunds", "safe_action": "rest_admin_commerce_manual_refunds_list", "summary": "Ops: list refund_requested orders awaiting manual compensation for a buyer slice.", "surface": "rest"}, {"action": "rest.admin.commerce.manual_refunds_complete", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/admin/commerce/manual-refunds/complete", "safe_action": "rest_admin_commerce_manual_refunds_complete", "summary": "Ops: mark fiat/manual refund compensated — revoke entitlements, set order refunded.", "surface": "rest"}, {"action": "rest.commerce.reconcile_escrow", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/admin/commerce/reconcile-escrow?dry_run=true", "safe_action": "rest_commerce_reconcile_escrow", "summary": "Ops: find deals confirmed without completed transfer (nightly gate).", "surface": "rest"}, {"action": "rest.auth.hosted_app_session", "domain": "commerce_rest", "mcp_executable": false, "path": "POST /api/hosted-apps/{project_id}/session", "safe_action": "rest_auth_hosted_app_session", "summary": "Mint hosted_app cookie after REST login — required before /s/{project_id}/mcp (not operator Bearer).", "surface": "rest"}, {"action": "rest.projects.get_my_data", "domain": "commerce_rest", "mcp_executable": false, "path": "GET /api/projects/{project_id}/users/me/data", "safe_action": "rest_projects_get_my_data", "summary": "Member-private project data read (hosted cloud save; MCP projects.get_my_data).", "surface": "rest"}, {"action": "rest.commerce.iap.entitlements", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.entitlements.list", "path": "GET /api/commerce/iap/entitlements?project_id={project_id}&include_sandbox=true (operator; ignored on hosted_app cookie)", "related_tools": ["shop.entitlements.list", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_entitlements", "summary": "Buyer IAP entitlements for hosted /s/{pid}/ (parity shop.entitlements.list).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login", "forbidden": "Cross-user list requires project_admin", "include_sandbox_ignored_on_hosted": "Hosted plane returns live entitlements only — operator use include_sandbox=true", "project_scope_mismatch": "params.project_id must match hosted session project"}}, {"action": "rest.commerce.iap.enablement", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.enablement.status", "path": "GET /api/commerce/iap/enablement?project_id={project_id}", "related_tools": ["shop.enablement.status", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_enablement", "summary": "Visitor sell gate + blockers (parity shop.enablement.status; hosted cookie).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "catalog_auth_required": "Guest cannot read sell gate when iap_public_catalog=false.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.checkout_resume", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.orders.get", "path": "GET /api/commerce/iap/checkout/resume?project_id={project_id}&payment_id={payment_id}", "related_tools": ["shop.orders.get", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_checkout_resume", "summary": "Stripe Payment Element resume after ?iap_checkout=1 redirect (hosted cookie).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "order_not_found": "Resume only after shop.checkout.create — pass payment_id from redirect.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.products", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.products.list", "path": "GET /api/commerce/iap/products?project_id={project_id}", "related_tools": ["shop.products.list", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_products", "summary": "Visitor SKU catalog (parity shop.products.list).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "catalog_auth_required": "iap_public_catalog=false — sign in or enable public catalog.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "sell_disabled": "Owner sell gate off — shop.enablement.status before listing SKUs.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.checkout", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.checkout.create", "path": "POST /api/commerce/iap/checkout", "related_tools": ["shop.checkout.create", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_checkout", "summary": "Start hosted checkout (parity shop.checkout.create).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "client_amount_forbidden": "Never pass amount_minor — price comes from SKU server-side.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "sell_disabled": "Sell gate off — shop.enablement.status; fix blockers before checkout.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.order_cancel", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.orders.cancel", "path": "POST /api/commerce/iap/orders/{order_id}/cancel?project_id={project_id}", "related_tools": ["shop.orders.cancel", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_order_cancel", "summary": "Cancel buyer pending_payment order (parity shop.orders.cancel).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "order_not_cancelable": "Only pending_payment orders cancel; poll shop.orders.get first.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.balances", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "wallets.balance", "path": "GET /api/commerce/iap/balances?project_id={project_id}", "related_tools": ["wallets.balance", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_balances", "summary": "Player soft-currency balances (parity wallets.balance).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "forbidden_for_visitor": "Soft-currency balance requires player or operator session.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.order_get", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.orders.get", "path": "GET /api/commerce/iap/orders/{order_id}?project_id={project_id}", "related_tools": ["shop.orders.get", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_order_get", "summary": "Poll buyer order (parity shop.orders.get; hosted cookie).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "invalid_order_id": "Order id must be a UUID owned by the buyer cookie scope.", "order_not_found": "Unknown order — confirm id from shop.checkout.create response.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.payment_methods", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "payments.list_methods", "path": "GET /api/commerce/iap/payment-methods?project_id={project_id}", "related_tools": ["payments.list_methods", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_payment_methods", "summary": "Checkout payment methods (parity payments.list_methods).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.spend", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "wallets.spend", "path": "POST /api/commerce/iap/spend?project_id={project_id}", "related_tools": ["wallets.spend", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_spend", "summary": "Spend soft currency in-game (parity wallets.spend).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "insufficient_funds": "Top up via shop.checkout.create before wallets.spend parity.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.ledger", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "wallets.ledger.list", "path": "GET /api/commerce/iap/ledger?project_id={project_id}", "related_tools": ["wallets.ledger.list", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_ledger", "summary": "Wallet ledger tail (parity wallets.ledger.list).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.owner_orders", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.orders.list", "path": "GET /api/commerce/iap/owner/orders?project_id={project_id}&status={status}&attention_only=1", "related_tools": ["shop.orders.list", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_owner_orders", "summary": "Owner order tail; attention_only=1 filters grant_pending and metadata.fulfillment_phase=invites_pending plus fulfilled channel_pass invite gaps (parity shop.orders.list attention_only).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.buyer_orders", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.orders.list", "path": "GET /api/commerce/iap/orders?project_id={project_id}", "related_tools": ["shop.orders.list", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_buyer_orders", "summary": "Buyer purchase history (parity shop.orders.list hosted scope).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.owner_enablement", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.enablement.status", "path": "GET /api/commerce/iap/owner/enablement?project_id={project_id}", "related_tools": ["shop.enablement.status", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_owner_enablement", "summary": "Owner sell gate + blockers (parity shop.enablement.status; project read).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}, {"action": "rest.commerce.iap.public_session", "domain": "commerce_rest", "mcp_executable": false, "mcp_parity_action": "shop.orders.get", "path": "GET /api/commerce/iap/checkout/public-session?project_id={project_id}&payment_id={payment_id}", "related_tools": ["shop.orders.get", "rest.auth.hosted_app_session", "preflight.check"], "safe_action": "rest_commerce_iap_public_session", "summary": "Bot deep-link pay session without buyer cookie (parity shop.orders.get enrich; not payments.get).", "surface": "rest", "when_blocked": {"auth_required": "Mint hosted cookie (rest.auth.hosted_app_session) or SPA login before IAP REST.", "project_scope_mismatch": "Hosted cookie project_id must match route params.project_id.", "service_cap_denied": "Widen API key service caps or OAuth reconnect for commerce/wallets on this project."}}], "context": [{"action": "context.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "capability_descriptor": {"complexity": "simple", "domain": "context", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.fabric.context_provider.gen1"], "id": "context.get", "related_tools": ["rag.search", "context.resolve"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Context Get"}, "domain_title": "Context Resolve MCP domain", "effect": {"budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "conditional_mutate": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"memory_session_id": "example_string", "project_id": 123, "task": "example_string", "token_budget": 2000}, "example_request": {"action": "context.get", "params": {"memory_session_id": "example_string", "project_id": 123, "task": "example_string", "token_budget": 2000}}, "execution_class": "heavy", "genetic_tags": ["core.mcp.context_resolve.gen1"], "instruction_hint": "Prefetch grounded snippets before a reply or tool call that needs project knowledge.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.context_resolve", "owner_gene": "core.mcp.context_resolve.gen1", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_rag_memory_orchestrator"], "related_tools": ["rag.search", "context.resolve"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "context_get", "semantic_input_mode": "inherit_workflow", "summary": "Prefetch grounded snippets before a reply or tool call that needs project knowledge.", "title": "Context Get", "when_blocked": {"invalid_context_source": "context.get requested sources do not match source_status rows — check tools_context._parse_sources and ContextFabric gather (no silent RAG substitution for crm)."}, "when_to_use": "Prefetch grounded snippets before a reply or tool call that needs project knowledge.", "write_mode": null}, {"action": "context.resolve", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "context", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.context.gen1"], "id": "context.resolve", "related_tools": ["projects.get_projects", "auth.get_profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Context Resolve"}, "domain_title": "Context Resolve MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.context_resolve.gen1"], "instruction_hint": "After auth when context.project_id is missing or ambiguous.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.context_resolve", "owner_gene": "core.mcp.context_resolve.gen1", "plane_chooser": "One jti covers every project membership allows. mutation_allowed true: do not switch_project and do not log in again. A restart rehydrates that jti from 8DNA. A page at /s/{id}/ uses the hosted cookie, not this jti.", "related_prompts": ["agentstack_rag_memory_orchestrator"], "related_tools": ["projects.get_projects", "auth.get_profile"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "context_resolve", "semantic_input_mode": "inherit_workflow", "summary": "Resolve effective project_id for the session; surfaces ambiguous_project_context.", "title": "Context Resolve", "when_to_use": "After auth when context.project_id is missing or ambiguous.", "write_mode": null}, {"action": "context.hint_use_params_project_id", "aliases": ["context.set_project"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "context", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.context.gen1"], "id": "context.hint_use_params_project_id", "related_tools": ["context.resolve", "auth.switch_project", "projects.get_projects"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Context Hint Use Params Project Id"}, "domain_title": "Context Resolve MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.context_resolve.gen1"], "instruction_hint": "When an agent calls context.set_project or context.set (alias target).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.context_resolve", "owner_gene": "core.mcp.context_resolve.gen1", "plane_chooser": "One jti covers every project membership allows. mutation_allowed true: do not switch_project and do not log in again. A restart rehydrates that jti from 8DNA. A page at /s/{id}/ uses the hosted cookie, not this jti.", "related_prompts": ["agentstack_rag_memory_orchestrator"], "related_tools": ["context.resolve", "auth.switch_project", "projects.get_projects"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "context_hint_use_params_project_id", "semantic_input_mode": "inherit_workflow", "summary": "Instruction-only: there is no MCP context.set tool. Pass params.project_id on each execute step; bind context.project_id / X-Project-ID on the same jti when mutation_allowed is true — auth.switch_proj", "title": "Context Hint Use Params Project Id", "when_to_use": "When an agent calls context.set_project or context.set (alias target).", "write_mode": null}], "crm": [{"action": "crm.list_contacts", "aliases": ["crm.contacts.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.list_contacts", "related_tools": ["crm.upsert_contact", "crm.search", "crm.get_contact_360"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Crm List Contacts"}, "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"lifecycle": "example_string", "page": 123, "per_page": 123, "project_id": 123, "projection": "summary", "q": "example_string"}, "example_request": {"action": "crm.list_contacts", "params": {"lifecycle": "example_string", "page": 123, "per_page": 123, "project_id": 123, "projection": "summary", "q": "example_string"}}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "List/search before upsert, 360, or pipeline board.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "One CRM. An empty list after upsert is the sandbox head — crm.get_contact_360. Do not insert a second contact. crm.list_board readiness=pending follows next_actions. Do not create_deal. Do not promote.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.upsert_contact", "crm.search", "crm.get_contact_360"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_list_contacts", "semantic_input_mode": "inherit_workflow", "summary": "Default projection=summary rows are entity_id, kind, title, status, and updated_at. projection=full is the contact record.", "title": "List CRM Contacts", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "CRM cap or project membership denied", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "project_not_found": "Project does not exist or is not accessible", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List/search before upsert, 360, or pipeline board.", "write_mode": null}, {"action": "crm.submit_public_form", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.submit_public_form", "mutation_risk": "low", "related_tools": ["crm.upsert_contact", "crm.list_contacts"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Submit Public Form"}, "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Operator test of hosted form intake — public sites use REST form-intake; this upserts CRM.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.upsert_contact", "crm.list_contacts"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "safe_action": "crm_submit_public_form", "semantic_input_mode": "inherit_workflow", "summary": "Operator helper: submit a hosted-site lead (same shape as public form-intake REST).", "title": "Crm Submit Public Form", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_email": "Valid email required — same rules as public form-intake REST", "invalid_message": "message is required", "invalid_name": "name is required", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "message_too_long": "Shorten message to hosted form limit", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator test of hosted form intake — public sites use REST form-intake; this upserts CRM.", "write_mode": null}, {"action": "crm.upsert_contact", "aliases": ["crm.contacts.create"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.upsert_contact", "mutation_risk": "low", "related_tools": ["crm.list_contacts", "crm.search", "crm.create_deal", "crm.get_contact_360"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Crm Upsert Contact"}, "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"contact": {}, "project_id": 123}, "example_request": {"action": "crm.upsert_contact", "params": {"contact": {}, "project_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Create or update one contact — crm.list_contacts by email first.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_contacts", "crm.search", "crm.create_deal", "crm.get_contact_360"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "rollback": ["crm.erase_contact"], "safe_action": "crm_upsert_contact", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create or update a CRM contact (dedupe by email).", "title": "Create or Update Contact", "verification": ["crm.get_contact_360"], "verify": [{"action": "crm.get_contact_360", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "duplicate_contact": "crm.list_contacts by email — merge via crm.merge_contacts or set external_id on update", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create or update one contact — crm.list_contacts by email first.", "write_mode": null}, {"action": "crm.create_deal", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.create_deal", "mutation_risk": "low", "related_tools": ["crm.upsert_contact", "crm.move_deal_stage", "crm.list_board", "crm.get_deal_timeline"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Create Deal"}, "do_not_use_when": "List contacts for that email before creating a deal.", "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"deal": {}, "project_id": 123}, "example_request": {"action": "crm.create_deal", "params": {"deal": {}, "project_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "After contact exists — crm.list_board before crm.move_deal_stage.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.upsert_contact", "crm.move_deal_stage", "crm.list_board", "crm.get_deal_timeline"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "rollback": ["crm.delete_deal"], "safe_action": "crm_create_deal", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a CRM deal in the default pipeline.", "title": "Create CRM Deal", "verification": ["crm.list_board", "crm.get_deal_timeline"], "verify": [{"action": "crm.list_board", "predicate": "id"}, {"action": "crm.get_deal_timeline", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "List contacts for that email before creating a deal.", "when_to_use": "After contact exists — crm.list_board before crm.move_deal_stage.", "write_mode": null}, {"action": "crm.update_deal", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.update_deal", "mutation_risk": "low", "related_tools": ["crm.create_deal", "crm.delete_deal", "crm.move_deal_stage"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Update Deal"}, "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Edit deal fields from hosted vertical or CRM drawer.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.create_deal", "crm.delete_deal", "crm.move_deal_stage"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "safe_action": "crm_update_deal", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch a CRM deal (title, amount, due_at, stage_id, contact_ids, custom).", "title": "Crm Update Deal", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "deal_not_found": "crm.list_board — verify deal_id", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "pipeline_stage_locked": "crm.list_board + crm.get_crm_config — use crm.move_deal_stage for stage changes", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Edit deal fields from hosted vertical or CRM drawer.", "write_mode": null}, {"action": "crm.delete_deal", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.delete_deal", "mutation_risk": "high", "related_tools": ["crm.update_deal", "crm.list_board"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Delete Deal"}, "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Archive or cancel a project/deal from hosted vertical.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.update_deal", "crm.list_board"], "required_cap": "crm", "requires_preflight": true, "risk_class": "destructive", "safe_action": "crm_delete_deal", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Soft-delete (archive) a CRM deal.", "title": "Crm Delete Deal", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Archive or cancel a project/deal from hosted vertical.", "write_mode": null}, {"action": "crm.move_deal_stage", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.move_deal_stage", "related_tools": ["crm.list_board", "crm.get_deal_timeline", "crm.log_activity", "crm.get_crm_config"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Move Deal Stage"}, "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"deal_id": "example_string", "expected_rev": 123, "project_id": 123, "stage_id": "example_string"}, "example_request": {"action": "crm.move_deal_stage", "params": {"deal_id": "example_string", "expected_rev": 123, "project_id": 123, "stage_id": "example_string"}}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Kanban advance — crm.list_board projection=summary first.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_board", "crm.get_deal_timeline", "crm.log_activity", "crm.get_crm_config"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "crm_move_deal_stage", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Move a deal to another pipeline stage.", "title": "Crm Move Deal Stage", "verification": ["crm.list_board", "crm.get_deal_timeline"], "verify": [{"action": "crm.list_board", "predicate": "named resource is visible"}, {"action": "crm.get_deal_timeline", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "pipeline_stage_locked": "crm.list_board + crm.get_crm_config — verify stage_id before move", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Kanban advance — crm.list_board projection=summary first.", "write_mode": null}, {"action": "crm.log_activity", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.log_activity", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Log Activity"}, "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"activity": {}, "project_id": 123}, "example_request": {"action": "crm.log_activity", "params": {"activity": {}, "project_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Append timeline note/call/meeting on a contact or deal.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "crm_log_activity", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Log a CRM activity (note, call, task, etc.).", "title": "Crm Log Activity", "verification": ["crm.get_deal_timeline"], "verify": [{"action": "crm.get_deal_timeline", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "crm_write cap + project membership", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append timeline note/call/meeting on a contact or deal.", "write_mode": null}, {"action": "crm.search", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.search", "related_tools": ["crm.list_contacts", "crm.get_contact_360"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Search"}, "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Semantic or field search — prefer before upsert when deduping.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "One CRM. An empty list after upsert is the sandbox head — crm.get_contact_360. Do not insert a second contact. crm.list_board readiness=pending follows next_actions. Do not create_deal. Do not promote.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_contacts", "crm.get_contact_360"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_search", "semantic_input_mode": "inherit_workflow", "summary": "Search CRM contacts. Default projection=summary is the card (entity_id, kind, title, status, updated_at). projection=full is the hit record.", "title": "Crm Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Semantic or field search — prefer before upsert when deduping.", "write_mode": null}, {"action": "crm.create_company", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.create_company", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Create Company"}, "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Create org row before deals — crm.list_contacts optional link.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "safe_action": "crm_create_company", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a CRM company for a project.", "title": "Crm Create Company", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create org row before deals — crm.list_contacts optional link.", "write_mode": null}, {"action": "crm.list_companies", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.list_companies", "related_tools": ["crm.create_company", "crm.list_contacts"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm List Companies"}, "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "List companies before linking contacts or deals to an account.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.create_company", "crm.list_contacts"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_list_companies", "semantic_input_mode": "inherit_workflow", "summary": "Default projection=summary rows are entity_id, kind, title, status, and updated_at. projection=full is the company record.", "title": "Crm List Companies", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List companies before linking contacts or deals to an account.", "write_mode": null}, {"action": "crm.get_contact_360", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.get_contact_360", "related_tools": ["crm.list_contacts", "crm.upsert_contact", "crm.create_deal"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Get Contact 360"}, "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Read-after-write verify for upsert/import flows.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_contacts", "crm.upsert_contact", "crm.create_deal"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_get_contact_360", "semantic_input_mode": "inherit_workflow", "summary": "Contact 360 view: profile, deals, unified timeline.", "title": "Crm Get Contact 360", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-after-write verify for upsert/import flows.", "write_mode": null}, {"action": "crm.magic_fill", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.magic_fill", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Magic Fill"}, "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "AI field assist on an open record — upsert contact/deal first.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_magic_fill", "semantic_input_mode": "inherit_workflow", "summary": "AI/heuristic autofill for quick-create (dry-run, no write).", "title": "Crm Magic Fill", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "AI field assist on an open record — upsert contact/deal first.", "write_mode": null}, {"action": "crm.suggest_field", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.suggest_field", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Suggest Field"}, "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Single-field suggestion — prefer magic_fill for multi-field drafts.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_suggest_field", "semantic_input_mode": "inherit_workflow", "summary": "Suggest values for a CRM field from partial context.", "title": "Crm Suggest Field", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Single-field suggestion — prefer magic_fill for multi-field drafts.", "write_mode": null}, {"action": "crm.import_contacts", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.import_contacts", "mutation_risk": "low", "related_tools": ["crm.list_contacts", "crm.merge_contacts", "crm.get_contact_360"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Import Contacts"}, "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Bulk CSV import — prefer dry-run limits in UI; MCP for scripted ingest.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_contacts", "crm.merge_contacts", "crm.get_contact_360"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "safe_action": "crm_import_contacts", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Batch import CRM contacts with email dedupe.", "title": "Crm Import Contacts", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "import_blocked": "crm.list_contacts to preview dupes — shrink batch or crm.merge_contacts before retry", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk CSV import — prefer dry-run limits in UI; MCP for scripted ingest.", "write_mode": null}, {"action": "crm.export_contact", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.export_contact", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Export Contact"}, "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Portable export after upsert — not a substitute for list/search.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_export_contact", "semantic_input_mode": "inherit_workflow", "summary": "Export GDPR bundle for a CRM contact.", "title": "Crm Export Contact", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Portable export after upsert — not a substitute for list/search.", "write_mode": null}, {"action": "crm.erase_contact", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.erase_contact", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Erase Contact"}, "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "GDPR erase — crm.get_contact_360 to confirm id before erase.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": true, "risk_class": "destructive", "safe_action": "crm_erase_contact", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Anonymize/erase a CRM contact (GDPR).", "title": "Crm Erase Contact", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "GDPR erase — crm.get_contact_360 to confirm id before erase.", "write_mode": null}, {"action": "crm.list_board", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.list_board", "related_tools": ["crm.move_deal_stage", "crm.create_deal", "crm.get_deal_timeline"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm List Board"}, "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Pipeline snapshot before move_deal_stage or deal updates.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Board: crm.list_board. pending plus missing_deal_ids is a row this scope did not hydrate. effective_scope is the read. generation_meta is the batch head and can name another env. Do not create_deal. Do not promote. A board error is not a logout.", "plane_chooser": "One CRM. An empty list after upsert is the sandbox head — crm.get_contact_360. Do not insert a second contact. crm.list_board readiness=pending follows next_actions. Do not create_deal. Do not promote.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.move_deal_stage", "crm.create_deal", "crm.get_deal_timeline"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_list_board", "semantic_input_mode": "inherit_workflow", "summary": "Pipeline board. Default deals are cards: entity_id, title, status, updated_at. projection=full is the deal record. Stage columns stay.", "title": "View CRM Pipeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pipeline snapshot before move_deal_stage or deal updates.", "write_mode": null}, {"action": "crm.hub_snapshot", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.hub_snapshot", "related_tools": ["crm.list_board", "crm.list_contacts", "crm.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Hub Snapshot"}, "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Hub KPIs before opening full board or contact lists.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_board", "crm.list_contacts", "crm.search"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_hub_snapshot", "semantic_input_mode": "inherit_workflow", "summary": "CRM hub cold summary (deal/contact counts, pipeline hints) — index-only read. Same as REST GET /api/projects/{id}/crm/hub-snapshot.", "title": "Crm Hub Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hub KPIs before opening full board or contact lists.", "write_mode": null}, {"action": "crm.index.repair", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.index.repair", "related_tools": ["crm.list_board", "crm.hub_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Index Repair"}, "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Backfill CRM deal_cards denorm rows from by_stage + deal entities. Use after legacy imports — list_…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_board", "crm.hub_snapshot"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "safe_action": "crm_index_repair", "semantic_input_mode": "inherit_workflow", "summary": "Backfill CRM deal_cards denorm rows from by_stage + deal entities. Use after legacy imports — list_board no longer runs this on every read.", "title": "Crm Index Repair", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Backfill CRM deal_cards denorm rows from by_stage + deal entities. Use after legacy imports — list_board no longer runs this on every read.", "write_mode": null}, {"action": "crm.get_deal_timeline", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.get_deal_timeline", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Get Deal Timeline"}, "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Read-after-write verify for deal stage moves.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_get_deal_timeline", "semantic_input_mode": "inherit_workflow", "summary": "Activity timeline for a CRM deal (notes, tasks linked to deal_id).", "title": "Crm Get Deal Timeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-after-write verify for deal stage moves.", "write_mode": null}, {"action": "crm.get_crm_config", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.get_crm_config", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Get Crm Config"}, "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Pipeline stages and field map before move_deal_stage or magic_fill.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_get_crm_config", "semantic_input_mode": "inherit_workflow", "summary": "Project CRM config (saved_views, settings blob).", "title": "Crm Get Crm Config", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pipeline stages and field map before move_deal_stage or magic_fill.", "write_mode": null}, {"action": "crm.patch_crm_config", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.patch_crm_config", "mutation_risk": "low", "related_tools": ["crm.get_crm_config", "crm.list_board", "crm.magic_fill"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Patch Crm Config"}, "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Admin CRM settings — crm.get_crm_config first for if_match.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.get_crm_config", "crm.list_board", "crm.magic_fill"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "safe_action": "crm_patch_crm_config", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch project CRM config (writers may update saved_views only).", "title": "Crm Patch Crm Config", "when_blocked": {"config_conflict": "crm.get_crm_config — if_match revision mismatch", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin for CRM config patch", "invalid_parameters": "Required CRM params missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "crm.list_contacts or crm.list_board — verify entity id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Admin CRM settings — crm.get_crm_config first for if_match.", "write_mode": null}, {"action": "crm.merge_contacts", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.merge_contacts", "mutation_risk": "low", "related_tools": ["crm.list_contacts", "crm.upsert_contact", "crm.get_contact_360"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Merge Contacts"}, "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "After crm.list_contacts finds duplicate emails or external_ids.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_contacts", "crm.upsert_contact", "crm.get_contact_360"], "required_cap": "crm", "requires_preflight": true, "risk_class": "destructive", "safe_action": "crm_merge_contacts", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Merge duplicate contact into primary (absorb duplicate).", "title": "Crm Merge Contacts", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After crm.list_contacts finds duplicate emails or external_ids.", "write_mode": null}, {"action": "crm.get_custom_fields", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm_config", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.get_custom_fields", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Get Custom Fields"}, "domain_title": "CRM MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Read CRM custom field definitions before put_custom_fields or magic_fill on new keys.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "crm_get_custom_fields", "semantic_input_mode": "inherit_workflow", "summary": "Read CRM custom field definitions for a project.", "title": "Crm Get Custom Fields", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read CRM custom field definitions before put_custom_fields or magic_fill on new keys.", "write_mode": null}, {"action": "crm.put_custom_fields", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "crm_config", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.put_custom_fields", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Crm Put Custom Fields"}, "domain_title": "CRM MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Admin field map — crm.get_custom_fields first; crm.get_crm_config for pipeline context.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "owner_gene": "core.crm.hub.gen1", "plane": "Contacts: crm.list_contacts. Empty after promote is the sandbox head — crm.get_contact_360. Do not insert a second contact.", "plane_chooser": "Contacts: crm.list_contacts / crm.search → crm.upsert_contact (dedupe by email). Deals: crm.create_deal after contact exists → crm.list_board before crm.move_deal_stage. Bulk: crm.import_contacts for CSV ingest — crm.merge_contacts for duplicate rows. Timeline: crm.get_contact_360 / crm.get_deal_timeline after writes. Sandbox reads: pass effective_scope.env_uuid after tenant promote — empty list is the head.", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "requires_preflight": false, "risk_class": "low_write", "safe_action": "crm_put_custom_fields", "semantic_input_mode": "inherit_workflow", "summary": "Replace CRM custom field definitions (REST parity).", "title": "Crm Put Custom Fields", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Admin field map — crm.get_custom_fields first; crm.get_crm_config for pipeline context.", "write_mode": null}], "data_access": [{"action": "data_access.set_policy", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not use rbac.check_permission as a substitute for field-level FAP.", "Do not scatter if role== checks in app code — set_policy once per resource."], "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1", "core.fabric.capability_descriptor.gen1"], "id": "data_access.set_policy", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Data Access Set Policy"}, "domain_title": "Data Access MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"insufficient_permissions": "Requires admin permission", "invalid_policy": "Policy format is invalid", "project_not_found": "Project does not exist"}, "example_params": {"default_access": "deny", "globals": {}, "project_id": 123, "resource": "example_string", "resource_policy": {}, "resources": {}}, "example_request": {"action": "data_access.set_policy", "params": {"default_access": "deny", "globals": {}, "project_id": 123, "resource": "example_string", "resource_policy": {}, "resources": {}}}, "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Create or update the field-level access policy for a project resource.", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["data_access.test_mask"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "data_access_admin", "requires_preflight": true, "risk_class": "access_control", "safe_action": "data_access_set_policy", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create or update the field-level access policy for a project resource.", "title": "Data Access Set Policy", "tool_chains": ["content_access_control"], "when_blocked": {"insufficient_permissions": "Requires admin permission", "invalid_policy": "Policy format is invalid", "policy_conflict": "data_access.get_policy — merge paths; test_mask to verify role views", "project_not_found": "Project does not exist"}, "when_to_use": "Create or update the field-level access policy for a project resource.", "write_mode": null}, {"action": "data_access.get_policy", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.get_policy", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Get Policy"}, "domain_title": "Data Access MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"project_not_found": "Project does not exist"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Retrieve the current field-level access policy for a project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "data_access_get_policy", "semantic_input_mode": "inherit_workflow", "summary": "Retrieve the current field-level access policy for a project.", "title": "Data Access Get Policy", "when_blocked": {"project_not_found": "Project does not exist"}, "when_to_use": "Retrieve the current field-level access policy for a project.", "write_mode": null}, {"action": "data_access.check_field", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.check_field", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Check Field"}, "domain_title": "Data Access MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "errors": {"invalid_parameters": "Missing required parameters"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Check whether a specific role can read/write a field in a resource.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "data_access_check_field", "semantic_input_mode": "inherit_workflow", "summary": "Check whether a specific role can read/write a field in a resource.", "title": "Data Access Check Field", "when_blocked": {"invalid_parameters": "Missing required parameters"}, "when_to_use": "Check whether a specific role can read/write a field in a resource.", "write_mode": null}, {"action": "data_access.test_mask", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.test_mask", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Test Mask"}, "domain_title": "Data Access MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "errors": {"invalid_parameters": "Missing required parameters"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Preview what fields a given role can read/write in a resource.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "data_access_test_mask", "semantic_input_mode": "inherit_workflow", "summary": "Preview what fields a given role can read/write in a resource.", "title": "Data Access Test Mask", "when_blocked": {"invalid_parameters": "Missing required parameters"}, "when_to_use": "Preview what fields a given role can read/write in a resource.", "write_mode": null}, {"action": "data_access.get_defaults_template", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.get_defaults_template", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Get Defaults Template"}, "domain_title": "Data Access MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Read the global Field Access Policy template from ecosystem project DNA (`config.field_access_defau…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "data_access_get_defaults_template", "semantic_input_mode": "inherit_workflow", "summary": "Read the global Field Access Policy template from ecosystem project DNA (`config.field_access_defaults`: default_access, globals, resources).", "title": "Data Access Get Defaults Template", "when_to_use": "Read the global Field Access Policy template from ecosystem project DNA (`config.field_access_defaults`: default_access, globals, resources).", "write_mode": null}, {"action": "data_access.set_defaults_template", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.set_defaults_template", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Set Defaults Template"}, "domain_title": "Data Access MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Write the global FAP template on ecosystem project (admin tooling).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "data_access_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "data_access_set_defaults_template", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Write the global FAP template on ecosystem project (admin tooling).", "title": "Data Access Set Defaults Template", "when_to_use": "Write the global FAP template on ecosystem project (admin tooling).", "write_mode": null}, {"action": "data_access.apply_defaults_template", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.apply_defaults_template", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Apply Defaults Template"}, "domain_title": "Data Access MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Copy missing `resources.<name>` entries from the global template into `target_project_id`'s field_a…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "data_access_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "data_access_apply_defaults_template", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Copy missing `resources.<name>` entries from the global template into `target_project_id`'s field_access_policy. Does not overwrite existing keys. Cannot target ecosystem project id=1.", "title": "Data Access Apply Defaults Template", "tool_chains": ["project_bootstrap", "multi_tenant_onboarding"], "when_to_use": "Copy missing `resources.<name>` entries from the global template into `target_project_id`'s field_access_policy. Does not overwrite existing keys. Cannot target ecosystem project id=1.", "write_mode": null}, {"action": "data_access.get_triggers", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.get_triggers", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Get Triggers"}, "domain_title": "Data Access MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Read FAP v1.2 field_triggers for a project (same JSON as field_access_policy.field_triggers).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "data_access_get_triggers", "semantic_input_mode": "inherit_workflow", "summary": "Read FAP v1.2 ``field_triggers`` for a project (same JSON as ``field_access_policy.field_triggers``). Keyed by resource → pattern → list of trigger definitions. See FIELD_ACCESS_POLICY.md — Field Trig", "title": "Data Access Get Triggers", "when_to_use": "Read FAP v1.2 field_triggers for a project (same JSON as field_access_policy.field_triggers).", "write_mode": null}, {"action": "data_access.set_triggers", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.set_triggers", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Data Access Set Triggers"}, "domain_title": "Data Access MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Upsert field_triggers for one resource. triggers maps field_pattern to a list of trigger definition…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "owner_gene": "core.mcp.data_access.gen1", "plane_chooser": "Membership: rbac.get_roles / rbac.check_permission. Field masks: data_access.set_policy → data_access.test_mask before rollout. Defaults: data_access.get_defaults_template / apply_defaults_template — not per-field rbac tables.", "required_cap": "data_access_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "data_access_set_triggers", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Upsert ``field_triggers`` for one resource. **triggers** is a map ``field_pattern → [trigger_def, …]`` (patterns like ``status``, ``config.**``, ``*``).", "title": "Data Access Set Triggers", "when_to_use": "Upsert field_triggers for one resource. triggers maps field_pattern to a list of trigger definitions.", "write_mode": null}], "diagnostics": [{"action": "diagnostics.consistency.scan", "aliases": ["agents.graph_health"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not treat ok=true as promote-ready — read health_ok and graph_health.cycle.", "anti_patterns": ["Do not treat ok=true as promote-ready — read health_ok and graph_health.cycle.", "Info findings (empty KB, idle graph) do not set health_ok=false — only warning, error, critical, or a cycle.", "Do not sync_plan=true on production without reviewing finding codes first."], "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "evaluate", "mutates_when": {"sync_plan": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "effect_override": {"conditional_mutate": "sync_plan=true ingests findings into orchestrator task_list", "effect_depends_on_params": true, "kind": "evaluate", "mutates_when": {"sync_plan": true}}, "execution_class": "heavy", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.consistency.scan", "mutates_when": {"sync_plan": true}, "mutation_risk": "low", "related_tools": ["discovery.status", "agents.reconcile_binding", "agents.plan_reconcile_diagnostics", "agents.fleet_diagnostics", "agents.work_next", "agents.plan_recovery_scan", "knowledge.health", "guidance.recommend_skills"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Consistency Scan", "write_when": ["params.sync_plan=true"]}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "effect_depends_on_params": true, "execution_class": "heavy", "generation": false, "kind": "evaluate", "mutates_when": {"sync_plan": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "effect_override": {"conditional_mutate": "sync_plan=true ingests findings into orchestrator task_list", "effect_depends_on_params": true, "kind": "evaluate", "mutates_when": {"sync_plan": true}}, "errors": {"env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self"}, "examples": [{"name": "Read-only project integrity scan", "request": {"params": {"project_id": 1, "sync_plan": false}, "tool": "diagnostics.consistency.scan"}, "response": {"data": {"finding_count": 0, "health_ok": true, "ok": true}, "success": true}}], "execution_class": "heavy", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Incident triage before promote or after list anomalies. Set sync_plan=true to ingest actionable fin…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["discovery.status", "agents.reconcile_binding", "agents.plan_reconcile_diagnostics", "agents.fleet_diagnostics", "agents.work_next", "agents.plan_recovery_scan", "knowledge.health", "guidance.recommend_skills"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_consistency_scan", "semantic_input_mode": "inherit_workflow", "summary": "Scan integrity; set sync_plan=true to append findings as plan tasks (default read-only).", "title": "Diagnostics Consistency Scan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_goal_facet": "agents.plan_propose mode=decompose_node — facet coverage incomplete on active goal", "provider_quota_exhausted": "buffs.get_effective_limits — wait/backoff; not a product bug", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "work_graph_contradiction": "agents.work_next — recovery rank mismatch vs stale claims; follow next_action", "work_graph_stale_claims": "agents.plan_reclaim_stale then agents.plan_get — stale lease before plan_claim"}, "when_to_use": "Incident triage before promote or after list anomalies. Set sync_plan=true to ingest actionable findings as plan tasks.", "write_mode": null}, {"action": "diagnostics.release_identity", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.release_identity", "related_tools": ["discovery.status", "system.version", "diagnostics.consistency.scan"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Release Identity"}, "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Post-deploy substrate identity", "request": {"params": {}, "tool": "diagnostics.release_identity"}, "response": {"data": {"release_identity": {"catalog_etag": "…", "core_version": "0.4.x", "instruction_revision": "…"}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "W8/GAP-H drift probe after deploy — instruction_revision + catalog etag + core version without full…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["discovery.status", "system.version", "diagnostics.consistency.scan"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_release_identity", "semantic_input_mode": "inherit_workflow", "summary": "Platform MCP release stamps (instruction_revision, catalog etag, core version) — W8 drift probe without full consistency.scan.", "title": "Diagnostics Release Identity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "W8/GAP-H drift probe after deploy — instruction_revision + catalog etag + core version without full consistency.scan. Compare to last prod evidence row.", "write_mode": null}, {"action": "diagnostics.helix_release_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not call projects.patch_data on pid=1 for image channel — use helix_release_get.", "anti_patterns": ["Do not call projects.patch_data on pid=1 for image channel — use helix_release_get."], "capability_descriptor": {"complexity": "simple", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1", "repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_release_get", "mutation_risk": "low", "related_tools": ["diagnostics.helix_placement_get", "diagnostics.helix_pair_doctor"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Release Get"}, "doc_audience": "operator", "domain_title": "Helix mesh organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"service_cap_denied": "Requires mcp_read capability."}, "examples": [{"name": "Pre-deploy channel check", "request": {"params": {}, "tool": "diagnostics.helix_release_get"}, "response": {"data": {"channel": "prod", "desired_image": "…"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "instruction_hint": "Operator helix image channel on pid=1 — not tenant generation.promote. Uses 2s process cache; after…", "kind": "ecs_system", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "helix_mesh", "owner_gene": "repo.ops.node_mesh_release.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.helix_placement_get", "diagnostics.helix_pair_doctor"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_helix_release_get", "semantic_input_mode": "inherit_workflow", "summary": "Read ecosystem.node_mesh.release on pid=1 (image channel, not generation.promote).", "title": "Diagnostics Helix Release Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires mcp_read capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator helix image channel on pid=1 — not tenant generation.promote. Uses 2s process cache; after helix_release_set prefer placement_get or doctor.", "write_mode": null}, {"action": "diagnostics.helix_placement_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not load full projects.get_data blob — placement is ecosystem.node_mesh.placement leaf.", "anti_patterns": ["Do not load full projects.get_data blob — placement is ecosystem.node_mesh.placement leaf."], "capability_descriptor": {"complexity": "simple", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1", "repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_placement_get", "mutation_risk": "low", "related_tools": ["diagnostics.helix_release_get", "diagnostics.helix_pair_doctor"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Placement Get"}, "doc_audience": "operator", "domain_title": "Helix mesh organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"service_cap_denied": "Requires mcp_read capability."}, "examples": [{"name": "Placement before resolve drill", "request": {"params": {}, "tool": "diagnostics.helix_placement_get"}, "response": {"data": {"pairs": {}, "proving_pair_id": ""}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "instruction_hint": "Pair placement leaf before resolve/renew drills.", "kind": "ecs_system", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "helix_mesh", "owner_gene": "repo.ops.node_mesh_release.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.helix_release_get", "diagnostics.helix_pair_doctor"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_helix_placement_get", "semantic_input_mode": "inherit_workflow", "summary": "Read ecosystem.node_mesh.placement pairs leaf on pid=1.", "title": "Diagnostics Helix Placement Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires mcp_read capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pair placement leaf before resolve/renew drills.", "write_mode": null}, {"action": "diagnostics.helix_strand_phase_dry_run", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not use for production image pull — phases emit operator signals only.", "anti_patterns": ["Do not use for production image pull — phases emit operator signals only.", "Do not enqueue platform_work_items — use plan_strand_update for real rolls."], "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_strand_phase_dry_run", "mutation_risk": "low", "related_tools": ["diagnostics.helix_pair_doctor", "diagnostics.helix_placement_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Strand Phase Dry Run"}, "doc_audience": "operator", "domain_title": "Helix mesh organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Required helix param missing (see tool params — token, channel, or pair_id).", "member_not_drained": "Unhealthy member before strand restart — fix peer health probe / drain phase.", "member_pull_lag": "Peer POST /api/helix/pull rev below strand target — wait for J-3 catch-up on lagging members.", "member_urls_required": "Multi-member strand job needs member_urls on placement pair meta before drain.", "pull_incomplete": "Placement head_revs below strand pull_targets — extend pull_wait_s or fix writers.", "service_cap_denied": "Requires mcp_read capability."}, "examples": [{"name": "Dry-run drain on proving pair", "request": {"params": {"pair_id": "prov-v1", "phase": "drain_quiet_member"}, "tool": "diagnostics.helix_strand_phase_dry_run"}, "response": {"data": {"phase": "drain_quiet_member", "result": {}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "instruction_hint": "Debug drain or poll phases before planning a strand job.", "kind": "ecs_system", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "helix_mesh", "owner_gene": "repo.ops.node_mesh_release.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.helix_pair_doctor", "diagnostics.helix_placement_get"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_helix_strand_phase_dry_run", "semantic_input_mode": "inherit_workflow", "summary": "Execute one helix strand phase in-process — no platform_work_items enqueue.", "title": "Diagnostics Helix Strand Phase Dry Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Required helix param missing (see tool params — token, channel, or pair_id).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "member_not_drained": "Unhealthy member before strand restart — fix peer health probe / drain phase.", "member_pull_lag": "Peer POST /api/helix/pull rev below strand target — wait for J-3 catch-up on lagging members.", "member_urls_required": "Multi-member strand job needs member_urls on placement pair meta before drain.", "pull_incomplete": "Placement head_revs below strand pull_targets — extend pull_wait_s or fix writers.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires mcp_read capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Debug drain or poll phases before planning a strand job.", "write_mode": null}, {"action": "diagnostics.helix_pair_doctor", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not scrape __protein_ops — helix heads and release/placement leaves only.", "anti_patterns": ["Do not scrape __protein_ops — helix heads and release/placement leaves only."], "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_pair_doctor", "mutation_risk": "low", "related_tools": ["diagnostics.helix_release_get", "diagnostics.helix_placement_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Pair Doctor"}, "doc_audience": "operator", "domain_title": "Helix mesh organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"pair_not_found": "Call diagnostics.helix_placement_get — use an existing pair_id from pairs leaf.", "service_cap_denied": "Requires mcp_read capability."}, "examples": [{"name": "Doctor default pair (proving/prod policy)", "request": {"params": {}, "tool": "diagnostics.helix_pair_doctor"}, "response": {"data": {"contract_version": 1, "pair_id": "…"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "instruction_hint": "Contract fixture + release/placement snapshot before resolve or strand drills.", "kind": "ecs_system", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "helix_mesh", "owner_gene": "repo.ops.node_mesh_release.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.helix_release_get", "diagnostics.helix_placement_get"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_helix_pair_doctor", "semantic_input_mode": "inherit_workflow", "summary": "In-process helix doctor: contract fixture + release/placement snapshot.", "title": "Diagnostics Helix Pair Doctor", "when_blocked": {"complement_timeout": "Complement did not ack in time — host journal kept; retry seal, do not rewind.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "empty_ops": "Complement seal rejected an empty ops batch — host must resend the journal row.", "epoch_stale": "Call diagnostics.helix_pair_doctor then POST /api/helix/resolve for a fresh token.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "pair_heat_cold": "watcher_mode=heat and this process has no helix pair protein heat above the floor — seal or notify the pair, or set HELIX_WATCHER_HEAT_GATE=0.", "pair_not_found": "Call diagnostics.helix_placement_get — use an existing pair_id from pairs leaf.", "project_mismatch": "Seal token project_id does not match the body — remint complement seal for that key.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "seal_forbidden": "Seal requires purpose=complement_seal on the token minted by the host strand.", "service_cap_denied": "Requires mcp_read capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unknown_head": "Pull target has no materialized head — peer must resolve or wait for the first seal.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "watcher_map_only": "Pair watcher_mode=map_only defers epoch CAS — switch mode or wait."}, "when_to_use": "Contract fixture + release/placement snapshot before resolve or strand drills.", "write_mode": null}, {"action": "diagnostics.helix_renew_token", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not bump pair epoch on member failover — renew slides exp; epoch CAS is watcher-only.", "anti_patterns": ["Do not bump pair epoch on member failover — renew slides exp; epoch CAS is watcher-only."], "capability_descriptor": {"complexity": "simple", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_renew_token", "mutation_risk": "low", "related_tools": ["diagnostics.helix_placement_get", "diagnostics.helix_pair_doctor"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Renew Token"}, "doc_audience": "operator", "domain_title": "Helix mesh organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"epoch_stale": "Call diagnostics.helix_pair_doctor then POST /api/helix/resolve for a fresh token.", "invalid_member": "member_id not in placement pair members.", "invalid_parameters": "token required", "invalid_token": "Helix token signature or exp failed — resolve again.", "pair_not_found": "Call diagnostics.helix_placement_get — use an existing pair_id from pairs leaf.", "pair_retired": "Retired pair — steer release channel or placement before resolve."}, "examples": [{"name": "Slide TTL after resolve", "request": {"params": {"token": "<signed>"}, "tool": "diagnostics.helix_renew_token"}, "response": {"data": {"claims": {}, "token": "…"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "instruction_hint": "Renew sticky helix token on member; epoch unchanged on failover.", "kind": "ecs_system", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "helix_mesh", "owner_gene": "repo.ops.node_mesh_release.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.helix_placement_get", "diagnostics.helix_pair_doctor"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_helix_renew_token", "semantic_input_mode": "inherit_workflow", "summary": "Slide helix token TTL after placement precheck (helix_renew_precheck) — not release set.", "title": "Diagnostics Helix Renew Token", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "epoch_stale": "Call diagnostics.helix_pair_doctor then POST /api/helix/resolve for a fresh token.", "invalid_member": "member_id not in placement pair members.", "invalid_parameters": "token required", "invalid_token": "Helix token signature or exp failed — resolve again.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "pair_not_found": "Call diagnostics.helix_placement_get — use an existing pair_id from pairs leaf.", "pair_retired": "Retired pair — steer release channel or placement before resolve.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Renew sticky helix token on member; epoch unchanged on failover.", "write_mode": null}, {"action": "diagnostics.helix_release_set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not use generation.promote or sandbox_service for backend image channel.", "anti_patterns": ["Do not use generation.promote or sandbox_service for backend image channel."], "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_release_set", "mutation_risk": "low", "related_tools": ["diagnostics.helix_release_get", "diagnostics.helix_placement_get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Release Set"}, "doc_audience": "operator", "domain_title": "Helix mesh organelle", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"invalid_parameters": "channel required", "service_cap_denied": "helix_release_set needs operator capability.", "write_failed": "Atomic leaf write on ecosystem.node_mesh.release failed."}, "examples": [{"name": "Steer resolve to prod channel", "request": {"params": {"channel": "prod", "desired_image": "ghcr.io/…"}, "tool": "diagnostics.helix_release_set"}, "response": {"data": {"channel": "prod"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "instruction_hint": "Operator write of image channel on pid=1. Not generation.promote.", "kind": "ecs_system", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "helix_mesh", "owner_gene": "repo.ops.node_mesh_release.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.helix_release_get", "diagnostics.helix_placement_get"], "required_cap": "operator", "requires_preflight": false, "risk_class": "low_write", "safe_action": "diagnostics_helix_release_set", "semantic_input_mode": "inherit_workflow", "summary": "Operator: set helix release channel / desired_image on pid=1.", "title": "Diagnostics Helix Release Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "channel required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "helix_release_set needs operator capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "Atomic leaf write on ecosystem.node_mesh.release failed."}, "when_to_use": "Operator write of image channel on pid=1. Not generation.promote.", "write_mode": null}, {"action": "diagnostics.helix_watcher_epoch_arm", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not bump pair epoch via projects.patch_data — use placement CAS via watcher tick.", "anti_patterns": ["Do not bump pair epoch via projects.patch_data — use placement CAS via watcher tick.", "A rejected CAS clears pending_epoch; re-arm with the live expected epoch.", "watcher_mode=map_only defers the tick (watcher_map_only) and keeps pending_epoch."], "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1", "repo.ops.node_mesh_release.gen1"], "id": "diagnostics.helix_watcher_epoch_arm", "mutation_risk": "low", "related_tools": ["diagnostics.helix_placement_get", "diagnostics.helix_pair_doctor"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Helix Watcher Epoch Arm"}, "doc_audience": "operator", "domain_title": "Helix mesh organelle", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "pair_id, expected_epoch, and new_epoch required.", "service_cap_denied": "helix_watcher_epoch_arm needs operator capability.", "write_failed": "Atomic leaf write on ecosystem.node_mesh.watcher.pending_epoch failed."}, "examples": [{"name": "Arm epoch after split drill", "request": {"params": {"expected_epoch": 2, "new_epoch": 3, "pair_id": "p1"}, "tool": "diagnostics.helix_watcher_epoch_arm"}, "response": {"data": {"new_epoch": 3, "pair_id": "p1"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["repo.ops.node_mesh_release.gen1"], "instruction_hint": "Arm watcher pending epoch bump on pid=1; helix-watcher tick runs CAS.", "kind": "ecs_system", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "helix_mesh", "owner_gene": "repo.ops.node_mesh_release.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.helix_placement_get", "diagnostics.helix_pair_doctor"], "required_cap": "operator", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_helix_watcher_epoch_arm", "semantic_input_mode": "inherit_workflow", "summary": "Arm pending epoch bump for watcher CAS on pid=1 placement pair.", "title": "Diagnostics Helix Watcher Epoch Arm", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "pair_id, expected_epoch, and new_epoch required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "helix_watcher_epoch_arm needs operator capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "Atomic leaf write on ecosystem.node_mesh.watcher.pending_epoch failed."}, "when_to_use": "Arm watcher pending epoch bump on pid=1; helix-watcher tick runs CAS.", "write_mode": null}, {"action": "diagnostics.report", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not use social.support.send for platform substrate bugs — use diagnostics.report.", "anti_patterns": ["Do not use social.support.send for platform substrate bugs — use diagnostics.report.", "Do not use trust.feedback for operator MCP failures — distinct plane."], "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.report", "related_tools": ["diagnostics.report_list", "diagnostics.report_get", "diagnostics.report_attach", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Report"}, "doc_audience": "operator", "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "report_rate_limited": "Too many reports this hour; retry later.", "service_cap_denied": "Requires diagnostics_report capability.", "unauthorized": "Sign in or Connect MCP before reporting."}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Durable platform problem report with trace/MCP context — operator/agent. Required: summary (short t…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.report_list", "diagnostics.report_get", "diagnostics.report_attach", "agents.work_next"], "required_cap": "diagnostics_report", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_report", "semantic_input_mode": "inherit_workflow", "summary": "Create a platform problem report (operator/agent). Distinct from trust.feedback and social.support.", "title": "Diagnostics Report", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "report_rate_limited": "Too many reports this hour; retry later.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Durable platform problem report with trace/MCP context — operator/agent. Required: summary (short title line), severity s0|s1|s2|s3, category string — not title alone. Optional: detail, project_id, co", "write_mode": null}, {"action": "diagnostics.report_list", "aliases": ["diagnostics.reports.list", "report.list", "reports.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.report_list", "related_tools": ["diagnostics.report", "diagnostics.report_get"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Report List"}, "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"service_cap_denied": "Requires diagnostics_report capability.", "unauthorized": "Sign in or Connect MCP before reporting."}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Operator triage list after diagnostics.report — compact index rows by default.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.report", "diagnostics.report_get"], "required_cap": "diagnostics_report", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_report_list", "semantic_input_mode": "inherit_workflow", "summary": "List platform problem reports (index rows).", "title": "Diagnostics Report List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator triage list after diagnostics.report — compact index rows by default.", "write_mode": null}, {"action": "diagnostics.report_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.report_get", "related_tools": ["diagnostics.report_list", "diagnostics.report_attach"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Report Get"}, "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"not_found": "Unknown report_id.", "service_cap_denied": "Requires diagnostics_report capability.", "unauthorized": "Sign in or Connect MCP before reporting."}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Deep triage: ECS body, attachments, optional OpTrace tail.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.report_list", "diagnostics.report_attach"], "required_cap": "diagnostics_report", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_report_get", "semantic_input_mode": "inherit_workflow", "summary": "Fetch one platform report by id (ECS body + attachments).", "title": "Diagnostics Report Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown report_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Deep triage: ECS body, attachments, optional OpTrace tail.", "write_mode": null}, {"action": "diagnostics.report_attach", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.report_attach", "related_tools": ["diagnostics.report", "diagnostics.report_get"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Report Attach"}, "domain_title": "Admin Data MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "not_found": "Unknown report_id.", "service_cap_denied": "Requires diagnostics_report capability.", "unauthorized": "Sign in or Connect MCP before reporting."}, "execution_class": "cheap", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Append reproduction steps to an existing report_id.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.report", "diagnostics.report_get"], "required_cap": "diagnostics_report", "requires_preflight": false, "risk_class": "low_write", "safe_action": "diagnostics_report_attach", "semantic_input_mode": "inherit_workflow", "summary": "Append a follow-up note to an existing platform report.", "title": "Diagnostics Report Attach", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown report_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append reproduction steps to an existing report_id.", "write_mode": null}, {"action": "diagnostics.report_update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.report_update", "related_tools": ["diagnostics.report_get", "diagnostics.report_list"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Diagnostics Report Update"}, "domain_title": "Admin Data MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "not_found": "Unknown report_id.", "service_cap_denied": "Requires diagnostics_report capability.", "unauthorized": "Sign in or Connect MCP before reporting."}, "execution_class": "cheap", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Move report through triage lifecycle (open → triage → resolved). Index leaf only.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.report_get", "diagnostics.report_list"], "required_cap": "diagnostics_report", "requires_preflight": false, "risk_class": "low_write", "safe_action": "diagnostics_report_update", "semantic_input_mode": "inherit_workflow", "summary": "Update platform report status (open, triage, resolved).", "title": "Diagnostics Report Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass summary (required string headline), severity (s0–s3), category — do not use title; optional detail and context object.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown report_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Requires diagnostics_report capability.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Sign in or Connect MCP before reporting.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move report through triage lifecycle (open → triage → resolved). Index leaf only.", "write_mode": null}, {"action": "diagnostics.neural_graph", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.neural_graph", "related_tools": ["admin.data.health", "organelle.execute", "diagnostics.promote_hot_gene"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Neural Graph"}, "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Robot/operator inspect live neural topology + hot paths without opening the SPA.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["admin.data.health", "organelle.execute", "diagnostics.promote_hot_gene"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_neural_graph", "semantic_input_mode": "inherit_workflow", "summary": "Neural Visualizer Gen2 snapshot: topology, heat planes (protein/api/dna_query/gene), composition edges, hot_region_hints. Always includes heat_meta (worker layout honesty). Process-local heat; Tier F ", "title": "Diagnostics Neural Graph", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Robot/operator inspect live neural topology + hot paths without opening the SPA.", "write_mode": null}, {"action": "diagnostics.promote_hot_gene", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.promote_hot_gene", "related_tools": ["diagnostics.neural_graph"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Promote Hot Gene"}, "domain_title": "Admin Data MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Operator pins hot gene paths after reviewing Neural Visualizer gene plane.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.neural_graph"], "required_cap": "admin.write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "diagnostics_promote_hot_gene", "semantic_input_mode": "inherit_workflow", "summary": "Promote a genetic tag's path prefixes into HotProteinRegion for an entity. Modes: warm, pin, prefetch_only. Tier F materialize blocked.", "title": "Diagnostics Promote Hot Gene", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator pins hot gene paths after reviewing Neural Visualizer gene plane.", "write_mode": null}, {"action": "diagnostics.gene_token_query", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.gene_token_query", "related_tools": ["diagnostics.neural_graph", "diagnostics.promote_hot_gene"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Diagnostics Gene Token Query"}, "domain_title": "Admin Data MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Admin debug: find hot protein bindings by genetic token AND query.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "owner_gene": "core.mcp.admin_data.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["diagnostics.neural_graph", "diagnostics.promote_hot_gene"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "diagnostics_gene_token_query", "semantic_input_mode": "inherit_workflow", "summary": "GTPI bool query against process-local gene token lexicon.", "title": "Diagnostics Gene Token Query", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Admin debug: find hot protein bindings by genetic token AND query.", "write_mode": null}], "discovery": [{"action": "discovery.get_platform_surfaces", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.get_platform_surfaces", "related_tools": ["discovery.search", "discovery.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Get Platform Surfaces"}, "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Platform route inventory for Compass/docs — not tenant MCP.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.search", "discovery.list"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_get_platform_surfaces", "semantic_input_mode": "inherit_workflow", "summary": "List canonical platform routes from generated platform-surface-audit.json.", "title": "Discovery Get Platform Surfaces", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Platform route inventory for Compass/docs — not tenant MCP.", "write_mode": null}, {"action": "discovery.list", "aliases": ["actions.list", "discovery.actions", "discovery.catalog", "discovery.dynamic_tools", "discovery.get_dynamic_tools", "discovery.list_actions", "discovery.mcp.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.list", "related_tools": ["discovery.summary", "discovery.search", "preflight.check", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery List"}, "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list"}, "examples": [{"name": "Compact domain page", "request": {"params": {"domain": "generation", "limit": 20, "project_id": 1}, "tool": "discovery.list"}, "response": {"data": {"compact": true, "has_more": false, "total_matched": 12}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Full plane map: agentstack://planes. Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; pri…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_map_resource": "agentstack://planes", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "recipe_id": "mcp_platform_flows_v1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.summary", "discovery.search", "preflight.check", "agents.work_next"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_list", "semantic_input_mode": "inherit_workflow", "summary": "List MCP actions — default compact page (50 rows). Set full_catalog=true for the full GET /mcp/actions body (~900 tools). Includes execute_budget (sync 60s / one heavy LLM step) and write_modes (merge", "title": "Discovery List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "MCP catalog alias — same wire family as GET /mcp/actions. Default is a compact page (≤50 rows, server cap 50); pass domain= or q= to narrow. Do not cursor-walk the full catalog without filters — use d", "write_mode": null}, {"action": "discovery.changelog", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.changelog", "related_tools": ["discovery.summary", "discovery.list", "discovery.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Changelog"}, "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Pass since= as a release tag (e.g. since=0.4.22) — discovery.changelog is not discovery.list; omit domain= and q=.", "unauthorized": "Authenticate (Bearer or API key) before changelog read"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Read-only MCP wire/catalog changelog stamp — deploy G-7 probe and operator drift checks; not a subs…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.summary", "discovery.list", "discovery.status"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_changelog", "semantic_input_mode": "inherit_workflow", "summary": "MCP wire and Work Graph contract changes since a release tag (e.g. since=0.4.22). Cheap read for agent upgrade notes.", "title": "Discovery Changelog", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass since= as a release tag (e.g. since=0.4.22) — discovery.changelog is not discovery.list; omit domain= and q=.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate (Bearer or API key) before changelog read", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only MCP wire/catalog changelog stamp — deploy G-7 probe and operator drift checks; not a substitute for discovery.summary totals.", "write_mode": null}, {"action": "discovery.summary", "aliases": ["discovery.actions_summary"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.summary", "related_tools": ["discovery.list", "discovery.status", "discovery.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Summary"}, "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list"}, "execution_class": "plain_read", "flows": [{"action": "hosting.project.status", "approval": "high_risk", "id": "site", "intent": "app.edit", "phrasings": "change the site|изменить сайт|alterar site|build a website|сделай сайт|rollback the site|откати сайт", "recipe_id": "mcp_site_growth_v1", "rollback_action": "hosting.release.promote", "success": "primary_public_url set and hosting.site.edge_health edge_ready after publish", "tip": "If primary_public_url exists, edit that bucket. Do not quick_start another site. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session. Do not call MCP auth.login for the visitor.", "verify_action": "hosting.project.status", "when": "Publish or edit a hosted site"}, {"action": "notifications.deliver", "id": "notify", "recipe_id": "mcp_notify_channels_v1", "success": "notifications.list_prefs shows channel preferences", "tip": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "verify_action": "notifications.list_prefs", "when": "Email or bot notice to a user"}, {"action": "crm.list_contacts", "approval": "never", "id": "crm", "intent": "crm.contact.manage", "phrasings": "add a contact|добавь клиента|adicionar contato", "recipe_id": "mcp_crm_contact_deal", "rollback_action": "crm.erase_contact", "success": "crm.get_contact_360 returns the contact", "tip": "One CRM. An empty list after upsert is the sandbox head — crm.get_contact_360. Do not insert a second contact. crm.list_board readiness=pending follows next_actions. Do not create_deal. Do not promote.", "verify_action": "crm.get_contact_360", "when": "Contacts and deals"}, {"action": "knowledge.health", "approval": "never", "cancel": "unsupported", "id": "knowledge", "intent": "knowledge.ingest", "phrasings": "upload documents|загрузи документы|base de conhecimento", "recipe_id": "mcp_knowledge_ingest", "success": "knowledge.health reports the collection", "tip": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "verify_action": "knowledge.health", "when": "Ground answers in project docs"}, {"action": "agents.list", "approval": "high_risk", "id": "agents", "intent": "agent.promote", "phrasings": "run an agent|запусти агента|rodar agente", "recipe_id": "mcp_agents_run_approve", "rollback_action": "agents.stop", "success": "agents.list shows the fleet", "tip": "Templates: agents.templates_list. One heavy run per batch. An empty agents.list is valid. Do not create a second agent.", "verify_action": "agents.list", "when": "Run a fleet agent"}, {"action": "hosting.project.status", "approval": "on_request", "id": "design_landing", "intent": "design.redesign", "phrasings": "redesign landing page|переделай лендинг|redesenhar landing", "recipe_id": "mcp_site_growth_v1", "success": "browser_verification.passed or primary_public_url updated", "tip": "Route via design.redesign taxonomy; verify with browser_verification.passed when step tagged verify.", "verify_action": "hosting.project.status", "when": "Redesign or review landing UX"}, {"action": "bots.list", "approval": "never", "id": "bots", "intent": "bot.go_live", "phrasings": "create a telegram bot|создай бота|criar bot", "recipe_id": "mcp_bots_simulate", "success": "bots.list shows the channel bot", "tip": "Attach with bots.attach_channel, then bots.go_live. Simulate is the heavy step. An empty bots.list is valid. Do not create a second bot.", "verify_action": "bots.list", "when": "Create or test a channel bot"}, {"action": "payments.get_balance", "approval": "high_risk", "id": "payments", "intent": "payments.inspect", "phrasings": "billing|invoice|расход|gasto", "recipe_id": "mcp_integrations_checkout_crm", "success": "payments.get_balance returns the wallet", "tip": "Fiat is AgentPay. On-chain AGNT is agentnet.balance, not a second checkout. An empty balance is valid. Do not open a second checkout.", "verify_action": "integrations.connection_health", "when": "Checkout or wallet balance"}, {"action": "generation.list", "id": "generation", "recipe_id": "mcp_generation_diff", "success": "generation.list shows sandbox anchors", "tip": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "verify_action": "generation.list", "when": "Change tenant 8DNA safely"}, {"action": "social.support.inbox", "id": "support", "recipe_id": "mcp_support_inbox", "success": "social.support.inbox lists open threads", "tip": "Reply stays on the support thread. It is not social.chat and not a bot transcript.", "verify_action": "social.support.inbox", "when": "Staff support inbox"}, {"action": "rbac.get_roles", "id": "access", "recipe_id": "mcp_user_access_safe", "success": "rbac.get_roles returns project roles", "tip": "Field policy is data_access.set_policy, not a new permission table.", "verify_action": "rbac.get_roles", "when": "Roles and field access"}, {"action": "logic.list", "id": "rules", "recipe_id": "mcp_integrations_webhook_scheduler", "success": "logic.list shows automations", "tip": "Preview with logic.dry_run. The server keeps the sandbox head. Cancel a schedule with scheduler.cancel_task, not create_task.", "verify_action": "logic.list", "when": "When X then Y"}, {"action": "assets.list", "id": "catalog", "recipe_id": "mcp_site_growth_v1", "success": "hosting.project.status and assets.list on canonical slice", "tip": "Goods are assets on the canonical slice. Create with assets.create. Do not replace data.assets.items[]. An empty list after create is the sandbox head. The server keeps it. Wallets hold the balance.", "verify_action": "hosting.project.status", "when": "Digital goods or a storefront"}, {"action": "shop.orders.get", "approval": "never", "id": "shop_order_status", "intent": "shop.order.lookup", "phrasings": "order status|order_id|статус заказа|status do pedido", "recipe_id": "mcp_shop_order_lookup_v1", "success": "shop.orders.get returned order state", "tip": "Read-only order lookup — not payments.create and not shop.checkout.create.", "verify_action": "shop.orders.get", "when": "Check shop order or payment status by order_id"}, {"action": "payments.get_balance", "approval": "never", "id": "commerce_read", "intent": "business.status", "phrasings": "business status|статус бизнеса|status do negocio", "recipe_id": "mcp_commerce_orient", "success": "payments.get_balance and wallets.list loaded", "tip": "Open a wallet, then deposit in the next recipe with the copied wallet_id. This is the business status read. Do not call thirty raw payment tools. For shop order_id status use shop.orders.get — not this atom.", "verify_action": "payments.get_balance", "when": "See balance, wallets, and assets"}, {"action": "logic.list", "approval": "never", "id": "logic", "intent": "automation.create", "phrasings": "when a lead|каждый новый|quando um lead", "recipe_id": "mcp_logic_orient", "success": "logic.list contains the rule", "tip": "Create with mcp_logic_create. Dry-run needs the returned logic_id. An empty logic.list is this scope. Do not create a second rule.", "verify_action": "logic.list", "when": "Create a when-then rule"}, {"action": "storage.get_quota", "approval": "never", "id": "files", "intent": "files.inspect", "phrasings": "storage quota|квота|quota de arquivos", "recipe_id": "mcp_storage_orient", "success": "storage.get_quota returns used bytes", "tip": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "verify_action": "storage.get_quota", "when": "Check storage quota or list files"}, {"action": "scheduler.list_tasks", "approval": "never", "id": "schedule", "intent": "scheduler.daily", "phrasings": "every morning|каждый день|todo dia", "recipe_id": "mcp_scheduler_orient", "rollback_action": "scheduler.cancel_task", "success": "scheduler.list_tasks shows the cron", "tip": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "verify_action": "scheduler.list_tasks", "when": "Run something on a cron"}, {"action": "guidance.match_playbook", "id": "compass", "recipe_id": "mcp_guidance_match", "success": "guidance.match_playbook returns a playbook id", "tip": "Copy the playbook id into mcp_guidance_start.", "verify_action": "guidance.match_playbook", "when": "Start a guided Compass path"}, {"action": "finance.project.portfolio", "id": "treasury", "recipe_id": "mcp_treasury_read", "success": "finance.project.portfolio returns treasury snapshot", "tip": "AgentNet proofs stay on agentnet.*.", "verify_action": "finance.project.portfolio", "when": "Project treasury versus user wallets"}, {"action": "projects.orchestrator.get", "id": "orchestrator", "recipe_id": "mcp_agents_orchestrator_configure", "success": "projects.orchestrator.get shows routing config", "tip": "Then mcp_orch_faq_desk, mcp_orch_support_desk, or mcp_orch_api_desk. One channel owner.", "verify_action": "projects.orchestrator.get", "when": "Route replies across chat, bot, or an external API"}, {"action": "auth.get_profile", "approval": "never", "id": "session", "intent": "project.inspect", "phrasings": "what is in my project|посмотри проект|o que tem no projeto", "recipe_id": "mcp_session_setup", "success": "auth.get_profile session_ready", "tip": "One jti covers every project membership allows. mutation_allowed true: do not switch_project and do not log in again. A restart rehydrates that jti from 8DNA. A page at /s/{id}/ uses the hosted cookie, not this jti.", "verify_action": "auth.get_profile", "when": "Use one login across projects"}, {"action": "discovery.status", "approval": "never", "id": "diagnose", "intent": "project.diagnose", "phrasings": "what is broken|что сломано|o que quebrou", "recipe_id": "mcp_readonly_audit_v1", "success": "diagnostics.consistency.scan finished with no writes", "tip": "Read status, profile, and diagnostics.consistency.scan. Zero writes. An empty list is valid. Diagnose before repair.", "verify_action": "discovery.status", "when": "Inspect health before any repair"}, {"action": "seo.health.check", "id": "seo", "recipe_id": "mcp_seo_health_v1", "success": "seo.health.check reports registry readiness", "tip": "Registry caps live in shared/seo — not hosting.bucket.file.patch. After copy deploy: seo.cache.clear.", "verify_action": "seo.health.check", "when": "Marketing meta readiness and sample path meta"}, {"action": "showcase.catalog.get", "id": "showcase", "recipe_id": "mcp_showcase_catalog_safe", "success": "showcase.catalog.get returns demo entries", "tip": "Bind project_id=1. Diff vs fixture before upsert. Tenant DNA uses generation.promote, not showcase.catalog.", "verify_action": "showcase.catalog.get", "when": "Read the ecosystem demo gallery (project 1 only)"}, {"action": "showcase.sources.sync_status", "id": "showcase_vps", "recipe_id": "mcp_showcase_vps_ops", "success": "showcase.health.probe stamps ok for proof entries", "tip": "Deploy: showcase_build_all or deploy.showcase_* steps. MCP documents sync contract; build via hosting.site.build or VPS script.", "verify_action": "showcase.health.probe", "when": "Platform proof static sites (1438–1443) — VPS-primary build and republish"}, {"action": "shop.enablement.status", "approval": "never", "id": "commerce", "intent": "tenant_iap_checkout", "phrasings": "in-app purchase|shop checkout|tenant iap|купить в приложении", "recipe_id": "mcp_tenant_iap_checkout_v1", "success": "shop.checkout.create returns order_id in sandbox or live per enablement", "tip": "Hosted game or app shop: shop.enablement.status → shop.products.list → shop.checkout.create with idempotency_key. Not bare payments.create for IAP orders.", "verify_action": "shop.orders.get", "when": "Buyer in-app purchase / tenant shop checkout"}, {"action": "shop.products.upsert", "approval": "project_write", "id": "tenant_iap_catalog", "intent": "tenant_iap_catalog", "phrasings": "iap catalog|server priced sku|shop.products.upsert|каталог iap|catálogo iap", "recipe_id": "mcp_tenant_iap_catalog_v1", "success": "shop.products.list shows active SKU rows", "tip": "Owner ladder: shop.enablement.status → assets.create → shop.products.upsert (active) → shop.products.list — not commerce.sell.activate for game IAP SKUs.", "verify_action": "shop.products.list", "when": "Owner builds server-priced IAP SKUs (enablement → asset → upsert)"}, {"action": "commerce.channel_pass.configure", "approval": "project_write", "id": "channel_pass_owner", "intent": "channel_pass_owner", "phrasings": "channel pass|closed channel|telegram subscription|nebula|пропуск канал", "recipe_id": "mcp_channel_pass_owner_v1", "success": "binding leaf present; active channel_pass SKU", "tip": "commerce.channel_pass.configure → shop.products.upsert (channel_pass grant) → scheduler.create_task (commerce.channel_pass.sweep).", "verify_action": "commerce.channel_pass.binding.get", "when": "Owner sells Telegram closed-channel access (bot /passes)"}, {"action": "commerce.checkout.session", "approval": "never", "id": "marketplace_buyer_checkout", "intent": "commerce.checkout.session", "phrasings": "marketplace checkout|buy listing|купить листинг|checkout marketplace", "recipe_id": "mcp_marketplace_checkout_v1", "success": "commerce.checkout.session returns session_id", "tip": "Buyer path: commerce.checkout.session with listing_id, idempotency_key, and rail — not commerce.sell.activate.", "verify_action": "commerce.checkout.session", "when": "Marketplace buyer checkout session (listing + rail)"}, {"action": "commerce.sell.activate", "approval": "project_write", "id": "commerce_seller_activate", "intent": "commerce.sell.activate", "phrasings": "start selling|seller activate|начать продавать|ativar vendedor", "recipe_id": "mcp_commerce_seller_activate_v1", "success": "commerce.sell.activate returns activation state", "tip": "Seller rail — commerce.sell.activate with idempotency_key. Not buyer checkout session.", "verify_action": "commerce.sell.activate", "when": "Seller onboarding / sell.activate on tenant commerce"}, {"action": "safety.evaluate", "id": "safety", "recipe_id": "mcp_safety_probe", "success": "safety.evaluate returns probe verdict", "tip": "safety.evaluate is a rules-first read. Playbook overlays go through generation.promote, not a second safety model.", "verify_action": "safety.evaluate", "when": "Probe one text before ingest or bot reply"}], "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Optional read-only health check (recipe mcp_read_bootstrap) — catalog totals and etag without full …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "recipe_id": "mcp_platform_flows_v1", "registry_counter_contract": {"catalog_actions_public": "Marketing constant MCP_CATALOG_ACTIONS.", "domain_count": "Domains in catalog payload map (includes REST-only domains).", "domains_public": "Marketing floor MCP_ACTION_DOMAINS — not a third live count.", "executable_domain_count": "domain_count minus REST-only domains.", "mcp_executable_total": "Catalog actions minus REST-only commerce_rest / rest.* domains (registry_dimensions).", "public_total": "Doc-audience public+tenant tools among economy-visible registry rows (catalog_scope); not the same as principal_visible_total (L1 service_caps).", "registry_tools": "Live @mcp_tool rows in MCP_TOOLS_REGISTRY after economy_crypto_policy visibility filter.", "registry_total": "All registered tools in discovery.status populations.", "total_actions": "Catalog total_actions from cache when present; otherwise matches registry_tools on summary miss."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.list", "discovery.status", "discovery.search"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_summary", "semantic_input_mode": "inherit_workflow", "summary": "Lightweight MCP catalog totals (alias for GET /mcp/actions/summary).", "title": "Discovery Summary", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Optional read-only health check (recipe mcp_read_bootstrap) — catalog totals and etag without full catalog. Session bootstrap is mcp_session_setup, not this action. Deploy/gate probes: use this (or di", "write_mode": null}, {"action": "discovery.status", "aliases": ["discovery.bootstrap"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.status", "related_tools": ["discovery.search", "discovery.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Status"}, "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Step 2 discovery ladder — registry totals/etag before full catalog load. Deploy matrix G-02 default…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.search", "discovery.list"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_status", "semantic_input_mode": "inherit_workflow", "summary": "Registry status — version, catalog etag, action/domain/recipe totals.", "title": "Discovery Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Step 2 discovery ladder — registry totals/etag before full catalog load. Deploy matrix G-02 default probe (set AGENTSTACK_MATRIX_FULL_SPINE=1 for discovery.summary + plan_get spine).", "write_mode": null}, {"action": "discovery.recipes", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.recipes", "related_tools": ["discovery.describe", "discovery.search", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Recipes"}, "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Pass recipe filter (domain, tag) or options.recipe_id — not discovery.list domain/q filters.", "recipe_not_found": "Unknown recipe_id — discovery.describe the recipe or discovery.search workflow playbooks.", "unauthorized": "Authenticate before listing named recipes for agentstack.execute recipe_id."}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Onboarding subset of recipes — full registry GET /mcp/recipes or discovery.search. Execute via opti…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.describe", "discovery.search", "preflight.check"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_recipes", "semantic_input_mode": "inherit_workflow", "summary": "List onboarding MCP recipes (instruction plane SoT).", "title": "Discovery Recipes", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Pass recipe filter (domain, tag) or options.recipe_id — not discovery.list domain/q filters.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "recipe_not_found": "Unknown recipe_id — discovery.describe the recipe or discovery.search workflow playbooks.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate before listing named recipes for agentstack.execute recipe_id.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Onboarding subset of recipes — full registry GET /mcp/recipes or discovery.search. Execute via options.recipe_id on agentstack.execute; recipes are not discovery.describe actions. Tenant business assi", "write_mode": null}, {"action": "discovery.domain", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.domain", "related_tools": ["discovery.search", "discovery.describe"], "returns": {"instruction_packet": "object — hoisted step contract (allowed_actions, step_id, goal_verification)", "observed": "object — inverse slots echoed when passed in params", "recommended_actions": "array", "response_mode": "string — workflow when goal router selects a playbook", "routed_goal": "object — intent_id / primary_action from goal resolution", "selected_workflow": "object — playbook shell; slots.instruction_packet when response_mode=workflow", "semantic_contract": "object — fingerprinted goal facets (effect_constraints, forbidden_concepts)"}, "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Domain"}, "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"domain_required": "Pass domain= for discovery.domain (e.g. crm, storage, knowledge)."}, "examples": [{"name": "Single-domain catalog slice", "request": {"params": {"domain": "generation", "limit": 20, "project_id": 1}, "tool": "discovery.domain"}, "response": {"data": {"actions": [{"action": "generation.promote", "domain": "generation"}]}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Browse one catalog domain without the full catalog — compact path shared with discovery.search. Req…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.search", "discovery.describe"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_domain", "semantic_input_mode": "inherit_workflow", "summary": "List actions in one catalog domain (wrapper over discovery.search).", "title": "Discovery Domain", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "domain_required": "Pass domain= for discovery.domain (e.g. crm, storage, knowledge).", "invalid_parameters": "Pass domain= for discovery.domain (e.g. crm, storage, knowledge).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Browse one catalog domain without the full catalog — compact path shared with discovery.search. Requires domain= (e.g. crm, generation, storage); then discovery.describe on a canonical action id.", "write_mode": null}, {"action": "discovery.search", "aliases": ["actions.search", "catalog.search", "discovery.search_actions", "help"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.search", "recovery_blocks": {"work_next_hydrate_failed": {"next_actions": [{"action": "agents.work_next", "params": {"repair": true}}], "reason": "work_next_hydrate_failed"}}, "related_tools": ["agents.work_next", "discovery.describe", "discovery.list", "discovery.status", "discovery.recipes", "preflight.check", "shop.enablement.status", "payments.list_methods"], "returns": {"instruction_packet": "object — hoisted step contract (allowed_actions, step_id, goal_verification)", "observed": "object — inverse slots echoed when passed in params", "recommended_actions": "array", "response_mode": "string — workflow when goal router selects a playbook", "routed_goal": "object — intent_id / primary_action from goal resolution", "selected_workflow": "object — playbook shell; slots.instruction_packet when response_mode=workflow", "semantic_contract": "object — fingerprinted goal facets (effect_constraints, forbidden_concepts)"}, "semantic_input_mode": "per_step_nl", "source": "overlay", "title": "Discovery Search"}, "do_not_use_when": "Do not call until context.project_id is bound. Do not call when agents.work_next packet.next_action is present — run that action first.", "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "effect_kind": "read", "errors": {"batch_semantic_anchor_conflict": "Align step NL with batch goal anchor — use one goal_text for the batch or split batches", "batch_semantic_anchor_required": "Batch includes a mutating or non-plain-read step: set options.execution_intent=direct for authorized CRUD, or options.goal, focus_node_id, or plan_execute_mode for workflow. Plain reads and validate_only (e.g. script.put) may run without goal. Use preflight.check simulate_batch_actions + simulate_batch_params (or execution_intent) to preview anchor.", "batch_semantic_goal_mismatch": "Step discovery.search q diverges from the batch goal — align q with options.goal_text, omit the goal, or run the search in its own execute. The server compares them whether or not semantic_strict is set.", "conflicting_semantic_anchor": "Alias for batch_semantic_anchor_conflict — align step NL with batch options.goal", "discovery_contract_conflict": "Compiled discovery contract blocked this query — read execution_contract.violations, forbidden_actions, and semantic_contract; fix NL anchor or run discovery.describe on allowed_actions[0] only. Do not execute actions outside instruction_packet.", "discovery_search_failed": "discovery.search failed after ranking — retry once with a narrower q; read discovery_stage_failed and X-Trace-Id in logs; do not parallel-spam discovery.search.", "discovery_search_recursion": "Unified discovery graph exceeded depth — narrow q, use discovery.describe on one action id, or split into another execute (do not retry the same query blob). Playbook: docs/operations/MCP_CLIENT_MISUSE_PLAYBOOK.md", "discovery_search_reentrant": "Nested discovery.search in one execute — at most one search per batch; reuse actions[] from the first result, then discovery.describe.", "discovery_search_truncated": "Discovery graph depth or duplicate query — narrow q, use discovery.describe on one canonical action id, or split into another execute.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Unknown or empty discovery params — use q= / query= / intent= for NL search; prefix= is aliased to domain= when it is a single token. Run discovery.describe on one canonical action id after a single discovery.search.", "missing_project": "Bind context.project_id — workspace switcher or agents.work_next with project scope.", "no_match": "Broaden q or use discovery.list domain= — no_match is not a missing product", "node_scope_empty": "Bind context.project_id — workspace switcher or agents.work_next with project scope.", "semantic_contract_fingerprint_required": "Omit client semantic_contract blobs unless you implement the fingerprint contract — prefer options.goal_text on the batch or a plain discovery.search q= without semantic_contract.", "session_setup_required": "Run agentstack_session_setup — bind context.project_id before domain search", "validation_error": "Fix params against discovery.describe schema — discovery.search uses q= (natural language), not prefix= unless the tool schema documents prefix. Negative example: prefix=hosting.git → validation_error; use q=hosting git journal instead.", "work_next_hydrate_failed": "Work-graph hydrate failed during discovery — run agents.work_next with repair=true and detail=compact; narrow discovery.search q or retry without scope=node hydrate.", "work_next_next_action_present": "Packet has next_action — run agents.work_next / follow prefer_action before catalog search; WG-SLO-04 compliance. Audit batches: loop_mode=audit or allow_catalog_while_next_action."}, "examples": [{"name": "NL query with slim contract fast-path", "request": {"params": {"project_id": 1, "q": "view analytics dashboard", "semantic_contract": {"effect_constraints": ["read_only"], "fingerprint": "example-fp-discovery", "primary_intent": "analytics.view"}}, "tool": "discovery.search"}, "response": {"data": {"discovery_resolution": {"primary_intent": "analytics.view"}, "semantic_contract": {"fingerprint": "example-fp-discovery"}}, "success": true}}, {"name": "Tenant IAP buyer NL search", "request": {"params": {"limit": 8, "project_id": 1444, "q": "visitor in-app purchase checkout game store", "schemas_mode": "none"}, "tool": "discovery.search"}, "response": {"data": {"ranking_mode": "tenant_iap_intent_lock", "recommended_recipe": "mcp_tenant_iap_checkout_v1"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Full plane map: agentstack://planes. Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; pri…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_map_resource": "agentstack://planes", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "recipe_id": "mcp_platform_flows_v1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["agents.work_next", "discovery.describe", "discovery.list", "discovery.status", "discovery.recipes", "preflight.check", "shop.enablement.status", "payments.list_methods"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_search", "semantic_input_mode": "per_step_nl", "summary": "Compact catalog search — returns ≤50 matching actions (not full discovery.list). Rows omit JSON schemas unless schemas_mode is set. Instruction text is one locale.", "team_create_rank_policy": "Team-create goals (agents.team.create): discovery rank demotes integrations.* — prefer agents.team.create / agents.orchestrate / agents.plan_* over integrations.oauth_begin.", "title": "Discovery Search", "when_blocked": {"batch_semantic_anchor_conflict": "Align step NL with batch goal anchor — use one goal_text for the batch or split batches", "batch_semantic_anchor_required": "Batch includes a mutating or non-plain-read step: set options.execution_intent=direct for authorized CRUD, or options.goal, focus_node_id, or plan_execute_mode for workflow. Plain reads and validate_only (e.g. script.put) may run without goal. Use preflight.check simulate_batch_actions + simulate_batch_params (or execution_intent) to preview anchor.", "batch_semantic_goal_mismatch": "Step discovery.search q diverges from the batch goal — align q with options.goal_text, omit the goal, or run the search in its own execute. The server compares them whether or not semantic_strict is set.", "conflicting_semantic_anchor": "Alias for batch_semantic_anchor_conflict — align step NL with batch options.goal", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "discovery_contract_conflict": "Compiled discovery contract blocked this query — read execution_contract.violations, forbidden_actions, and semantic_contract; fix NL anchor or run discovery.describe on allowed_actions[0] only. Do not execute actions outside instruction_packet.", "discovery_search_failed": "discovery.search failed after ranking — retry once with a narrower q; read discovery_stage_failed and X-Trace-Id in logs; do not parallel-spam discovery.search.", "discovery_search_recursion": "Unified discovery graph exceeded depth — narrow q, use discovery.describe on one action id, or split into another execute (do not retry the same query blob). Playbook: docs/operations/MCP_CLIENT_MISUSE_PLAYBOOK.md", "discovery_search_reentrant": "Nested discovery.search in one execute — at most one search per batch; reuse actions[] from the first result, then discovery.describe.", "discovery_search_truncated": "Discovery graph depth or duplicate query — narrow q, use discovery.describe on one canonical action id, or split into another execute.", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Unknown or empty discovery params — use q= / query= / intent= for NL search; prefix= is aliased to domain= when it is a single token. Run discovery.describe on one canonical action id after a single discovery.search.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_project": "Bind context.project_id — workspace switcher or agents.work_next with project scope.", "no_match": "Broaden q or use discovery.list domain= — no_match is not a missing product", "node_scope_empty": "Bind context.project_id — workspace switcher or agents.work_next with project scope.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "semantic_contract_fingerprint_required": "Omit client semantic_contract blobs unless you implement the fingerprint contract — prefer options.goal_text on the batch or a plain discovery.search q= without semantic_contract.", "session_setup_required": "Run agentstack_session_setup — bind context.project_id before domain search", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix params against discovery.describe schema — discovery.search uses q= (natural language), not prefix= unless the tool schema documents prefix. Negative example: prefix=hosting.git → validation_error; use q=hosting git journal instead.", "work_next_hydrate_failed": "Work-graph hydrate failed during discovery — run agents.work_next with repair=true and detail=compact; narrow discovery.search q or retry without scope=node hydrate.", "work_next_next_action_present": "Packet has next_action — run agents.work_next / follow prefer_action before catalog search; WG-SLO-04 compliance. Audit batches: loop_mode=audit or allow_catalog_while_next_action."}, "when_not_to_use": "Do not call until context.project_id is bound. Do not call when agents.work_next packet.next_action is present — run that action first.", "when_to_use": "After VPS backend restart, first agents.work_next may fail while MCP tools import — wait ~15s and retry once (not a plan graph bug). Bound project: agents.work_next (recipe mcp_work_loop_v1) before ca", "write_mode": null}, {"action": "discovery.describe", "aliases": ["actions.describe", "actions.describe_action", "actions.get_schema", "actions.schema", "agents.describe", "agents.describe_action", "agents.get_schema", "discovery.action", "discovery.action_info", "discovery.action_schema", "discovery.describe_action", "discovery.get", "discovery.get_action", "discovery.get_tool", "meta.describe", "system.describe_tool"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.describe", "related_tools": ["discovery.describe_many", "discovery.list", "preflight.check", "discovery.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Describe"}, "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"action_not_found": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "action_required": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "auth_required": "Authenticate first: MCP OAuth Connect (PKCE), Device Code (/api/oauth2/device/authorize), MCP auth.login, or X-API-Key. oauth-token accepts authorization_code and refresh_token only. Then GET /mcp/prompts/get?name=agentstack_session_setup.", "invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "unauthorized": "Authenticate first. GPT chat connector (chatgpt.com/connector/oauth), chat settings (chatgpt.com/backend-api/oauth/callback), and Apps plugin (platform.openai.com/apps-manage/oauth) finish when document GET oauth-authorize returns 302 to redirect_uri with code and state. IDE plugins: Device Code or Connect; programmatic: MCP auth.login or X-API-Key Bearer on POST /mcp. Dual headers: valid X-API-Key wins; placeholder ${…} in X-API-Key is skipped so OAuth Bearer applies. oauth-token is not for user password — use auth.login or Connect. Then GET /mcp/prompts/get?name=agentstack_session_setup (auth -> project -> context.project_id). MCP OAuth Connect often binds JWT project_id=1 — set context.project_id to your tenant (e.g. 1444) on every execute batch; use auth.get_profile session_ready before graph reads."}, "examples": [{"name": "Slim schema lookup before execute", "request": {"params": {"action": "agents.plan_get", "descriptor": "slim", "expand": ["schema"]}, "tool": "discovery.describe"}, "response": {"data": {"action": "agents.plan_get", "capability_descriptor_slim": {"action": "agents.plan_get"}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discov…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.describe_many", "discovery.list", "preflight.check", "discovery.search"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_describe", "semantic_input_mode": "inherit_workflow", "summary": "Schema and instruction_slice for one action, in the request locale. Default descriptor is slim. descriptor=full attaches the runtime CapabilityDescriptor (inputSchema/outputSchema only when expand inc", "title": "Discovery Describe", "when_blocked": {"action_not_found": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "action_required": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "auth_required": "Authenticate first: MCP OAuth Connect (PKCE), Device Code (/api/oauth2/device/authorize), MCP auth.login, or X-API-Key. oauth-token accepts authorization_code and refresh_token only. Then GET /mcp/prompts/get?name=agentstack_session_setup.", "batch_semantic_anchor_required": "Set options.execution_intent=direct for one read/CRUD, or options.goal / focus_node_id for multi-step batches — see MCP_CLIENT_MISUSE_PLAYBOOK.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "domain_required": "Pass domain= for discovery.domain (e.g. crm, storage, knowledge).", "hosted_app_required": "Mint hosted_app session cookie — not operator MCP Bearer on /s/{pid}/mcp.", "hosted_cookie_missing": "Visitor /s/{pid}/ uses hosted session cookie — not operator MCP Bearer. Use POST /api/hosted-apps/{pid}/session after page login.", "hosted_project_mismatch": "Align cookie project_id, X-Hosted-App-Path, and step params.project_id.", "hosted_step_project_id_invalid": "Step project_id must be an integer matching the storefront pid.", "hosted_step_project_id_required": "Each hosted batch step needs integer params.project_id (SDK mcpBatchStep).", "invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestration_step_violation": "Follow agents.work_next packet.next_action; do not nest off-spine mutations. Use agents.plan_reclaim_stale then work_next if leases expired.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "server_busy": "Event-loop lag — backoff and use discovery.summary instead of discovery.list full_catalog=true.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate first. GPT chat connector (chatgpt.com/connector/oauth), chat settings (chatgpt.com/backend-api/oauth/callback), and Apps plugin (platform.openai.com/apps-manage/oauth) finish when document GET oauth-authorize returns 302 to redirect_uri with code and state. IDE plugins: Device Code or Connect; programmatic: MCP auth.login or X-API-Key Bearer on POST /mcp. Dual headers: valid X-API-Key wins; placeholder ${…} in X-API-Key is skipped so OAuth Bearer applies. oauth-token is not for user password — use auth.login or Connect. Then GET /mcp/prompts/get?name=agentstack_session_setup (auth -> project -> context.project_id). MCP OAuth Connect often binds JWT project_id=1 — set context.project_id to your tenant (e.g. 1444) on every execute batch; use auth.get_profile session_ready before graph reads.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use", "write_mode": null}, {"action": "discovery.describe_many", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1", "core.mcp.self_description.gen1"], "id": "discovery.describe_many", "related_tools": ["discovery.describe", "discovery.list", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Describe Many"}, "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"action_not_found": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "action_required": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "actions_required": "discovery.describe_many requires actions=[...] with 1–6 canonical MCP ids (deduped in order). Default descriptor=slim — same wire as discovery.describe per row.", "auth_required": "Authenticate first: MCP OAuth Connect (PKCE), Device Code (/api/oauth2/device/authorize), MCP auth.login, or X-API-Key. oauth-token accepts authorization_code and refresh_token only. Then GET /mcp/prompts/get?name=agentstack_session_setup.", "invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "unauthorized": "Authenticate first. GPT chat connector (chatgpt.com/connector/oauth), chat settings (chatgpt.com/backend-api/oauth/callback), and Apps plugin (platform.openai.com/apps-manage/oauth) finish when document GET oauth-authorize returns 302 to redirect_uri with code and state. IDE plugins: Device Code or Connect; programmatic: MCP auth.login or X-API-Key Bearer on POST /mcp. Dual headers: valid X-API-Key wins; placeholder ${…} in X-API-Key is skipped so OAuth Bearer applies. oauth-token is not for user password — use auth.login or Connect. Then GET /mcp/prompts/get?name=agentstack_session_setup (auth -> project -> context.project_id). MCP OAuth Connect often binds JWT project_id=1 — set context.project_id to your tenant (e.g. 1444) on every execute batch; use auth.get_profile session_ready before graph reads."}, "examples": [{"name": "Copilot allowed-action effect batch", "request": {"params": {"actions": ["agents.plan_get", "agents.work_next"], "descriptor": "slim"}, "tool": "discovery.describe_many"}, "response": {"data": {"count": 2, "descriptor": "slim", "rows": []}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Batch slim describe for Copilot / UI: pass actions=[...] (≤6 ids) once instead of parallel discover…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.describe", "discovery.list", "preflight.check"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_describe_many", "semantic_input_mode": "inherit_workflow", "summary": "Slim discovery.describe for up to six canonical action ids in one read. Default descriptor=slim — same projection as discovery.describe per row.", "title": "Discovery Describe Many", "when_blocked": {"action_not_found": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "action_required": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "actions_required": "discovery.describe_many requires actions=[...] with 1–6 canonical MCP ids (deduped in order). Default descriptor=slim — same wire as discovery.describe per row.", "auth_required": "Authenticate first: MCP OAuth Connect (PKCE), Device Code (/api/oauth2/device/authorize), MCP auth.login, or X-API-Key. oauth-token accepts authorization_code and refresh_token only. Then GET /mcp/prompts/get?name=agentstack_session_setup.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate first. GPT chat connector (chatgpt.com/connector/oauth), chat settings (chatgpt.com/backend-api/oauth/callback), and Apps plugin (platform.openai.com/apps-manage/oauth) finish when document GET oauth-authorize returns 302 to redirect_uri with code and state. IDE plugins: Device Code or Connect; programmatic: MCP auth.login or X-API-Key Bearer on POST /mcp. Dual headers: valid X-API-Key wins; placeholder ${…} in X-API-Key is skipped so OAuth Bearer applies. oauth-token is not for user password — use auth.login or Connect. Then GET /mcp/prompts/get?name=agentstack_session_setup (auth -> project -> context.project_id). MCP OAuth Connect often binds JWT project_id=1 — set context.project_id to your tenant (e.g. 1444) on every execute batch; use auth.get_profile session_ready before graph reads.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Batch slim describe for Copilot / UI: pass actions=[...] (≤6 ids) once instead of parallel discovery.describe. Same descriptor= and expand= apply to every row.", "write_mode": null}, {"action": "discovery.instruction_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.instruction_get", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Discovery Instruction Get"}, "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "unauthorized": "Authenticate (Bearer or API key) before catalog list"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "When agentstack://instructions/* or /mcp/prompts/get URLs must be resolved via execute.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_surfaces": [], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_instruction_get", "semantic_input_mode": "inherit_workflow", "summary": "Fetch MCP instruction/playbook text by id (read-only).", "title": "Discovery Instruction Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "discovery.describe requires action=<canonical MCP id> (e.g. agents.plan_get). Without an id: discovery.list first (when the mistyped id's first segment matches a known MCP family, add domain= and use limit≤25; if domain cannot be inferred, omit domain= and use limit≤40), then discovery.describe with that exact id. Goal-anchored execute batches: avoid discovery.search here (batch_semantic_anchor_conflict) — split into another execute or use list without per-step q=.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "When agentstack://instructions/* or /mcp/prompts/get URLs must be resolved via execute.", "write_mode": null}, {"action": "discovery.job_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not poll agents.run / run_uuid here — use agents.run_get with run_id from agents.run.", "anti_patterns": ["Do not poll agents.run / run_uuid here — use agents.run_get with run_id from agents.run.", "job_id is only from agentstack.execute with options.async=true."], "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.job_status", "related_tools": ["discovery.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Discovery Job Status"}, "domain_title": "Discovery MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "Job scoped to enqueue owner only", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "not_found": "Unknown job_id — re-check async handoff job_id", "unauthorized": "Authenticate (Bearer or API key) before catalog list"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "After options.async execute returns job_id; poll until status is completed or failed.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "owner_gene": "core.mcp.discovery.gen1", "plane": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "plane_chooser": "Do not pick tools from catalog when packet.next_action is present. Find tools: discovery.search q=. no_match is not a missing product. response_mode=workflow → follow actions[] / step_actions order; primary_action pins workflow step 0. One tool: discovery.describe action=. Atlas: mcp_platform_flows_v1. Do not invent a tool name.", "platform_atoms": {"DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools."}, "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.search"], "requires_preflight": false, "risk_class": "read", "safe_action": "discovery_job_status", "semantic_input_mode": "inherit_workflow", "summary": "Poll an async agentstack.execute job (options.async=true). Cheap. Use after a multi-step heavy batch; do not re-run bots.simulate to check status.", "title": "Discovery Job Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Job scoped to enqueue owner only", "invalid_cursor": "Catalog cursor must be a non-negative integer offset into the filtered list — omit cursor or use 0 to restart; do not reuse stale cursors after q or filters change. Walk pages with discovery.list (see npm run audit:mcp-catalog-walk).", "invalid_parameters": "Fix filter params — domain= or q= for discovery.list; schemas_mode public|full", "job_id_required": "Async jobs need job_id from enqueue receipt — discovery.job_status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Unknown job_id — re-check async handoff job_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "surface_catalog_missing": "Platform surface audit JSON missing — run platform surface audit / deploy with docs/dual-shell/_generated/platform-surface-audit.json", "surface_catalog_unreadable": "platform-surface-audit.json unreadable — regenerate audit (invalid JSON or permissions)", "unauthorized": "Authenticate (Bearer or API key) before catalog list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After options.async execute returns job_id; poll until status is completed or failed.", "write_mode": null}], "dna": [{"action": "dna.lineage.get_ancestors", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "dna", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.dna.lineage.gen1"], "id": "dna.lineage.get_ancestors", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Dna Lineage Get Ancestors"}, "domain_title": "Dna Lineage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["shared.dna.lineage.gen1"], "instruction_hint": "8DNA ancestor chain for sandbox/prod lineage triage.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.dna_lineage", "owner_gene": "shared.dna.lineage.gen1", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "required_cap": "8dna.read", "requires_preflight": false, "risk_class": "read", "safe_action": "dna_lineage_get_ancestors", "semantic_input_mode": "inherit_workflow", "summary": "Walk ancestor chain for an 8DNA row (materialized path or scoped CTE fallback).", "title": "Dna Lineage Get Ancestors", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "8DNA ancestor chain for sandbox/prod lineage triage.", "write_mode": null}, {"action": "dna.lineage.get_descendants", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "dna", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.dna.lineage.gen1"], "id": "dna.lineage.get_descendants", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Dna Lineage Get Descendants"}, "domain_title": "Dna Lineage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["shared.dna.lineage.gen1"], "instruction_hint": "List child generations under parent UUID.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.dna_lineage", "owner_gene": "shared.dna.lineage.gen1", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "required_cap": "8dna.read", "requires_preflight": false, "risk_class": "read", "safe_action": "dna_lineage_get_descendants", "semantic_input_mode": "inherit_workflow", "summary": "List descendant rows under a parent UUID within project scope.", "title": "Dna Lineage Get Descendants", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List child generations under parent UUID.", "write_mode": null}], "docs": [{"action": "docs.schema.define", "ai_tips": "Before docs.analyze — store product_photo.v1 or custom extract schemas per project", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Unconditional DNA write to ecosystem.docs.schemas (not param-gated)", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.vision.domain.gen1"], "id": "docs.schema.define", "mutation_risk": "low", "read_paths": ["ecosystem.docs.schemas"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Docs Schema Define", "write_paths": ["ecosystem.docs.schemas"]}, "domain_title": "Docs Schema MCP domain", "effect": {"conditional_mutate": "Unconditional DNA write to ecosystem.docs.schemas (not param-gated)", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Unconditional DNA write to ecosystem.docs.schemas (not param-gated)", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.docs_schema.gen1"], "instruction_hint": "Before docs.analyze — store product_photo.v1 or custom extract schemas per project", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.docs_schema", "owner_gene": "core.mcp.docs_schema.gen1", "read_paths": ["ecosystem.docs.schemas"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "docs_schema_define", "semantic_input_mode": "inherit_workflow", "summary": "Register or update a versioned JSON schema document in project DNA.", "title": "Docs Schema Define", "when_to_use": "Before docs.analyze — store product_photo.v1 or custom extract schemas per project", "write_mode": null, "write_paths": ["ecosystem.docs.schemas"]}, {"action": "docs.schema.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.docs.gen1"], "id": "docs.schema.list", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Docs Schema List"}, "domain_title": "Docs Schema MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.docs_schema.gen1"], "instruction_hint": "Discover schema_id before docs.analyze or vision.extract", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.docs_schema", "owner_gene": "core.mcp.docs_schema.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "docs_schema_list", "semantic_input_mode": "inherit_workflow", "summary": "List schema ids registered under ecosystem.docs.schemas.", "title": "Docs Schema List", "when_to_use": "Discover schema_id before docs.analyze or vision.extract", "write_mode": null}, {"action": "docs.analyze", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.docs.gen1"], "id": "docs.analyze", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Docs Analyze"}, "domain_title": "Docs Schema MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.docs_schema.gen1"], "instruction_hint": "Pre-flight structured docs before vision.extract or commerce asset metadata", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.docs_schema", "owner_gene": "core.mcp.docs_schema.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "docs_analyze", "semantic_input_mode": "inherit_workflow", "summary": "Validate a JSON payload against a registered docs.schema (structural check).", "title": "Docs Analyze", "when_to_use": "Pre-flight structured docs before vision.extract or commerce asset metadata", "write_mode": null}, {"action": "docs.schema.delete", "ai_tips": "Drop obsolete schema_id (e.g. probe leaves) before re-defining docs.schema.", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.docs.gen1"], "id": "docs.schema.delete", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Docs Schema Delete"}, "domain_title": "Docs Schema MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.docs_schema.gen1"], "instruction_hint": "Drop obsolete schema_id (e.g. probe leaves) before re-defining docs.schema.", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.docs_schema", "owner_gene": "core.mcp.docs_schema.gen1", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "required_cap": "mcp_write", "requires_preflight": true, "risk_class": "destructive", "safe_action": "docs_schema_delete", "semantic_input_mode": "inherit_workflow", "summary": "Remove a registered docs schema leaf from project DNA.", "title": "Docs Schema Delete", "when_blocked": {"preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps)."}, "when_to_use": "Drop obsolete schema_id (e.g. probe leaves) before re-defining docs.schema.", "write_mode": null}], "docs_nav": [{"action": "docs_nav.resolve", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.engineering.ai_navigation.gen1"], "id": "docs_nav.resolve", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Docs Nav Resolve"}, "domain_title": "Docs Nav MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["repo.engineering.ai_navigation.gen1"], "instruction_hint": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.docs_nav", "owner_gene": "repo.engineering.ai_navigation.gen1", "plane": "Gene map only: docs_nav.search query=. Runtime tools: discovery.search.", "plane_chooser": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools.", "platform_atoms": {"BATCH_DEPENDS_ON_DEFAULTS": "agentstack.execute steps: omit dependsOn for independent lanes; set dependsOn to prior step ids for DAG order. continueOnError defaults false — failed step skips dependents (plain reads may continue per mixed-batch policy). See agentstack-work-graph skill.", "DEPLOY_SUBSTRATE_SKEW": "After VPS ship, MCP batches may return preflight_batch_internal_error when hot-sync manifest omits import mates (e.g. shared/mcp/session_readiness.py). Recovery: npm run audit:deploy-hot-sync-manifests, mcp.prod_matrix_hot_sync, or -RebuildBackend (default DeployComponent=backend). Not OAuth Connect until auth.get_profile fails.", "DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools.", "PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "requires_preflight": false, "risk_class": "read", "safe_action": "docs_nav_resolve", "semantic_input_mode": "inherit_workflow", "summary": "Resolve a genetic navigation tag to AI_INDEX path(s) from TAG_CATALOG. For code/docs navigation only — for runtime MCP tools use discover/by_intent.", "title": "Docs Nav Resolve", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Docs-navigation surface only — not agentstack.execute routing. Use discovery.search for runnable MCP actions.", "when_to_use": "Resolve genetic tag to AI_INDEX path — not MCP tool routing.", "write_mode": null}, {"action": "docs_nav.search", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "docs", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.engineering.ai_navigation.gen1"], "id": "docs_nav.search", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Docs Nav Search"}, "domain_title": "Docs Nav MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["repo.engineering.ai_navigation.gen1"], "instruction_hint": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.docs_nav", "owner_gene": "repo.engineering.ai_navigation.gen1", "plane": "Gene map only: docs_nav.search query=. Runtime tools: discovery.search.", "plane_chooser": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools.", "platform_atoms": {"BATCH_DEPENDS_ON_DEFAULTS": "agentstack.execute steps: omit dependsOn for independent lanes; set dependsOn to prior step ids for DAG order. continueOnError defaults false — failed step skips dependents (plain reads may continue per mixed-batch policy). See agentstack-work-graph skill.", "DEPLOY_SUBSTRATE_SKEW": "After VPS ship, MCP batches may return preflight_batch_internal_error when hot-sync manifest omits import mates (e.g. shared/mcp/session_readiness.py). Recovery: npm run audit:deploy-hot-sync-manifests, mcp.prod_matrix_hot_sync, or -RebuildBackend (default DeployComponent=backend). Not OAuth Connect until auth.get_profile fails.", "DOCS_NAV_NOT_MCP_TOOLS": "Runtime: discovery.search, discovery.list, POST /mcp/discover/by_intent. docs_nav.search = markdown/genetic docs routing only — not MCP tools.", "PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "requires_preflight": false, "risk_class": "read", "safe_action": "docs_nav_search", "semantic_input_mode": "inherit_workflow", "summary": "BM25-lite search over AI navigation catalog (map/index triggers). Returns genetic tags + AI_INDEX paths. Not for selecting runtime MCP tools.", "title": "Docs Nav Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Docs-navigation surface only — not agentstack.execute routing. Use discovery.search for runnable MCP actions.", "when_to_use": "Docs-nav BM25 only — runtime tools: discover/by_intent or /mcp/actions.", "write_mode": null}], "ecosystem": [{"action": "ecosystem.metrics.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.ecosystem.gen1"], "id": "ecosystem.metrics.get", "related_tools": ["analytics.project_snapshot", "analytics.platform_snapshot"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Ecosystem Metrics Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read ecosystem.metrics DNA leaf for a project (admin). Not the hosted analytics BFF.", "mutation_kind": "none", "related_tools": ["analytics.project_snapshot", "analytics.platform_snapshot"], "required_cap": "admin.read", "requires_preflight": false, "risk_class": "read", "safe_action": "ecosystem_metrics_get", "semantic_input_mode": "inherit_workflow", "summary": "Read ecosystem.metrics leaf paths for a project (admin). Parameterized by project_id.", "title": "Ecosystem Metrics Get", "when_to_use": "Read ecosystem.metrics DNA leaf for a project (admin). Not the hosted analytics BFF.", "write_mode": null}], "energy": [{"action": "energy.get_balance", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not treat balance check as a billed LLM completion.", "anti_patterns": ["Do not treat balance check as a billed LLM completion.", "Balance does not decrease until an LLM call completes — multi-step agents.run debits per call."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.energy.gen1"], "id": "energy.get_balance", "related_tools": ["energy.list_packs", "ai.providers.list", "energy.purchase"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Energy Get Balance"}, "domain_title": "Energy MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile."}, "examples": [{"project_id": 1444, "refresh": false}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.energy.gen1", "core.economy.llm_energy.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "LLM prepaid energy before heavy knowledge/agents runs.", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["energy.list_packs", "agents.run", "ai.providers.list"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.energy", "owner_gene": "core.mcp.energy.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "related_tools": ["energy.list_packs", "ai.providers.list", "energy.purchase"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "energy_get_balance", "semantic_input_mode": "inherit_workflow", "summary": "LLM prepaid energy balance for user or project pool.", "title": "Energy Get Balance", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "LLM prepaid energy before heavy knowledge/agents runs.", "write_mode": null}, {"action": "energy.list_packs", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not call list_packs on every agents.run — reuse get_balance tiers.", "anti_patterns": ["Do not call list_packs on every agents.run — reuse get_balance tiers."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.energy.gen1"], "id": "energy.list_packs", "related_tools": ["energy.get_balance", "energy.purchase"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Energy List Packs"}, "domain_title": "Energy MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.energy.gen1", "core.economy.llm_energy.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "List purchasable energy packs and USD prices.", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["energy.purchase", "energy.get_balance", "payments.create"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.energy", "owner_gene": "core.mcp.energy.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "related_tools": ["energy.get_balance", "energy.purchase"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "energy_list_packs", "semantic_input_mode": "inherit_workflow", "summary": "Available LLM energy pack tiers (small/medium/large) and USD prices.", "title": "Energy List Packs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List purchasable energy packs and USD prices.", "write_mode": null}, {"action": "energy.purchase", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not use energy.purchase for card checkout — use payments.create intent=energy_pack.", "anti_patterns": ["Do not use energy.purchase for card checkout — use payments.create intent=energy_pack."], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.energy.gen1"], "id": "energy.purchase", "related_tools": ["finance.pay.quote", "finance.pay.execute", "energy.list_packs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Energy Purchase"}, "domain_title": "Energy MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "use_payments_create": "Card checkout: payments.create intent=energy_pack, poll payments.get — not energy.purchase external_card. Next: payments.list_methods."}, "examples": [{"amount": 4.99, "idempotency_key": "energy-pack-…", "pack_tier": "small", "source": {"kind": "personal_wallet", "wallet_id": "…"}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.energy.gen1", "core.economy.llm_energy.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Buy an LLM energy pack from a wallet with finance.pay. Card is payments.create intent=energy_pack, …", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["energy.list_packs", "finance.pay.quote", "energy.get_balance"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.energy", "owner_gene": "core.mcp.energy.gen1", "plane": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "plane_chooser": "Usage: analytics.get_usage. Energy: energy.get_balance. Scan: diagnostics.consistency.scan. Operator hub (not tenant apps): hub-snapshot If-None-Match 304; /capabilities/flags vs /capabilities/observability; problems_summary before full problems.", "related_tools": ["finance.pay.quote", "finance.pay.execute", "energy.list_packs"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "energy_purchase", "semantic_input_mode": "inherit_workflow", "summary": "Buy an LLM energy pack from a wallet with finance.pay. Card is payments.create intent=energy_pack, then poll payments.get until wallet_credit=ok.", "title": "Energy Purchase", "when_blocked": {"auth_required": "MCP session needs operator user_id — auth.get_profile then retry. Next: auth.get_profile.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "use_payments_create": "Card checkout: payments.create intent=energy_pack, poll payments.get — not energy.purchase external_card. Next: payments.list_methods."}, "when_to_use": "Buy an LLM energy pack from a wallet with finance.pay. Card is payments.create intent=energy_pack, then poll payments.get until wallet_credit=ok.", "write_mode": null}], "finance": [{"action": "finance.portfolio", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.portfolio", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Portfolio"}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "User finance hub aggregate (personal rails).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Open a wallet, then deposit in the next recipe with the copied wallet_id. This is the business status read. Do not call thirty raw payment tools. For shop order_id status use shop.orders.get — not this atom.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_portfolio", "semantic_input_mode": "inherit_workflow", "summary": "User finance portfolio aggregate (three rails + JSON wallets).", "title": "Finance Portfolio", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "User finance hub aggregate (personal rails).", "write_mode": null}, {"action": "finance.activity", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.activity", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Activity"}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Unified wallet activity feed for user.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Open a wallet, then deposit in the next recipe with the copied wallet_id. This is the business status read. Do not call thirty raw payment tools. For shop order_id status use shop.orders.get — not this atom.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_activity", "semantic_input_mode": "inherit_workflow", "summary": "Unified wallet activity feed.", "title": "Finance Activity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Unified wallet activity feed for user.", "write_mode": null}, {"action": "finance.project.portfolio", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.finance.user_read_model.gen1"], "id": "finance.project.portfolio", "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Finance Project Portfolio"}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"project_id": 123}, "example_request": {"action": "finance.project.portfolio", "params": {"project_id": 123}}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Project treasury + operating balances.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "AgentNet proofs stay on agentnet.*.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "payments|agentcoin", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_project_portfolio", "semantic_input_mode": "inherit_workflow", "summary": "Project business portfolio (operating + treasury + AGNT).", "title": "Finance Project Portfolio", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Project treasury + operating balances.", "write_mode": null}, {"action": "finance.dashboard_bundle", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not substitute dashboard_bundle for Profile subscription UI — shape differs.", "anti_patterns": ["Do not substitute dashboard_bundle for Profile subscription UI — shape differs.", "Do not use for checkout; use payments.*."], "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.dashboard_bundle", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Dashboard Bundle"}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Operator/agent finance hub snapshot (KPI bundle). For merged tier limits after buffs use buffs.get_…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Open a wallet, then deposit in the next recipe with the copied wallet_id. This is the business status read. Do not call thirty raw payment tools. For shop order_id status use shop.orders.get — not this atom.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_dashboard_bundle", "semantic_input_mode": "inherit_workflow", "summary": "Finance hub landing aggregate (portfolio + billing_status + activity preview). MCP read model for /user|/dev finance routes — not field-for-field with REST GET /api/billing/overview (SPA subscription ", "title": "Finance Dashboard Bundle", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator/agent finance hub snapshot (KPI bundle). For merged tier limits after buffs use buffs.get_effective_limits. For full user billing overview (projects_summary, meters) use REST /api/billing/ove", "write_mode": null}, {"action": "finance.project.analytics", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.project.analytics", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Project Analytics"}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Finance dashboard KPIs and charts for workspace tenants.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "AgentNet proofs stay on agentnet.*.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_project_analytics", "semantic_input_mode": "inherit_workflow", "summary": "Project finance analytics (revenue/expense trends) for hosted vertical widgets.", "title": "Finance Project Analytics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Finance dashboard KPIs and charts for workspace tenants.", "write_mode": null}, {"action": "finance.project.fund", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.finance.user_read_model.gen1"], "id": "finance.project.fund", "related_tools": ["finance.project.portfolio", "payments.get_balance", "wallets.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Project Fund"}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"amount": 123.45, "from_wallet_id": "example_string", "idempotency_key": "example_string", "project_id": 123}, "example_request": {"action": "finance.project.fund", "params": {"amount": 123.45, "from_wallet_id": "example_string", "idempotency_key": "example_string", "project_id": 123}}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Move USD from the personal wallet on project 1 into that project's treasury wallet (data.ecosystem.…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "AgentNet proofs stay on agentnet.*.", "related_prompts": ["agentstack_project_treasury"], "related_tools": ["finance.project.portfolio", "payments.get_balance", "wallets.list"], "required_cap": "payments|project_admin", "requires_preflight": false, "risk_class": "read", "rollback": [], "safe_action": "finance_project_fund", "semantic_input_mode": "inherit_workflow", "summary": "Fund a project via ecosystem USD transfer.", "title": "Finance Project Fund", "verification": ["finance.project.portfolio", "payments.get_balance"], "verify": [{"action": "finance.project.portfolio", "predicate": "named resource is visible"}, {"action": "payments.get_balance", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move USD from the personal wallet on project 1 into that project's treasury wallet (data.ecosystem.money). Does not credit tenant data.money.", "write_mode": null}, {"action": "finance.project.contribute", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.finance.user_read_model.gen1"], "id": "finance.project.contribute", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Project Contribute"}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"amount": 123.45, "anonymous": true, "from_wallet_id": "example_string", "idempotency_key": "example_string", "message": "example_string", "project_id": 123}, "example_request": {"action": "finance.project.contribute", "params": {"amount": 123.45, "anonymous": true, "from_wallet_id": "example_string", "idempotency_key": "example_string", "message": "example_string", "project_id": 123}}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Member sends USD from their personal wallet on project 1 into that project's treasury (data.ecosyst…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "AgentNet proofs stay on agentnet.*.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "payments|project_admin", "requires_preflight": false, "risk_class": "read", "rollback": [], "safe_action": "finance_project_contribute", "semantic_input_mode": "inherit_workflow", "summary": "Member contribution: USD only from personal ecosystem wallet (project_id=1) to project treasury. Not for custom/game currencies.", "title": "Finance Project Contribute", "verification": ["finance.project.portfolio", "finance.project.contributions.list"], "verify": [{"action": "finance.project.portfolio", "predicate": "named resource is visible"}, {"action": "finance.project.contributions.list", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Member sends USD from their personal wallet on project 1 into that project's treasury (data.ecosystem.money). Does not credit tenant data.money.", "write_mode": null}, {"action": "finance.project.contributions.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.project.contributions.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Project Contributions List"}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Audit member contributions (FAP-masked).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "AgentNet proofs stay on agentnet.*.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_project_contributions_list", "semantic_input_mode": "inherit_workflow", "summary": "List member contributions for a project (FAP-masked).", "title": "Finance Project Contributions List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit member contributions (FAP-masked).", "write_mode": null}, {"action": "finance.pay.quote", "ai_tips": "Get pay quote before wallet debit or AGNT purchase.", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.pay.quote", "related_tools": ["finance.pay.execute", "wallets.list", "energy.list_packs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Pay Quote"}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Get pay quote before wallet debit or AGNT purchase.", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_project_treasury"], "related_tools": ["finance.pay.execute", "wallets.list", "energy.list_packs"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_pay_quote", "semantic_input_mode": "inherit_workflow", "summary": "Quote a unified pay intent (energy_pack, subscription, compute_credits, stackscript_fuel_pack, fund, contribute).", "title": "Finance Pay Quote", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id + amount/currency from finance.portfolio or payments.get_balance", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "quote_limit_exceeded": "Tier limits — buffs.get_effective_limits before another quote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_required": "Operator OAuth — auth.get_profile then re-quote", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get pay quote before wallet debit or AGNT purchase.", "write_mode": null}, {"action": "finance.pay.execute", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.pay.execute", "related_tools": ["finance.pay.quote", "payments.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Pay Execute"}, "domain_title": "Finance Expense MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Debit a quoted wallet for energy, subscription, checkout, fund, or contribution. Card is payments.c…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_project_treasury"], "related_tools": ["finance.pay.quote", "payments.get_balance"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "finance_pay_execute", "semantic_input_mode": "inherit_workflow", "summary": "Execute a quoted pay intent with idempotency key. Caller must own the quote.", "title": "Finance Pay Execute", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "idempotency_mismatch": "Same idempotency_key with a different quote_id or quote_hash — mint a new key", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "quote_expired": "finance.pay.quote again — the quote window closed", "quote_hash_mismatch": "quote_hash does not match the stored quote body — re-quote", "quote_not_found": "finance.pay.quote first — quote_id expired or unknown", "quote_user_mismatch": "auth.get_profile — quote belongs to another user", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Debit a quoted wallet for energy, subscription, checkout, fund, or contribution. Card is payments.create, then poll payments.get. USD and USDT land on project 1 or treasury, never tenant data.money.", "write_mode": null}, {"action": "finance.expense.create", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.expense.create", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Expense Create"}, "domain_title": "Finance Expense MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Record a project expense before finance.expense.list review.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "finance_expense_create", "semantic_input_mode": "inherit_workflow", "summary": "Create an expense row on data.money.expenses[].", "title": "Finance Expense Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Record a project expense before finance.expense.list review.", "write_mode": null}, {"action": "finance.expense.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.expense.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Expense List"}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Canonical money.expenses, not a sandbox leaf. Read coverage.stored_cap (512), coverage.truncated, a…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_expense_list", "semantic_input_mode": "inherit_workflow", "summary": "List project expenses on the canonical money.expenses leaf. Not inside a generation sandbox. Filter by date_from/date_to then limit.", "title": "Finance Expense List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Canonical money.expenses, not a sandbox leaf. Read coverage.stored_cap (512), coverage.truncated, and category_coerced.", "write_mode": null}, {"action": "finance.expense.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.expense.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Expense Delete"}, "domain_title": "Finance Expense MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Remove a mistaken expense by id from finance.expense.list.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_treasury"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "finance_expense_delete", "semantic_input_mode": "inherit_workflow", "summary": "Delete expense by id.", "title": "Finance Expense Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove a mistaken expense by id from finance.expense.list.", "write_mode": null}, {"action": "finance.revenue.record", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.revenue.record", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Revenue Record"}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "After delivering a project or manual revenue adjustment.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_revenue_record", "semantic_input_mode": "inherit_workflow", "summary": "Record paid freelancer revenue on data.money.invoices[] (EDITFLOW deal close).", "title": "Finance Revenue Record", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After delivering a project or manual revenue adjustment.", "write_mode": null}, {"action": "finance.revenue.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.revenue.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Revenue List"}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Finance page revenue list after finance.revenue.record.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "finance_revenue_list", "semantic_input_mode": "inherit_workflow", "summary": "List paid freelancer revenue rows on data.money.invoices[] (actor-scoped).", "title": "Finance Revenue List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Finance page revenue list after finance.revenue.record.", "write_mode": null}, {"action": "finance.revenue.update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.revenue.update", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Revenue Update"}, "domain_title": "Finance Expense MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Correct a mistaken revenue entry from finance.revenue.list.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "related_prompts": ["agentstack_project_treasury"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "finance_revenue_update", "semantic_input_mode": "inherit_workflow", "summary": "Update paid freelancer revenue amount or description (actor-owned).", "title": "Finance Revenue Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Correct a mistaken revenue entry from finance.revenue.list.", "write_mode": null}, {"action": "finance.revenue.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.revenue.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Finance Revenue Delete"}, "domain_title": "Finance Expense MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Remove duplicate or mistaken revenue from finance.revenue.list.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "owner_gene": "core.mcp.finance.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_treasury"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "finance_revenue_delete", "semantic_input_mode": "inherit_workflow", "summary": "Delete a paid freelancer revenue row by id (actor-owned).", "title": "Finance Revenue Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove duplicate or mistaken revenue from finance.revenue.list.", "write_mode": null}], "fundraising": [{"action": "fundraising.narrative.lint", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["docs.grants.portfolio.gen1"], "id": "fundraising.narrative.lint", "related_tools": ["fundraising.packet.compose"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Fundraising Narrative Lint"}, "domain_title": "Fundraising MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["docs.grants.portfolio.gen1"], "instruction_hint": "Before pasting grant copy or publishing a deck snippet.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.fundraising", "owner_gene": "docs.grants.portfolio.gen1", "plane": "Grant packet: fundraising.packet.compose.", "plane_chooser": "Grant packet: fundraising.packet.compose.", "related_tools": ["fundraising.packet.compose"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "fundraising_narrative_lint", "semantic_input_mode": "inherit_workflow", "summary": "Scan text for forbidden fundraising phrases from NARRATIVE_REGISTRY.yaml.", "title": "Fundraising Narrative Lint", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before pasting grant copy or publishing a deck snippet.", "write_mode": null}, {"action": "fundraising.packet.compose", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["docs.grants.portfolio.gen1"], "id": "fundraising.packet.compose", "related_tools": ["grants.compose.checklist"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Fundraising Packet Compose"}, "domain_title": "Fundraising MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["docs.grants.portfolio.gen1"], "instruction_hint": "Grant submit prep — attachment checklist for a program.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.fundraising", "owner_gene": "docs.grants.portfolio.gen1", "plane": "Grant packet: fundraising.packet.compose.", "plane_chooser": "Grant packet: fundraising.packet.compose.", "related_tools": ["grants.compose.checklist"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "fundraising_packet_compose", "semantic_input_mode": "inherit_workflow", "summary": "List attachment paths for a grant program packet (registry + evidence). Ecosystem owner only — prefer grants.compose.checklist for Grant OS CRM.", "title": "Fundraising Packet Compose", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Grant submit prep — attachment checklist for a program.", "write_mode": null}], "games": [{"action": "games.leaderboards.submit", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "games", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.games.gen1"], "id": "games.leaderboards.submit", "related_tools": ["games.leaderboards.top", "projects.patch_data"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Games Leaderboards Submit"}, "domain_title": "Games MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.games.gen1"], "instruction_hint": "Hosted or logic-driven games need a ranked board without a separate DB", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.games", "owner_gene": "core.mcp.games.gen1", "related_tools": ["games.leaderboards.top", "projects.patch_data"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "games_leaderboards_submit", "semantic_input_mode": "inherit_workflow", "summary": "Submit a score to an ecosystem.games.leaderboards board (server-side 8DNA leaf).", "title": "Games Leaderboards Submit", "when_to_use": "Hosted or logic-driven games need a ranked board without a separate DB", "write_mode": null}, {"action": "games.leaderboards.top", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.games.gen1"], "id": "games.leaderboards.top", "related_tools": ["games.leaderboards.submit", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Games Leaderboards Top"}, "domain_title": "Games MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.games.gen1"], "instruction_hint": "Poll leaderboard standings from agents or hosted clients", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.games", "owner_gene": "core.mcp.games.gen1", "related_tools": ["games.leaderboards.submit", "discovery.describe"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "games_leaderboards_top", "semantic_input_mode": "inherit_workflow", "summary": "Read top scores for a leaderboard board (plain read).", "title": "Games Leaderboards Top", "when_to_use": "Poll leaderboard standings from agents or hosted clients", "write_mode": null}], "generation": [{"action": "generation.list", "aliases": ["generation.environments", "generation.list_environments", "generation.list_envs"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not treat list_unavailable as an empty project.", "anti_patterns": ["Do not treat list_unavailable as an empty project.", "Do not pass stale generation_env_uuid — omit it and let the server keep the head."], "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.list", "related_tools": ["generation.env_snapshot", "generation.diff_vs_prod", "generation.supply_status"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation List"}, "do_not_use_when": "Not buyer checkout or script.run — sandbox catalog only. Empty list ≠ no forks; use env_snapshot on list_unavailable.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"include_gates": true, "include_status": "all", "include_supply": false, "project_id": 123}, "example_request": {"action": "generation.list", "params": {"include_gates": true, "include_status": "all", "include_supply": false, "project_id": 123}}, "examples": [{"name": "Historical list + Gate A (include_supply false)", "request": {"params": {"include_supply": false, "project_id": 1}, "tool": "generation.list"}, "response": {"data": {"include_supply": false, "sandbox_gate": {"apply_ready": false}}, "success": true}}, {"name": "Full supply snapshot on list", "request": {"params": {"include_supply": true, "project_id": 1}, "tool": "generation.list"}, "response": {"data": {"include_supply": true}, "success": true}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_ANCHOR_MISSING": "generation.list anchor_missing_from_list is stale: use generation.diff_vs_prod by UUID, not a new fork.", "GENERATION_LIST_STALE": "generation.list list_stale: retry projection.verification_action once (prefer generation.env_snapshot), then generation.diff_vs_prod. Do not fork to repair projection lag.", "GENERATION_LIST_UNAVAILABLE": "list_unavailable means catalog read failed, not an empty project — retry generation.env_snapshot once (env_uuid from fork if known), else generation.list once, then diagnose; do not fork to fill the list.", "GENERATION_SANDBOX_QUOTA_ZERO": "Sandbox unavailable or quota zero — do not invent env_uuid; check generation.supply_status (supply_scope=gate) or generation.env_snapshot, then fork only when quota allows.", "GENERATION_STALE_ENV_UUID": "Stale generation_env_uuid (not found / not open): one generation.env_snapshot with env_uuid from the last fork receipt — omit stale uuid from context. bots.order_manager_bootstrap apply (dry_run=false) does not auto-fork; needs apply_ready."}, "instruction_hint": "Historical anchors (list_contract=historical_all) for this project — not traffic head only. Gate A:…", "mutation_kind": "none", "next_actions": ["generation.diff_vs_prod"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune"], "related_tools": ["generation.env_snapshot", "generation.diff_vs_prod", "generation.supply_status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_list", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "List sandbox environment anchors for a project (names, status, CalVer, auto_created flags). error_code list_unavailable means the read failed.", "title": "Generation List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Generation operator or project membership required — auth.get_profile", "invalid_parameters": "project_id required — bind context.project_id before generation.list", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — not zero anchors. Retry generation.env_snapshot once, else generation.list once; fix project_id/session; do not fork to repair.", "sandbox_not_available": "Free/starter sandbox off — generation.supply_status; upgrade before auto_generation_mode or fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Not buyer checkout or script.run — sandbox catalog only. Empty list ≠ no forks; use env_snapshot on list_unavailable.", "when_to_use": "Historical anchors (list_contract=historical_all) for this project — not traffic head only. Gate A: prefer generation.env_snapshot or supply_status supply_scope=gate — not generation.list as the defau", "write_mode": null}, {"action": "generation.status", "aliases": ["generation.get_status"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.status", "related_tools": ["generation.env_snapshot", "generation.diff_vs_prod", "generation.gates", "generation.supply_status"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Status"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"include_projection": false, "project_id": 123}, "example_request": {"action": "generation.status", "params": {"include_projection": false, "project_id": 123}}, "examples": [{"name": "TG1611 Gate A default (no catalog hydrate)", "request": {"params": {"project_id": 1}, "tool": "generation.status"}, "response": {"data": {"include_projection": false, "sandbox_gate": {"apply_ready": false, "reason": "no_open_anchor"}}, "success": true}}, {"name": "Full projection (opt-in)", "request": {"params": {"include_projection": true, "project_id": 1}, "tool": "generation.status"}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_APPROVAL_MODES": "auto_generation_approval_mode: off | at_least_one | min_count | min_percent | manual_only. manual_only blocks auto-promote. generation.approve records one approver; promote waits until quorum. Legacy require_approval true means at_least_one.", "GENERATION_DIRECT_PROD": "direct_prod_roles (default owner) write production and skip auto-fork. Everyone else accumulates on their own open sandbox branch. Pass env_uuid or X-AgentStack-Env only to stay in a chosen sandbox.", "GENERATION_GATE_AFTER_FORK": "After generation.fork, reuse data.env_uuid for mutations and Gate A probes — generation.env_snapshot (lightest) then bootstrap dry_run=true; generation.supply_status only when tier/quota needed. Batch context honors params.env_uuid when list lags (hydrate + memo bust).", "GENERATION_LIST_STALE": "generation.list list_stale: retry projection.verification_action once (prefer generation.env_snapshot), then generation.diff_vs_prod. Do not fork to repair projection lag.", "GENERATION_LIST_UNAVAILABLE": "list_unavailable means catalog read failed, not an empty project — retry generation.env_snapshot once (env_uuid from fork if known), else generation.list once, then diagnose; do not fork to fill the list."}, "instruction_hint": "Gate A = sandbox_gate.apply_ready; readiness is projection-only. Default include_projection=false —…", "mutation_kind": "none", "next_actions": ["generation.env_snapshot", "generation.diff_vs_prod", "generation.gates"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.env_snapshot", "generation.diff_vs_prod", "generation.gates", "generation.supply_status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_status", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Lightweight generation + canary status for UI banners and agents.", "title": "Generation Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id required — bind operator session before generation.status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Retry generation.env_snapshot once, else generation.list — catalog read failed", "sandbox_not_available": "Free/starter sandbox off — generation.supply_status; upgrade before auto_generation_mode or fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Gate A = sandbox_gate.apply_ready; readiness is projection-only. Default include_projection=false — light gate probe (no catalog hydrate). include_projection=true runs build_generation_list_projection", "write_mode": null}, {"action": "generation.supply_status", "aliases": ["generation.current", "generation.current_env"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.supply_status", "related_tools": ["generation.env_snapshot", "bots.order_manager_bootstrap"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Supply Status"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"project_id": 123, "supply_scope": "gate"}, "example_request": {"action": "generation.supply_status", "params": {"project_id": 123, "supply_scope": "gate"}}, "examples": [{"name": "Lightest apply gate probe", "request": {"params": {"project_id": 1, "supply_scope": "gate"}, "tool": "generation.supply_status"}, "response": {"data": {"sandbox_gate": {"apply_ready": false, "reason": "no_open_anchor"}, "supply_scope": "gate"}, "success": true}}, {"name": "Pre-fork quota room check", "request": {"params": {"project_id": 1, "supply_scope": "full"}, "tool": "generation.supply_status"}, "response": {"data": {"limits": {"open_environments": {}}, "supply_scope": "full"}, "success": true}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_GATE_AFTER_FORK": "After generation.fork, reuse data.env_uuid for mutations and Gate A probes — generation.env_snapshot (lightest) then bootstrap dry_run=true; generation.supply_status only when tier/quota needed. Batch context honors params.env_uuid when list lags (hydrate + memo bust).", "GENERATION_LIST_UNAVAILABLE": "list_unavailable means catalog read failed, not an empty project — retry generation.env_snapshot once (env_uuid from fork if known), else generation.list once, then diagnose; do not fork to fill the list.", "GENERATION_NEXT_ACTIONS_HINTS_ONLY": "next_actions and recovery_hint on gate reads are navigation hints, not operator consent to mutate prod. When sandbox_gate.apply_ready=false, STOP — do not auto-run generation.fork or dry_run=false bootstrap from agent loops. Exception: bots.order_manager_bootstrap dry_run=true is planning only — it does not require apply_ready; pass env_uuid from generation.fork before dry_run=false apply (Gate B).", "GENERATION_SANDBOX_QUOTA_ZERO": "Sandbox unavailable or quota zero — do not invent env_uuid; check generation.supply_status (supply_scope=gate) or generation.env_snapshot, then fork only when quota allows."}, "instruction_hint": "Gate A + optional quota. TG1611: prefer generation.env_snapshot; supply_scope=gate skips quota SQL.…", "mutation_kind": "none", "next_actions": ["generation.env_snapshot", "bots.order_manager_bootstrap"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.env_snapshot", "bots.order_manager_bootstrap"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_supply_status", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Tenant generation supply snapshot: owner tier, open-env quota usage, auto_generation settings, pending/canary state. Alias for agents (same SoT as GET /api/sandbox/limits + generation.status).", "title": "Generation Supply Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "generation operator or project membership required", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — retry generation.env_snapshot with fork env_uuid; generation.supply_status is not empty supply", "sandbox_not_available": "Free/starter sandbox off — generation.supply_status; upgrade before auto_generation_mode or fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Gate A + optional quota. TG1611: prefer generation.env_snapshot; supply_scope=gate skips quota SQL. active_env_uuid is traffic pointer only. Business head project_id after create_composite.", "write_mode": null}, {"action": "generation.env_snapshot", "aliases": ["generation.get"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1", "core.mcp.self_description.gen1"], "id": "generation.env_snapshot", "related_tools": ["generation.fork", "generation.supply_status", "bots.order_manager_bootstrap"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Env Snapshot"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"project_id": 123}, "example_request": {"action": "generation.env_snapshot", "params": {"project_id": 123}}, "examples": [{"name": "Gate A after fork", "request": {"params": {"env_uuid": "example-env-uuid", "project_id": 1}, "tool": "generation.env_snapshot"}, "response": {"data": {"sandbox_gate": {"apply_ready": true, "reason": "open_anchors"}, "snapshot_scope": "gate"}, "success": true}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_GATE_AFTER_FORK": "After generation.fork, reuse data.env_uuid for mutations and Gate A probes — generation.env_snapshot (lightest) then bootstrap dry_run=true; generation.supply_status only when tier/quota needed. Batch context honors params.env_uuid when list lags (hydrate + memo bust).", "GENERATION_LIST_UNAVAILABLE": "list_unavailable means catalog read failed, not an empty project — retry generation.env_snapshot once (env_uuid from fork if known), else generation.list once, then diagnose; do not fork to fill the list.", "GENERATION_NEXT_ACTIONS_HINTS_ONLY": "next_actions and recovery_hint on gate reads are navigation hints, not operator consent to mutate prod. When sandbox_gate.apply_ready=false, STOP — do not auto-run generation.fork or dry_run=false bootstrap from agent loops. Exception: bots.order_manager_bootstrap dry_run=true is planning only — it does not require apply_ready; pass env_uuid from generation.fork before dry_run=false apply (Gate B)."}, "instruction_hint": "Lightest Gate A + hydrated env rows — one catalog read, no limits/usage SQL. Pass env_uuid from gen…", "mutation_kind": "none", "next_actions": ["bots.order_manager_bootstrap", "generation.fork"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.fork", "generation.supply_status", "bots.order_manager_bootstrap"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_env_snapshot", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Lightest Gate A organ: one catalog read + hydrated anchors + sandbox_gate. No tier limits/usage SQL — prefer over generation.list for AgentStackSharp TG1611.", "title": "Generation Env Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "generation operator or project membership required", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — retry once; pass env_uuid from fork", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Lightest Gate A + hydrated env rows — one catalog read, no limits/usage SQL. Pass env_uuid from generation.fork. Prefer over generation.list for TG1611 / AgentStackSharp.", "write_mode": null}, {"action": "generation.settings.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.settings.get", "related_tools": ["generation.settings.patch", "generation.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Settings Get"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Read auto_generation_mode", "request": {"params": {"project_id": 1}, "tool": "generation.settings.get"}, "response": {"data": {"project_id": 1, "settings": {"auto_generation_mode": true}}, "success": true}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_APPROVAL_MODES": "auto_generation_approval_mode: off | at_least_one | min_count | min_percent | manual_only. manual_only blocks auto-promote. generation.approve records one approver; promote waits until quorum. Legacy require_approval true means at_least_one.", "GENERATION_DIRECT_PROD": "direct_prod_roles (default owner) write production and skip auto-fork. Everyone else accumulates on their own open sandbox branch. Pass env_uuid or X-AgentStack-Env only to stay in a chosen sandbox."}, "instruction_hint": "Read auto_generation_mode, approval mode, and promote strategy before changing generation.settings.…", "mutation_kind": "none", "next_actions": ["generation.settings.patch", "generation.status"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.settings.patch", "generation.status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_settings_get", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Read per-project auto_generation settings (REST parity: GET /api/generations/{id}/settings).", "title": "Generation Settings Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin or generation operator for settings read", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Read auto_generation_mode, approval mode, and promote strategy before changing generation.settings.patch or running generation.promote.", "write_mode": null}, {"action": "generation.settings.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.settings.patch", "mutation_risk": "low", "related_tools": ["generation.status", "generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Settings Patch"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Enable sandbox auto-fork", "request": {"params": {"auto_generation_mode": true, "project_id": 1}, "tool": "generation.settings.patch"}, "response": {"data": {"project_id": 1, "settings": {"auto_generation_mode": true}}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_APPROVAL_MODES": "auto_generation_approval_mode: off | at_least_one | min_count | min_percent | manual_only. manual_only blocks auto-promote. generation.approve records one approver; promote waits until quorum. Legacy require_approval true means at_least_one.", "GENERATION_DIRECT_PROD": "direct_prod_roles (default owner) write production and skip auto-fork. Everyone else accumulates on their own open sandbox branch. Pass env_uuid or X-AgentStack-Env only to stay in a chosen sandbox."}, "instruction_hint": "Set direct_prod_roles and auto_generation_approval_mode. Owners write prod; other roles stay on one…", "mutation_kind": "entity", "next_actions": ["generation.status", "generation.diff_vs_prod"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.status", "generation.diff_vs_prod"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "generation_settings_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "PATCH auto_generation settings on the production project slice. Enable auto_generation_mode so tracked MCP mutations auto-fork to sandbox. REST parity: PATCH /api/generations/{id}/settings.", "title": "Generation Settings Patch", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin / generation operator required — not a sandbox head issue", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "sandbox_not_available": "auto_generation supply needs a paid tier — read generation.env_snapshot (gate) or generation.supply_status before patch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Set direct_prod_roles and auto_generation_approval_mode. Owners write prod; other roles stay on one personal sandbox branch. manual_only requires a human approve then promote.", "write_mode": null}, {"action": "generation.queue", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.queue", "related_tools": ["generation.gates", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Queue"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Pending sandboxes before promote", "request": {"params": {"project_id": 1}, "tool": "generation.queue"}, "response": {"data": {"pending": [{"gates": [], "uuid": "<anchor>"}], "project_id": 1}, "success": true}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_APPROVAL_MODES": "auto_generation_approval_mode: off | at_least_one | min_count | min_percent | manual_only. manual_only blocks auto-promote. generation.approve records one approver; promote waits until quorum. Legacy require_approval true means at_least_one.", "GENERATION_LIST_UNAVAILABLE": "list_unavailable means catalog read failed, not an empty project — retry generation.env_snapshot once (env_uuid from fork if known), else generation.list once, then diagnose; do not fork to fill the list."}, "instruction_hint": "Pending sandboxes with gate summary — then generation.gates and generation.promote.", "mutation_kind": "none", "next_actions": ["generation.gates", "generation.promote"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.gates", "generation.promote"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_queue", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Promotion queue: pending sandbox generations with gate evaluation (REST parity).", "title": "Generation Queue", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Promotion queue read failed — retry generation.env_snapshot once, else generation.list; do not fork to repair.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Pending sandboxes with gate summary — then generation.gates and generation.promote.", "write_mode": null}, {"action": "generation.fork", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not fork for site byte edits — hosting.bucket.file.patch does not move 8DNA.", "anti_patterns": ["Do not fork for site byte edits — hosting.bucket.file.patch does not move 8DNA.", "Do not fork to repair list_unavailable or anchor_missing_from_list — diagnose first."], "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.fork", "mutation_risk": "low", "related_tools": ["generation.env_snapshot", "generation.supply_status", "generation.diff_vs_prod", "generation.gates", "generation.promote", "bots.order_manager_bootstrap", "knowledge.config.patch", "knowledge.config.get"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Fork"}, "do_not_use_when": "Not to fix empty generation.list — env_snapshot + diff_vs_prod first. Not for hosted site git or script.put — separate planes.", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"env_name": "example_string", "env_type": "example_string", "project_id": 123, "source_project_id": 123}, "example_request": {"action": "generation.fork", "params": {"env_name": "example_string", "env_type": "example_string", "project_id": 123, "source_project_id": 123}}, "examples": [{"name": "Open sandbox before tenant leaf writes", "request": {"params": {"project_id": 1444}, "tool": "generation.fork"}, "response": {"data": {"anchor_uuid": "example-env-uuid", "committed": true, "env_uuid": "example-env-uuid", "generation": 3, "sandbox_landing": {"on_production": false, "ready_to_test": true, "write_target": "sandbox"}, "state": "ready"}, "success": true}}, {"name": "Idempotent slice collision reuse", "response": {"data": {"committed": true, "env_uuid": "example-env-uuid", "idempotent_replay": true, "state": "ready", "visibility": {"in_list": true}}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_GATE_AFTER_FORK": "After generation.fork, reuse data.env_uuid for mutations and Gate A probes — generation.env_snapshot (lightest) then bootstrap dry_run=true; generation.supply_status only when tier/quota needed. Batch context honors params.env_uuid when list lags (hydrate + memo bust).", "GENERATION_NEXT_ACTIONS_HINTS_ONLY": "next_actions and recovery_hint on gate reads are navigation hints, not operator consent to mutate prod. When sandbox_gate.apply_ready=false, STOP — do not auto-run generation.fork or dry_run=false bootstrap from agent loops. Exception: bots.order_manager_bootstrap dry_run=true is planning only — it does not require apply_ready; pass env_uuid from generation.fork before dry_run=false apply (Gate B).", "GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts.", "GENERATION_SANDBOX_QUOTA_ZERO": "Sandbox unavailable or quota zero — do not invent env_uuid; check generation.supply_status (supply_scope=gate) or generation.env_snapshot, then fork only when quota allows.", "GENERATION_STALE_ENV_UUID": "Stale generation_env_uuid (not found / not open): one generation.env_snapshot with env_uuid from the last fork receipt — omit stale uuid from context. bots.order_manager_bootstrap apply (dry_run=false) does not auto-fork; needs apply_ready."}, "instruction_hint": "Fork: committed=true, state=ready. Gate A=sandbox_gate.apply_ready (readiness≠apply). idempotent_re…", "mutation_kind": "entity", "next_actions": ["generation.env_snapshot", "generation.diff_vs_prod", "generation.gates"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.env_snapshot", "generation.supply_status", "generation.diff_vs_prod", "generation.gates", "generation.promote", "bots.order_manager_bootstrap", "knowledge.config.patch", "knowledge.config.get"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "rollback": ["generation.realign_to_prod"], "safe_action": "generation_fork", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Fork production project into a new sandbox environment generation.", "title": "Generation Fork", "verification": ["generation.diff_vs_prod", "generation.gates"], "verify": [{"action": "generation.diff_vs_prod", "predicate": "named resource is visible"}, {"action": "generation.gates", "predicate": "named resource is visible"}], "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "committed": "Settled sync fork: committed=true with state=ready — transport success=true even when older clients misread pending. committed=false or preview_only is not this contract; read MUTATION_RECEIPT_CONTRACT.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Sync fork failed or substrate receipt mismatch — read env_uuid from fork payload, then generation.env_snapshot once; if still lagging, generation.list with include_status=all; do not re-fork without idempotency policy.", "forked_count": "Count of entity rows inserted in the fork transaction (slices/manifest), not the number of committed environments or open anchors.", "generation_env_mismatch": "auto_generation_mode is off — call generation.fork or omit env_uuid on reads", "generation_fork_slice_collision": "Reuse fork env_uuid from receipt; generation.env_snapshot then diff — do not fork again to repair catalog lag", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — retry generation.env_snapshot once with fork env_uuid; do not fork to fill the list", "preflight_blocked": "Pair fork with knowledge.project_secrets.apply in one anchored batch when healing fleet after secrets — then diff_vs_prod, gates, promote as separate sync executes (GENERATION_SYNC_BATCH_BUDGET).", "projection_pending": "Catalog lag when committed=true and visibility.in_list is false — generation.env_snapshot once with fork env_uuid; then generation.diff_vs_prod if needed. Do not re-fork.", "sandbox_landing": "After successful fork: write_target=sandbox, on_production=false, ready_to_test=true, landing.committed=true — then generation.diff_vs_prod → generation.gates → generation.promote per auto_promote_strategy.", "sandbox_limit_exceeded": "Open-env quota full — promote, realign, or discard; do not spam fork", "sandbox_not_available": "Sandbox not on this tier — generation.supply_status; upgrade before manual fork. App Studio Vite source (ai_builder.source.*) writes prod disk directly — not fixed by generation.fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Not to fix empty generation.list — env_snapshot + diff_vs_prod first. Not for hosted site git or script.put — separate planes.", "when_to_use": "Fork: committed=true, state=ready. Gate A=sandbox_gate.apply_ready (readiness≠apply). idempotent_replay=reuse. Next generation.env_snapshot with same env_uuid; supply_scope=gate if visibility.in_list", "write_mode": null}, {"action": "generation.canary.advance", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.canary.advance", "mutation_risk": "low", "related_tools": ["generation.status", "generation.canary.abort"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Canary Advance"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"project_id": 123}, "example_request": {"action": "generation.canary.advance", "params": {"project_id": 123}}, "examples": [{"name": "UF_F1 advance canary step after promote", "request": {"params": {"env_uuid": "<rolling-anchor>", "project_id": 1}, "tool": "generation.canary.advance"}, "response": {"data": {"status": "rolling_out", "step": 1, "traffic_weight": 25}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_CANARY_LADDER": "Canary traffic is generation.canary.advance / generation.canary.abort on a rolling_out anchor. Strategy comes from auto_promote_strategy — do not invent weights.", "GENERATION_ENV_OMIT": "Omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork."}, "instruction_hint": "Step canary traffic on a rolling_out anchor. Read generation.status first.", "mutation_kind": "none", "next_actions": ["generation.status"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.status", "generation.canary.abort"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "generation_canary_advance", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Advance canary rollout to the next traffic weight step.", "title": "Generation Canary Advance", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "invalid_state": "Anchor must be rolling_out — generation.status first", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Step canary traffic on a rolling_out anchor. Read generation.status first.", "write_mode": null}, {"action": "generation.canary.abort", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.canary.abort", "mutation_risk": "high", "related_tools": ["generation.status", "generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Canary Abort"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"mark_failed": true, "project_id": 123}, "example_request": {"action": "generation.canary.abort", "params": {"mark_failed": true, "project_id": 123}}, "examples": [{"name": "Abort canary and restore prod pointer", "request": {"params": {"env_uuid": "<rolling-anchor>", "project_id": 1}, "tool": "generation.canary.abort"}, "response": {"data": {"restored_to": "<prod-anchor>", "status": "aborted", "traffic_weight": 0}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_CANARY_LADDER": "Canary traffic is generation.canary.advance / generation.canary.abort on a rolling_out anchor. Strategy comes from auto_promote_strategy — do not invent weights."}, "instruction_hint": "Stop a rolling canary and keep production on the previous head.", "mutation_kind": "none", "next_actions": ["generation.status"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.status", "generation.diff_vs_prod"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "generation_canary_abort", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Abort canary rollout and restore previous production pointer.", "title": "Generation Canary Abort", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "invalid_state": "Nothing to abort unless status is rolling_out", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Stop a rolling canary and keep production on the previous head.", "write_mode": null}, {"action": "generation.hosting.release", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.hosting.release", "mutation_risk": "low", "related_tools": ["hosting.release.promote", "generation.diff_vs_prod", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Hosting Release"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"project_id": 123, "publish_preview": true, "site_id": "example_string"}, "example_request": {"action": "generation.hosting.release", "params": {"project_id": 123, "publish_preview": true, "site_id": "example_string"}}, "examples": [{"name": "UF_F1 snapshot hosting release from sandbox", "request": {"params": {"env_uuid": "<sandbox-anchor>", "project_id": 1, "site_id": "demo-store"}, "tool": "generation.hosting.release"}, "response": {"data": {"preview_url": "https://example/s/1/demo-store-preview", "release_uuid": "<release-uuid>", "sandbox_generation": 12}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_HOSTING_RELEASE": "generation.hosting.release moves a site release pointer on DNA only. Live HTML/assets ship via hosting.publish (hosting.deploy_files), not this tool. Does not fork 8DNA or replace generation.promote."}, "instruction_hint": "Label an immutable hosting.release row with the open sandbox generation after bytes are on hosting.…", "mutation_kind": "none", "next_actions": ["generation.fork", "generation.hosting.release", "hosting.release.promote", "generation.status"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["hosting.release.promote", "generation.diff_vs_prod", "generation.promote"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "generation_hosting_release", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Snapshot live hosting workspace into an immutable release labeled with sandbox generation. Does not swap canonical /s/ URL — follow with hosting.release.promote.", "title": "Generation Hosting Release", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head; pin Gate A with generation.env_snapshot once (env_uuid from fork receipt if known).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "Confirm site_id from hosting.project.status — does not fork 8DNA", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Label an immutable hosting.release row with the open sandbox generation after bytes are on hosting.bucket (hosting.publish / hosting.deploy_files). Does not upload site files or fork 8DNA — follow wit", "write_mode": null}, {"action": "generation.diff", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.diff", "related_tools": ["generation.diff_vs_prod", "generation.list", "generation.gates"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Diff"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"detail": "example_string", "env_uuid_a": "example_string", "env_uuid_b": "example_string", "project_id": 123, "table": "example_string"}, "example_request": {"action": "generation.diff", "params": {"detail": "example_string", "env_uuid_a": "example_string", "env_uuid_b": "example_string", "project_id": 123, "table": "example_string"}}, "examples": [{"name": "Compare two sandbox anchors", "request": {"params": {"env_uuid_a": "<prod-head>", "env_uuid_b": "<sandbox-head>", "project_id": 1}, "tool": "generation.diff"}, "response": {"data": {"diff": {"deletes": [], "sets": []}, "env_uuid_a": "<prod-head>", "env_uuid_b": "<sandbox-head>"}, "success": true}}], "execution_class": "heavy", "generation_atoms": {"GENERATION_ENV_OMIT": "Omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork.", "GENERATION_STALE_ENV_UUID": "Stale generation_env_uuid (not found / not open): one generation.env_snapshot with env_uuid from the last fork receipt — omit stale uuid from context. bots.order_manager_bootstrap apply (dry_run=false) does not auto-fork; needs apply_ready.", "GENERATION_SYNC_BATCH_BUDGET": "generation.diff_vs_prod, generation.gates, and generation.diff are sync CPU-heavy — at most one per agentstack.execute (60s mcp_batch). Split UF_DIAGNOSE / mcp_generation_diff across separate executes; reuse fork env_uuid / generation.env_snapshot in the same batch via spine memo. UF_F1: diff_vs_prod stashes generation_promote_heads on _batch_preflight_spine; gates and promote peek it (one resolve+diff per batch context)."}, "instruction_hint": "Compare two DNA entity UUIDs (anchors preferred). Head slices are canonicalized server-side.", "mutation_kind": "none", "next_actions": ["generation.gates", "generation.promote"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.diff_vs_prod", "generation.list", "generation.gates"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_diff", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Structured diff between two resolved generation entity states (same table/project).", "title": "Generation Diff", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_not_found": "Pass anchor UUIDs from fork receipt or generation.env_snapshot; else generation.list once — head slices are canonicalized server-side.", "insufficient_permissions": "DNA read denied — confirm project membership before compare", "invalid_parameters": "env_uuid_a and env_uuid_b required — use anchors from fork receipt or generation.env_snapshot; generation.list only for historical_all catalog.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Compare two DNA entity UUIDs (anchors preferred). Head slices are canonicalized server-side.", "write_mode": null}, {"action": "generation.diff_vs_prod", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.diff_vs_prod", "related_tools": ["generation.promote", "generation.realign_to_prod", "generation.gates", "generation.diff", "knowledge.health", "knowledge.config.get", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Diff Vs Prod"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"audit_batch_allowed": true, "execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"detail": "example_string", "path_prefixes": [], "project_id": 123, "table": "example_string"}, "example_request": {"action": "generation.diff_vs_prod", "params": {"detail": "example_string", "path_prefixes": [], "project_id": 123, "table": "example_string"}}, "examples": [{"name": "Pre-promote diagnosis (F1)", "request": {"params": {"project_id": 1}, "tool": "generation.diff_vs_prod"}, "response": {"data": {"agent_context": {"summary": "…"}, "content_vs_metadata": {}, "env_uuid": "<kept-anchor>"}, "success": true}}], "execution_class": "heavy", "generation_atoms": {"GENERATION_DIFF_SOURCE_REVISION": "CAS source_revision is prod_head_uuid:sandbox_head_uuid from the last generation.diff_vs_prod (also top-level source_revision). Use with generation.realign_to_prod / generation.discard before dry_run=false.", "GENERATION_ENV_OMIT": "Omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork.", "GENERATION_PROMOTE_HEADS_SPINE": "UF_F1: generation.diff_vs_prod resolves prod/sandbox heads once and stashes generation_promote_heads on _batch_preflight_spine. generation.gates and generation.promote peek that bundle in the same MCP batch context.", "GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts.", "GENERATION_STALE_ENV_UUID": "Stale generation_env_uuid (not found / not open): one generation.env_snapshot with env_uuid from the last fork receipt — omit stale uuid from context. bots.order_manager_bootstrap apply (dry_run=false) does not auto-fork; needs apply_ready.", "GENERATION_SYNC_BATCH_BUDGET": "generation.diff_vs_prod, generation.gates, and generation.diff are sync CPU-heavy — at most one per agentstack.execute (60s mcp_batch). Split UF_DIAGNOSE / mcp_generation_diff across separate executes; reuse fork env_uuid / generation.env_snapshot in the same batch via spine memo. UF_F1: diff_vs_prod stashes generation_promote_heads on _batch_preflight_spine; gates and promote peek it (one resolve+diff per batch context)."}, "instruction_hint": "Review sandbox vs prod before promote. Omit generation_env_uuid — server uses this user's open fork…", "mutation_kind": "none", "next_actions": ["generation.gates", "generation.realign_to_prod"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.promote", "generation.realign_to_prod", "generation.gates", "generation.diff", "knowledge.health", "knowledge.config.get", "preflight.check"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_diff_vs_prod", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Diff stable production head vs pending sandbox head. Includes agent_context summary for diagnosis (counts, domains, sample paths). instruction_slice and recovery_hint use context.locale / instruction_", "title": "Generation Diff Vs Prod", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_not_found": "Omit generation_env_uuid — server keeps sandbox head; do not fork to repair list", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Review sandbox vs prod before promote. Omit generation_env_uuid — server uses this user's open fork. Pass env_uuid only to diff another person's fork. Returns source_revision prod_head:sandbox_head fo", "write_mode": null}, {"action": "generation.realign_to_prod", "aliases": ["generation.discard"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.realign_to_prod", "mutation_risk": "high", "related_tools": ["generation.diff_vs_prod", "generation.promote", "generation.discard"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Realign To Prod"}, "do_not_use_when": "Not a substitute for promote — discards sandbox only.", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"dry_run": true, "path_prefixes": [], "project_id": 123, "source_revision": "example_string"}, "example_request": {"action": "generation.realign_to_prod", "params": {"dry_run": true, "path_prefixes": [], "project_id": 123, "source_revision": "example_string"}}, "examples": [{"name": "Discard sandbox drift (dry_run first)", "request": {"params": {"dry_run": true, "project_id": 1}, "tool": "generation.realign_to_prod"}, "response": {"data": {"applied_deletes": 0, "applied_sets": 0, "source_revision": "prod:sandbox"}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_ENV_OMIT": "Omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork.", "GENERATION_REALIGN_DRY_RUN": "Discard sandbox edits — generation.realign_to_prod dry_run first; path_prefixes for partial revert; not a substitute for promote."}, "instruction_hint": "Discard sandbox edits — dry_run first. Not a substitute for promote.", "mutation_kind": "entity", "next_actions": ["generation.diff_vs_prod", "generation.promote"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.diff_vs_prod", "generation.promote", "generation.discard"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "rollback": [], "safe_action": "generation_realign_to_prod", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Revert pending sandbox DNA toward stable production by applying inverse diff (leaf jsonb_set / path delete on sandbox anchor — no full-blob wipe). Optional path_prefixes for partial revert.", "title": "Generation Realign To Prod", "verification": ["generation.diff_vs_prod", "generation.list"], "verify": [{"action": "generation.diff_vs_prod", "predicate": "named resource is visible"}, {"action": "generation.list", "predicate": "named resource is visible"}], "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_not_found": "omit generation_env_uuid — server keeps sandbox head", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "mutation_applied_partial": "generation.diff_vs_prod — partial realign; retry or widen path_prefixes", "parallel_canonical_drift": "realign is the recovery path — dry_run first", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "realign_source_revision_conflict": "Re-read generation.diff_vs_prod and pass source_revision", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Not a substitute for promote — discards sandbox only.", "when_to_use": "Discard sandbox edits — dry_run first. Not a substitute for promote.", "write_mode": null}, {"action": "generation.discard", "alias_of": "generation.realign_to_prod", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.discard", "mutation_risk": "high", "related_tools": ["generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Discard"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "UF_F1 discard sandbox (dry_run first)", "request": {"params": {"dry_run": true, "project_id": 1}, "tool": "generation.discard"}, "response": {"data": {"applied_deletes": 0, "applied_sets": 0, "source_revision": "prod:sandbox"}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_DISCARD": "generation.discard is generation.realign_to_prod with dry_run default true. Pass source_revision from the last diff. dry_run=false applies the revert.", "GENERATION_REALIGN_DRY_RUN": "Discard sandbox edits — generation.realign_to_prod dry_run first; path_prefixes for partial revert; not a substitute for promote."}, "instruction_hint": "Safe name for realign. Defaults to dry_run=true even after the alias rewrite.", "mutation_kind": "none", "next_actions": ["generation.diff_vs_prod"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.diff_vs_prod"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "generation_discard", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Discard sandbox changes (Postel alias for generation.realign_to_prod). Defaults to dry_run=true — set dry_run=false to apply.", "title": "Generation Discard", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Catalog read failed — retry generation.env_snapshot once (env_uuid from fork if known), else generation.list once; do not invent env_uuid; do not fork to fill the list.", "mutation_applied_partial": "generation.diff_vs_prod — partial discard; retry or widen path_prefixes", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "realign_source_revision_conflict": "Re-read generation.diff_vs_prod and pass source_revision. dry_run stays true until the token matches.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Safe name for realign. Defaults to dry_run=true even after the alias rewrite.", "write_mode": null}, {"action": "generation.archive", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not generation.promote an empty draft to leave the pending queue.", "anti_patterns": ["Do not generation.promote an empty draft to leave the pending queue.", "Do not cascade-delete a live or rolling_out anchor."], "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.archive", "mutation_risk": "low", "related_tools": ["generation.diff_vs_prod", "generation.realign_to_prod", "generation.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Archive"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "examples": [{"name": "Archive open sandbox without promote", "request": {"params": {"env_uuid": "<sandbox-anchor>", "project_id": 1}, "tool": "generation.archive"}, "response": {"data": {"deleted": 0, "env_uuid": "<sandbox-anchor>", "status": "archived"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Drop an empty or abandoned draft from the pending queue. cascade defaults false. Live and rolling_o…", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.diff_vs_prod", "generation.realign_to_prod", "generation.list"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "generation_archive", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Archive an open sandbox anchor (draft, validating, or ready). Does not promote. cascade defaults false and only sets status=archived.", "title": "Generation Archive", "when_blocked": {"archive_refused": "Only draft, validating, and ready can be archived. rolling_out uses generation.canary.abort. Do not promote to clear the queue.", "batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_not_found": "Pass anchor uuid from fork receipt or generation.env_snapshot — do not fork again", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Drop an empty or abandoned draft from the pending queue. cascade defaults false. Live and rolling_out use canary abort, not archive.", "write_mode": null}, {"action": "generation.pointer.set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.pointer.set", "related_tools": ["generation.status", "generation.env_snapshot", "generation.realign_to_prod"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Pointer Set"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Repair split-brain active_env_uuid without discarding sandbox content. Default dry_run=true; projec…", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.status", "generation.env_snapshot", "generation.realign_to_prod"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "generation_pointer_set", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Repair split-brain: set active_env_uuid without discarding sandbox content (TG1692 C09). Default dry_run=true.", "title": "Generation Pointer Set", "when_blocked": {"active_env_uuid_required": "Pass anchor uuid from generation.fork — default dry_run=true before apply", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project_admin — auth.get_profile and projects membership", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "active_env_uuid (or env_uuid) required — generation.env_snapshot or fork receipt"}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Repair split-brain active_env_uuid without discarding sandbox content. Default dry_run=true; project_admin; call after fork confusion or pointer drift.", "write_mode": null}, {"action": "generation.promote", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not promote on parallel_canonical_drift — realign sandbox first.", "anti_patterns": ["Do not promote on parallel_canonical_drift — realign sandbox first.", "Do not promote from diagnosis-only batches (UF_DIAGNOSE)."], "budget_note": "Run only after diff+gates in prior executes — never pair with generation.gates (GENERATION_SYNC_BATCH_BUDGET).", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.promote", "mutation_risk": "high", "related_tools": ["generation.gates", "generation.timeline", "generation.status", "knowledge.project_secrets.apply", "knowledge.config.patch", "knowledge.health", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Promote"}, "do_not_use_when": "Not for Nahual script-only coop on prod without gates — diff_vs_prod + gates first. Not hosting git promote (remote agentstack, branch dev).", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"env_uuid": "<sandbox-anchor-uuid>", "require_gates_passed": true}, "example_request": {"action": "generation.promote", "params": {"env_uuid": "<sandbox-anchor-uuid>", "require_gates_passed": true}}, "examples": [{"name": "UF_F1 promote after gates", "request": {"params": {"env_uuid": "<sandbox-anchor-uuid>", "project_id": 1, "require_gates_passed": true}, "tool": "generation.promote"}, "response": {"data": {"env_uuid": "<sandbox-anchor-uuid>", "status": "completed", "strategy": "immediate"}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_APPROVAL_MODES": "auto_generation_approval_mode: off | at_least_one | min_count | min_percent | manual_only. manual_only blocks auto-promote. generation.approve records one approver; promote waits until quorum. Legacy require_approval true means at_least_one.", "GENERATION_ENV_OMIT": "Omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork.", "GENERATION_NOT_GIT": "generation.promote moves 8DNA (config, fleet, knowledge), not git and not site bytes. Hosting git remote is named agentstack; default push is branch dev (preview). Live site is branch main or hosting.git.promote_branch with bucket_id, ref=dev, target=prod. Pass env_uuid on the write params or the server may bind a different open fork. Do not promote a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. Platform agentstack-core and shared often have no remote — those ship by VPS deploy.", "GENERATION_PARALLEL_DRIFT": "parallel_canonical_drift blocks promote when the sandbox would delete canonical money.expenses — generation.realign_to_prod, do not promote again.", "GENERATION_PROMOTE_HEADS_SPINE": "UF_F1: generation.diff_vs_prod resolves prod/sandbox heads once and stashes generation_promote_heads on _batch_preflight_spine. generation.gates and generation.promote peek that bundle in the same MCP batch context.", "GENERATION_PROMOTE_VERIFY": "AFTER generation.promote: (1) settled success = committed=true or SDK isPromoteSettled(receipt).success — accepted≠settled, (2) prod_head changed OR effect=noop expected, (3) script.list without env shows script_id+code_hash, (4) diff_vs_prod empty for promoted script paths, (5) on failure STOP — no re-promote, no realign_to_prod discard. See docs/operations/MP_PROMOTE_RECEIPT_LITERACY.md.", "GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts.", "GENERATION_SYNC_BATCH_BUDGET": "generation.diff_vs_prod, generation.gates, and generation.diff are sync CPU-heavy — at most one per agentstack.execute (60s mcp_batch). Split UF_DIAGNOSE / mcp_generation_diff across separate executes; reuse fork env_uuid / generation.env_snapshot in the same batch via spine memo. UF_F1: diff_vs_prod stashes generation_promote_heads on _batch_preflight_spine; gates and promote peek it (one resolve+diff per batch context)."}, "instruction_hint": "Move sandbox anchor to prod after diff + gates. Strategy from auto_promote_strategy; require_gates_…", "mutation_kind": "entity", "next_actions": ["generation.env_snapshot", "generation.status", "generation.timeline"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.gates", "generation.timeline", "generation.status", "knowledge.project_secrets.apply", "knowledge.config.patch", "knowledge.health", "preflight.check"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "rollback": ["generation.rollback", "generation.checkpoint"], "safe_action": "generation_promote", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Promote a sandbox environment to production (runs promotion checks first). instruction_slice and recovery_hint use context.locale / instruction_locale.", "title": "Generation Promote", "verification": ["generation.status", "generation.diff_vs_prod"], "verify": [{"action": "generation.status", "predicate": "named resource is visible"}, {"action": "generation.diff_vs_prod", "predicate": "named resource is visible"}], "when_blocked": {"accepted_not_committed": "Transport accepted≠settled success — wait for committed=true or use SDK isPromoteSettled(receipt).success; do not treat accepted alone as promote done.", "anchor_missing_from_list": "Pin env_uuid from fork receipt; generation.env_snapshot then generation.diff_vs_prod — do not fork to repair projection lag", "batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "content_merge_noop": "Content merge would apply zero leaves — generation.diff_vs_prod then realign or edit sandbox.", "content_merge_partial": "Promote aborted after partial DNA merge — pointer not advanced; fix delete/set paths.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "diff_unavailable": "Heads differ but diff missing — retry generation.promote in a fresh execute with generation.diff_vs_prod first.", "gates_failed": "Do not promote — read generation.gates output", "gates_not_passed": "Run generation.gates — all rows must be pass or skip", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "manual_approval_required": "Call generation.approve until approval_mode quorum is met — then generation.promote", "metadata_only_blocked": "Diff is environment metadata only — generation.realign_to_prod (dry_run) or add active-content leaves before generation.promote.", "parallel_canonical_drift": "generation.realign_to_prod — do not retry promote", "preflight_blocked": "After knowledge.project_secrets.apply (bots_run): generation.diff_vs_prod → generation.gates → generation.promote — not VPS deploy scripts.", "promote_noop": "No-op promote — verify script.list (no env) and applied_paths. Do not re-promote blindly; use generation.diff_vs_prod.", "promote_split_brain_unmerged": "Pointer pre-aligned but prod head missing scripts — re-promote after fix; confirm content_merge.applied_paths and script.list.", "promotion_checks_failed": "Read promotion checks — fix sandbox before promote", "receipt_not_settled": "Poll / re-read promote receipt until committed=true (or isPromoteSettled). accepted=false on a committed receipt is normal.", "require_gates_passed": "generation.gates must pass — auto_promote_strategy from project settings", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Not for Nahual script-only coop on prod without gates — diff_vs_prod + gates first. Not hosting git promote (remote agentstack, branch dev).", "when_to_use": "Move sandbox anchor to prod after diff + gates. Strategy from auto_promote_strategy; require_gates_passed defaults on when mode on. Peeks generation_promote_heads from diff/gates in the same batch con", "write_mode": null}, {"action": "generation.approve", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.approve", "mutation_risk": "low", "related_tools": ["generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Approve"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"note": "example_string", "project_id": 123}, "example_request": {"action": "generation.approve", "params": {"note": "example_string", "project_id": 123}}, "examples": [{"name": "Manual approval before promote", "request": {"params": {"env_uuid": "<sandbox-anchor>", "note": "ops ok", "project_id": 1}, "tool": "generation.approve"}, "response": {"data": {"env_uuid": "<sandbox-anchor>", "gates": [{"name": "manual", "status": "pass"}]}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_APPROVAL_MODES": "auto_generation_approval_mode: off | at_least_one | min_count | min_percent | manual_only. manual_only blocks auto-promote. generation.approve records one approver; promote waits until quorum. Legacy require_approval true means at_least_one."}, "instruction_hint": "Record one approver on the sandbox anchor. Promote stays blocked until the approval mode quorum is …", "mutation_kind": "none", "next_actions": ["generation.promote"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.promote"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "generation_approve", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Mark manual generation approval on anchor and re-run gate evaluation.", "title": "Generation Approve", "verification": ["generation.gates", "generation.status"], "verify": [{"action": "generation.gates", "predicate": "named resource is visible"}, {"action": "generation.status", "predicate": "named resource is visible"}], "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "manual_approval_required": "Response includes approval_quorum and approver_count — call approve again or wait for another operator, then generation.promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Record one approver on the sandbox anchor. Promote stays blocked until the approval mode quorum is met.", "write_mode": null}, {"action": "generation.gates", "aliases": ["generation.run_gates"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.gates", "related_tools": ["generation.promote", "generation.realign_to_prod", "knowledge.health", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Gates"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"execution_class": "heavy", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "example_params": {"manual_approved": false, "project_id": 123}, "example_request": {"action": "generation.gates", "params": {"manual_approved": false, "project_id": 123}}, "examples": [{"name": "UF_F1 gate chain before promote", "request": {"params": {"env_uuid": "<sandbox-anchor>", "project_id": 1}, "tool": "generation.gates"}, "response": {"data": {"env_uuid": "<sandbox-anchor>", "gates": [{"name": "schema", "status": "pass"}]}, "success": true}}], "execution_class": "heavy", "generation_atoms": {"GENERATION_ENV_OMIT": "Omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork.", "GENERATION_GATES_MANUAL_APPROVED": "generation.gates optional manual_approved=true marks the manual approval gate passed (REST POST gates/run parity). Quorum still needs generation.approve when approval_mode requires it.", "GENERATION_PROMOTE_HEADS_SPINE": "UF_F1: generation.diff_vs_prod resolves prod/sandbox heads once and stashes generation_promote_heads on _batch_preflight_spine. generation.gates and generation.promote peek that bundle in the same MCP batch context.", "GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts.", "GENERATION_SYNC_BATCH_BUDGET": "generation.diff_vs_prod, generation.gates, and generation.diff are sync CPU-heavy — at most one per agentstack.execute (60s mcp_batch). Split UF_DIAGNOSE / mcp_generation_diff across separate executes; reuse fork env_uuid / generation.env_snapshot in the same batch via spine memo. UF_F1: diff_vs_prod stashes generation_promote_heads on _batch_preflight_spine; gates and promote peek it (one resolve+diff per batch context)."}, "instruction_hint": "Run gates before promote. Omit generation_env_uuid; soak pending may need re-poll. Optional manual_…", "mutation_kind": "none", "next_actions": ["generation.promote", "generation.realign_to_prod"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.promote", "generation.realign_to_prod", "knowledge.health", "preflight.check"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_gates", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Run generation gate chain for an environment (schema, conflict, health, soak, metrics, optional manual).", "title": "Generation Gates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "gates_failed": "Fix failing gates before promote — generation.diff_vs_prod first", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "require_gates_passed": "Run generation.gates with require_gates_passed_on_promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Run gates before promote. Omit generation_env_uuid; soak pending may need re-poll. Optional manual_approved=true (REST parity). Does not auto-promote — call generation.promote. Peeks batch promote_hea", "write_mode": null}, {"action": "generation.notify", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.notify", "related_tools": ["generation.status", "generation.timeline"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Notify"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Manual notify after promote (audit)", "request": {"params": {"env_uuid": "<anchor>", "message": "Promote complete — verify Gate D", "project_id": 1}, "tool": "generation.notify"}, "response": {"data": {"ok": true, "project_id": 1}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_NOTIFY": "generation.notify pings operators about a sandbox anchor. It does not promote, approve, or change DNA."}, "instruction_hint": "Notify operators about a generation anchor (audit/webhook). Does not approve or promote.", "mutation_kind": "none", "next_actions": ["generation.status", "generation.gates"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.status", "generation.timeline"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "generation_notify", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Manual generation notify — webhooks, audit log, optional in-app notification.", "title": "Generation Notify", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "No open fork — omit env_uuid; notify does not promote or change DNA", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Notify operators about a generation anchor (audit/webhook). Does not approve or promote.", "write_mode": null}, {"action": "generation.checkpoint", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.checkpoint", "mutation_risk": "low", "related_tools": ["generation.rollback", "generation.promote", "generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Checkpoint"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "UF_F1 checkpoint before risky bulk edit", "request": {"params": {"label": "pre-bulk", "project_id": 1}, "tool": "generation.checkpoint"}, "response": {"data": {"checkpoint_uuid": "<checkpoint-uuid>", "generation": 12, "label": "pre-bulk"}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_CHECKPOINT_LADDER": "generation.checkpoint snapshots merged DNA. generation.rollback opens that checkpoint as a new draft sandbox. Restore prod only via generation.promote."}, "instruction_hint": "Snapshot merged DNA before a risky promote or bulk edit.", "mutation_kind": "none", "next_actions": ["generation.rollback", "generation.promote"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.rollback", "generation.promote", "generation.diff_vs_prod"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "generation_checkpoint", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Materialise merged production/sandbox DNA into a checkpoint generation (rollback SoT). Use before risky bulk edits; rollback via generation.rollback.", "title": "Generation Checkpoint", "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_preferred_env_blocked": "Omit stale generation_env_uuid — server keeps sandbox head (GENERATION_STALE_ENV_UUID).", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Omit env_uuid for merged head or pass open anchor from fork receipt / generation.env_snapshot; generation.list only for queue/historical catalog.", "sandbox_limit_exceeded": "Free a sandbox slot before checkpoint — promote or discard first", "sandbox_not_available": "Free/starter sandbox off — generation.supply_status; upgrade before auto_generation_mode or fork.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Snapshot merged DNA before a risky promote or bulk edit.", "write_mode": null}, {"action": "generation.rollback", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.rollback", "mutation_risk": "high", "related_tools": ["generation.checkpoint", "generation.promote", "generation.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Generation Rollback"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"execution_class": "cheap", "generation": false, "generation_plane": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"checkpoint_uuid": "example_string", "env_name": "example_string", "project_id": 123}, "example_request": {"action": "generation.rollback", "params": {"checkpoint_uuid": "example_string", "env_name": "example_string", "project_id": 123}}, "examples": [{"name": "UF_F1 open checkpoint for restore promote", "request": {"params": {"checkpoint_uuid": "<checkpoint-uuid>", "project_id": 1}, "tool": "generation.rollback"}, "response": {"data": {"env_uuid": "<rollback-anchor>", "generation": 13, "rollback_uuid": "<rollback-anchor>"}, "success": true}}], "execution_class": "cheap", "generation_atoms": {"GENERATION_CHECKPOINT_LADDER": "generation.checkpoint snapshots merged DNA. generation.rollback opens that checkpoint as a new draft sandbox. Restore prod only via generation.promote.", "GENERATION_ENV_OMIT": "Omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork."}, "instruction_hint": "Open a checkpoint as a new draft sandbox. Promote that draft to restore prod.", "mutation_kind": "none", "next_actions": ["generation.diff_vs_prod", "generation.promote"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.checkpoint", "generation.promote", "generation.list"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "rollback": [], "safe_action": "generation_rollback", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Open a checkpoint as a new sandbox generation (draft). Promote the returned rollback_uuid via generation.promote to restore production DNA.", "title": "Generation Rollback", "verification": ["generation.status", "generation.diff_vs_prod"], "verify": [{"action": "generation.status", "predicate": "named resource is visible"}, {"action": "generation.diff_vs_prod", "predicate": "named resource is visible"}], "when_blocked": {"batch_semantic_anchor_conflict": "Per-step NL conflicts with batch goal — one goal_text per batch or split steps.", "batch_semantic_anchor_required": "Mutating batch: options.execution_intent=direct (Unity/tenant CRUD) or options.goal / semantic_contract; preflight.check simulate_batch_* to preview.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "checkpoint_uuid must come from generation.checkpoint", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "sandbox_limit_exceeded": "Promote, discard, or realign an open anchor before opening rollback draft", "sandbox_not_available": "generation.env_snapshot supply_scope=gate or generation.supply_status — tier may not allow another sandbox env", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with project_admin — or generation-operator session on bound project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Open a checkpoint as a new draft sandbox. Promote that draft to restore prod.", "write_mode": null}, {"action": "generation.timeline", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.timeline", "related_tools": ["generation.status", "generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Generation Timeline"}, "do_not_use_when": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"limit": 123, "offset": 123, "project_id": 123}, "example_request": {"action": "generation.timeline", "params": {"limit": 123, "offset": 123, "project_id": 123}}, "examples": [{"name": "Promotion history after UF_F1 cycle", "request": {"params": {"limit": 20, "project_id": 1}, "tool": "generation.timeline"}, "response": {"data": {"items": [], "project_id": 1}, "success": true}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_ENV_OMIT": "Omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork."}, "instruction_hint": "Promotion history for audits — pair with generation.status when canary is rolling_out.", "mutation_kind": "none", "next_actions": ["generation.status", "generation.diff_vs_prod"], "onboarding_tier": "domain_playbook", "plane": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "plane_chooser": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_agentcrush_remediation_v1", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site", "agentstack_knowledge_answer_tune", "agentstack_project_orchestrator"], "related_tools": ["generation.status", "generation.diff_vs_prod"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "generation_timeline", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Promotion history for a project: completed, active canary (rolling_out), failed, and aborted requests (newest first). Items include strategy, traffic_weight, calver_label when recorded.", "title": "Generation Timeline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Generation operator or project membership required", "invalid_parameters": "project_id required — bind operator session before generation.timeline", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "list_unavailable": "Retry generation.env_snapshot once, else generation.list — timeline read failed", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with mcp_read — or operator OAuth (Connect / Device Code).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Sandbox: omit generation_env_uuid; the server keeps the sandbox head. That head is this user's latest open fork. Pass env_uuid only to read another person's fork. Gate A probe: generation.env_snapshot first (env_uuid from fork receipt); defer generation.list until historical_all catalog or quota proof. A CRM or scheduler read stays on that category's fork for this user. Empty generation.list is not zero anchors. list_unavailable is a failed read. A pointer that is not an anchor row leaves the catalog empty. diff_vs_prod still reads it. Do not call generation.fork to fill the list. diff_vs_prod, gates, promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Strategy is auto_promote_strategy. Site bytes do not fork. parallel_canonical_drift: realign, do not promote. generation.promote is not hosting git: remote name agentstack, default branch dev.", "when_to_use": "Promotion history for audits — pair with generation.status when canary is rolling_out.", "write_mode": null}], "genetic": [{"action": "genetic.snapshot.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "genetic", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.genetic.project_genome.gen1"], "id": "genetic.snapshot.get", "related_tools": ["genetic.search", "hosting.git.status", "genetic.reindex"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Genetic Snapshot Get"}, "do_not_use_when": "Platform TAG_CATALOG / docs_nav — substrate navigation only.", "domain_title": "Genetic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "empty_graph_ladder": {"kind": "empty_graph", "message": "Snapshot has no genetic nodes — commit philosophy/ or AI_INDEX and push the journal.", "next_actions": ["hosting.git.status", "hosting.git.log", "genetic.reindex"]}, "execution_class": "plain_read", "genetic_tags": ["core.genetic.project_genome.gen1"], "instruction_hint": "After git push with philosophy/ or AI_INDEX; verify meta.sha matches journal HEAD.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.genetic", "owner_gene": "core.genetic.project_genome.gen1", "plane_chooser": "Monorepo docs-nav (TAG_CATALOG, docs_nav.*) is platform navigation — not the tenant map. Tenant genetic graph lives in git (philosophy/, **/AI_INDEX.md, AGENTS.md) and caches in 8DNA ecosystem.genetic after hosting git push. Read: genetic.snapshot.get. After push verify meta.sha. Manual rebuild: genetic.reindex with journal_root from hosting.git.status — not projects.patch_data on ecosystem.genetic.", "related_tools": ["genetic.search", "hosting.git.status", "genetic.reindex"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "genetic_snapshot_get", "semantic_input_mode": "inherit_workflow", "summary": "Read derived genetic navigation graph for a project (ecosystem.genetic 8DNA leaves). Text SoT is in git; this is the cached graph for UI and agents.", "title": "Genetic Snapshot Get", "when_not_to_use": "Platform TAG_CATALOG / docs_nav — substrate navigation only.", "when_to_use": "After git push with philosophy/ or AI_INDEX; verify meta.sha matches journal HEAD.", "write_mode": null}, {"action": "genetic.search", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "genetic", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.genetic.project_genome.gen1"], "id": "genetic.search", "related_tools": ["genetic.snapshot.get", "hosting.git.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Genetic Search"}, "do_not_use_when": "docs_nav.search on platform repo.", "domain_title": "Genetic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.genetic.project_genome.gen1"], "instruction_hint": "Find a genetic tag or index path within this project's genome snapshot.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.genetic", "owner_gene": "core.genetic.project_genome.gen1", "plane_chooser": "Monorepo docs-nav (TAG_CATALOG, docs_nav.*) is platform navigation — not the tenant map. Tenant genetic graph lives in git (philosophy/, **/AI_INDEX.md, AGENTS.md) and caches in 8DNA ecosystem.genetic after hosting git push. Read: genetic.snapshot.get. After push verify meta.sha. Manual rebuild: genetic.reindex with journal_root from hosting.git.status — not projects.patch_data on ecosystem.genetic.", "related_tools": ["genetic.snapshot.get", "hosting.git.status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "genetic_search", "semantic_input_mode": "inherit_workflow", "summary": "Search tenant genome nodes by tokenized query (tag, title, paths).", "title": "Genetic Search", "when_not_to_use": "docs_nav.search on platform repo.", "when_to_use": "Find a genetic tag or index path within this project's genome snapshot.", "write_mode": null}, {"action": "genetic.reindex", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "genetic", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.genetic.project_genome.gen1"], "id": "genetic.reindex", "mutation_risk": "low", "next_actions": ["genetic.snapshot.get", "generation.diff_vs_prod"], "related_tools": ["genetic.snapshot.get", "hosting.git.status", "generation.diff_vs_prod", "generation.gates"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Genetic Reindex"}, "do_not_use_when": "Do not patch ecosystem.genetic via projects.patch_data — use this or hosting push.", "domain_title": "Genetic MCP domain", "effect": {"execution_class": "heavy", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "error_hints": {"missing_journal": "Set journal_root from hosting.git.status before reindex."}, "execution_class": "heavy", "genetic_tags": ["core.genetic.project_genome.gen1"], "instruction_hint": "Manual refresh after external git or when hook indexing failed. Paid tenants: auto-fork then genera…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["hosting.git.status", "hosting.project.status", "genetic.snapshot.get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.genetic", "owner_gene": "core.genetic.project_genome.gen1", "plane_chooser": "Monorepo docs-nav (TAG_CATALOG, docs_nav.*) is platform navigation — not the tenant map. Tenant genetic graph lives in git (philosophy/, **/AI_INDEX.md, AGENTS.md) and caches in 8DNA ecosystem.genetic after hosting git push. Read: genetic.snapshot.get. After push verify meta.sha. Manual rebuild: genetic.reindex with journal_root from hosting.git.status — not projects.patch_data on ecosystem.genetic.", "related_tools": ["genetic.snapshot.get", "hosting.git.status", "generation.diff_vs_prod", "generation.gates"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "genetic_reindex", "safe_cycle_ladder": "Paid tenants: genetic.reindex mutates 8DNA — use recipe mcp_universal_safe_change / agentstack_safe_project_cycle when auto_generation_mode is on (auto-fork → generation.diff_vs_prod path ecosystem.genetic.meta → generation.gates → generation.promote). Hosting push index writes prod journal head directly (indexed cache, not sandbox).", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Rebuild genetic snapshot leaves from git journal paths. Respects generation sandbox when env_uuid is set or auto_generation forks active.", "title": "Genetic Reindex", "when_blocked": {"missing_journal": "Set journal_root from hosting.git.status before reindex."}, "when_not_to_use": "Do not patch ecosystem.genetic via projects.patch_data — use this or hosting push.", "when_to_use": "Manual refresh after external git or when hook indexing failed. Paid tenants: auto-fork then generation.diff_vs_prod on ecosystem.genetic before promote.", "write_mode": null}], "goals": [{"action": "goals.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "goals", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.goals.gen1"], "id": "goals.upsert", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Goals Upsert"}, "domain_title": "Goals MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"kind": "example_string", "period": "example_string", "project_id": 123, "target": 123.45, "title": "example_string"}, "example_request": {"action": "goals.upsert", "params": {"kind": "example_string", "period": "example_string", "project_id": 123, "target": 123.45, "title": "example_string"}}, "execution_class": "cheap", "genetic_tags": ["core.mcp.goals.gen1"], "instruction_hint": "Set or update a monthly finance, projects, or hours target.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.goals", "owner_gene": "core.mcp.goals.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["goals.delete"], "safe_action": "goals_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Upsert a monthly goal (finance|projects|hours).", "title": "Goals Upsert", "verification": ["goals.list", "goals.progress"], "verify": [{"action": "goals.list", "predicate": "named resource is visible"}, {"action": "goals.progress", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Set or update a monthly finance, projects, or hours target.", "write_mode": null}, {"action": "goals.progress", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "goals", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.goals.gen1"], "id": "goals.progress", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Goals Progress"}, "domain_title": "Goals MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.goals.gen1"], "instruction_hint": "Show goal attainment after goals.upsert or at month close.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.goals", "owner_gene": "core.mcp.goals.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "goals_progress", "semantic_input_mode": "inherit_workflow", "summary": "Compute goal progress from finance/CRM/time BFFs.", "title": "Goals Progress", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Show goal attainment after goals.upsert or at month close.", "write_mode": null}, {"action": "goals.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "goals", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.goals.gen1"], "id": "goals.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Goals List"}, "domain_title": "Goals MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.goals.gen1"], "instruction_hint": "Enumerate stored goals before upsert or progress checks.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.goals", "owner_gene": "core.mcp.goals.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "goals_list", "semantic_input_mode": "inherit_workflow", "summary": "List goals stored in data.goals[].", "title": "Goals List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enumerate stored goals before upsert or progress checks.", "write_mode": null}, {"action": "goals.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "goals", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.goals.gen1"], "id": "goals.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Goals Delete"}, "domain_title": "Goals MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.goals.gen1"], "instruction_hint": "Remove an obsolete goal by id from goals.list.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.goals", "owner_gene": "core.mcp.goals.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "goals_delete", "semantic_input_mode": "inherit_workflow", "summary": "Delete a goal by id from data.goals[].", "title": "Goals Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove an obsolete goal by id from goals.list.", "write_mode": null}], "grants": [{"action": "grants.crm.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.list", "related_tools": ["grants.crm.transition", "grants.packet.build", "fundraising.packet.compose"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Prioritize which platform grant/bounty to work next.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.transition", "grants.packet.build", "fundraising.packet.compose"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_crm_list", "semantic_input_mode": "inherit_workflow", "summary": "List AgentStack platform Grant OS pipeline ranked by FitAndWinScorer (cash-first). Ecosystem owner only — not for tenant users.", "title": "Grants Crm List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Prioritize which platform grant/bounty to work next.", "write_mode": null}, {"action": "grants.crm.seed", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.seed", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Seed"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "First-time Grant OS setup or after registry changes.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_crm_seed", "semantic_input_mode": "inherit_workflow", "summary": "Seed Grant OS CRM rows from PROGRAM_REGISTRY.yaml (ecosystem owner).", "title": "Grants Crm Seed", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "First-time Grant OS setup or after registry changes.", "write_mode": null}, {"action": "grants.crm.transition", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.transition", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Transition"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Mark submitted / awarded / remediation after portal action.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_crm_transition", "semantic_input_mode": "inherit_workflow", "summary": "Transition a Grant OS application status (lifecycle FSM). Ecosystem owner.", "title": "Grants Crm Transition", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark submitted / awarded / remediation after portal action.", "write_mode": null}, {"action": "grants.packet.build", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.packet.build", "related_tools": ["fundraising.packet.compose", "grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Packet Build"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Before platform grant submit — refresh packet evidence and CRM status.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["fundraising.packet.compose", "grants.crm.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_packet_build", "semantic_input_mode": "inherit_workflow", "summary": "Rebuild grant packets and sync CRM blockers from packet.json (ecosystem).", "title": "Grants Packet Build", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before platform grant submit — refresh packet evidence and CRM status.", "write_mode": null}, {"action": "grants.compose.checklist", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.compose.checklist", "related_tools": ["grants.packet.build", "fundraising.packet.compose"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Compose Checklist"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Before uploading zip/attachments to a grant portal.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.packet.build", "fundraising.packet.compose"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_compose_checklist", "semantic_input_mode": "inherit_workflow", "summary": "Attachment checklist for a platform grant portal submit.", "title": "Grants Compose Checklist", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before uploading zip/attachments to a grant portal.", "write_mode": null}, {"action": "grants.crm.sync", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.sync", "related_tools": ["grants.packet.build", "grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Sync"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "After metrics/packet refresh — derive evidence_pending vs submit_ready.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.packet.build", "grants.crm.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_crm_sync", "semantic_input_mode": "inherit_workflow", "summary": "Sync Grant OS CRM statuses from packet.json blockers (GW-CRM-001).", "title": "Grants Crm Sync", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After metrics/packet refresh — derive evidence_pending vs submit_ready.", "write_mode": null}, {"action": "grants.crm.overview", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.overview", "related_tools": ["grants.crm.list", "grants.crm.integrity"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Overview"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Dashboard snapshot of platform fundraising pipeline.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list", "grants.crm.integrity"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_crm_overview", "semantic_input_mode": "inherit_workflow", "summary": "Grant OS CRM overview counts by status (ecosystem owner).", "title": "Grants Crm Overview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dashboard snapshot of platform fundraising pipeline.", "write_mode": null}, {"action": "grants.crm.integrity", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.integrity", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Integrity"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Before submit — fail if submit_ready has blockers or registry missing.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_crm_integrity", "semantic_input_mode": "inherit_workflow", "summary": "Assert Grant OS CRM integrity (GW-CRM-001 + docs mount).", "title": "Grants Crm Integrity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before submit — fail if submit_ready has blockers or registry missing.", "write_mode": null}, {"action": "grants.crm.hub_snapshot", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.hub_snapshot", "related_tools": ["grants.crm.list", "grants.crm.overview", "grants.reminders.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Crm Hub Snapshot"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Single read for Grant OS DevShell without four separate calls.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list", "grants.crm.overview", "grants.reminders.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_crm_hub_snapshot", "semantic_input_mode": "inherit_workflow", "summary": "Grant OS hub snapshot — overview, pipeline, reminders, integrity (ecosystem owner). Mirrors GET /api/admin/grants/hub-snapshot.", "title": "Grants Crm Hub Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Single read for Grant OS DevShell without four separate calls.", "write_mode": null}, {"action": "grants.anchor.nsf_pitch", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.anchor.nsf_pitch", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Anchor Nsf Pitch"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Non-crypto non-dilutive path for AgentStack platform — draft NSF pitch.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_anchor_nsf_pitch", "semantic_input_mode": "inherit_workflow", "summary": "Render NSF SBIR-style Project Pitch from Grant OS anchor atoms.", "title": "Grants Anchor Nsf Pitch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Non-crypto non-dilutive path for AgentStack platform — draft NSF pitch.", "write_mode": null}, {"action": "grants.anchor.update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.anchor.update", "mutation_risk": "low", "related_tools": ["grants.anchor.nsf_pitch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Anchor Update"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Save anchor document before NSF pitch export.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.anchor.nsf_pitch"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_anchor_update", "semantic_input_mode": "inherit_workflow", "summary": "Update Grant OS NSF anchor atoms (ecosystem owner).", "title": "Grants Anchor Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Save anchor document before NSF pitch export.", "write_mode": null}, {"action": "grants.w0.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.w0.get", "related_tools": ["grants.w0.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants W0 Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Track founder W0 evidence gates.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.w0.patch"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_w0_get", "semantic_input_mode": "inherit_workflow", "summary": "Read W0 cash-gates checklist (ecosystem owner).", "title": "Grants W0 Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Track founder W0 evidence gates.", "write_mode": null}, {"action": "grants.w0.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.w0.patch", "mutation_risk": "low", "related_tools": ["grants.w0.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants W0 Patch"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Mark W0 gate done after portal action.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.w0.get"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_w0_patch", "semantic_input_mode": "inherit_workflow", "summary": "Patch W0 checklist item statuses.", "title": "Grants W0 Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark W0 gate done after portal action.", "write_mode": null}, {"action": "grants.reminders.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.reminders.list", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Reminders List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Friday follow-up cadence.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_reminders_list", "semantic_input_mode": "inherit_workflow", "summary": "Relationship follow-up reminders for Grant OS pipeline.", "title": "Grants Reminders List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Friday follow-up cadence.", "write_mode": null}, {"action": "grants.reports.monthly", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.reports.monthly", "related_tools": ["grants.crm.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Reports Monthly"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "End-of-month grant reporting.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_reports_monthly", "semantic_input_mode": "inherit_workflow", "summary": "Generate monthly post-award markdown/json report.", "title": "Grants Reports Monthly", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "End-of-month grant reporting.", "write_mode": null}, {"action": "grants.applications.detail", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.applications.detail", "related_tools": ["grants.crm.list", "grants.crm.transition"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Applications Detail"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Inspect blockers and earning playbooks for one program.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list", "grants.crm.transition"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_applications_detail", "semantic_input_mode": "inherit_workflow", "summary": "Grant OS application detail with score breakdown.", "title": "Grants Applications Detail", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect blockers and earning playbooks for one program.", "write_mode": null}, {"action": "grants.applications.milestone", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.applications.milestone", "related_tools": ["grants.applications.detail", "grants.crm.transition"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Applications Milestone"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Mark evidence milestones done before submit_ready transition.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.applications.detail", "grants.crm.transition"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_applications_milestone", "semantic_input_mode": "inherit_workflow", "summary": "Toggle Grant OS application milestone completion (ecosystem owner).", "title": "Grants Applications Milestone", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark evidence milestones done before submit_ready transition.", "write_mode": null}, {"action": "grants.earning.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.earning.list", "related_tools": ["grants.earning.get", "grants.earning.upsert", "grants.applications.detail"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Earning List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Map grant submit to platform revenue levers.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.earning.get", "grants.earning.upsert", "grants.applications.detail"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_earning_list", "semantic_input_mode": "inherit_workflow", "summary": "List AgentStack ecosystem earning playbooks for grant leverage.", "title": "Grants Earning List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Map grant submit to platform revenue levers.", "write_mode": null}, {"action": "grants.earning.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.earning.get", "related_tools": ["grants.earning.upsert", "grants.earning.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Earning Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read lane before patch.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.earning.upsert", "grants.earning.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_earning_get", "semantic_input_mode": "inherit_workflow", "summary": "Get one earning playbook from EARNING_PLAYBOOKS.yaml.", "title": "Grants Earning Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read lane before patch.", "write_mode": null}, {"action": "grants.earning.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.earning.upsert", "mutation_risk": "low", "related_tools": ["grants.earning.list", "grants.catalog.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Earning Upsert"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Add or tune AgentStack earning lane linked to grant_synergy program ids.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.earning.list", "grants.catalog.upsert"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_earning_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Merge earning playbook fields into EARNING_PLAYBOOKS.yaml (atomic backup). Agents use this to add/update revenue lanes without editing repo files.", "title": "Grants Earning Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add or tune AgentStack earning lane linked to grant_synergy program ids.", "write_mode": null}, {"action": "grants.earning.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.earning.delete", "mutation_risk": "high", "related_tools": ["grants.earning.list", "grants.earning.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Earning Delete"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Retire a revenue lane (creates .bak backup).", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.earning.list", "grants.earning.upsert"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "grants_earning_delete", "semantic_input_mode": "inherit_workflow", "summary": "Remove an earning playbook row from EARNING_PLAYBOOKS.yaml.", "title": "Grants Earning Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Retire a revenue lane (creates .bak backup).", "write_mode": null}, {"action": "grants.bundle.download", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.bundle.download", "related_tools": ["grants.compose.checklist", "fundraising.packet.compose"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Bundle Download"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "One-click bundle when compose checklist has no missing attachments.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.compose.checklist", "fundraising.packet.compose"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_bundle_download", "semantic_input_mode": "inherit_workflow", "summary": "Build submission zip for a program (ecosystem owner). A zip that fits the compact envelope is content_base64. A longer zip omits that field and returns download=POST /api/admin/grants/bundle/{program_", "title": "Grants Bundle Download", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One-click bundle when compose checklist has no missing attachments.", "write_mode": null}, {"action": "grants.catalog.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.catalog.list", "related_tools": ["grants.catalog.get", "grants.opportunity.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Catalog List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Discover catalog before upsert or CRM seed.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.catalog.get", "grants.opportunity.upsert"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_catalog_list", "semantic_input_mode": "inherit_workflow", "summary": "List grant programs from PROGRAM_REGISTRY.yaml (ecosystem owner).", "title": "Grants Catalog List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover catalog before upsert or CRM seed.", "write_mode": null}, {"action": "grants.catalog.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.catalog.get", "related_tools": ["grants.catalog.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Catalog Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read catalog row before patch.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.catalog.upsert"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "grants_catalog_get", "semantic_input_mode": "inherit_workflow", "summary": "Get one program from PROGRAM_REGISTRY.yaml.", "title": "Grants Catalog Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read catalog row before patch.", "write_mode": null}, {"action": "grants.catalog.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.catalog.upsert", "mutation_risk": "low", "related_tools": ["grants.opportunity.upsert", "grants.crm.seed"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Catalog Upsert"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Add or update a grant program in catalog without hand-editing YAML.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.opportunity.upsert", "grants.crm.seed"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_catalog_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Merge program fields into PROGRAM_REGISTRY.yaml (atomic backup).", "title": "Grants Catalog Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add or update a grant program in catalog without hand-editing YAML.", "write_mode": null}, {"action": "grants.applications.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.applications.patch", "mutation_risk": "low", "related_tools": ["grants.crm.transition", "grants.applications.detail"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Applications Patch"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Update grant row metadata without full transition.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.transition", "grants.applications.detail"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_applications_patch", "semantic_input_mode": "inherit_workflow", "summary": "Partial CRM application update (title, deadline, apply_url, notes, evidence URLs).", "title": "Grants Applications Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update grant row metadata without full transition.", "write_mode": null}, {"action": "grants.opportunity.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.opportunity.upsert", "mutation_risk": "low", "related_tools": ["grants.catalog.upsert", "grants.crm.sync"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Grants Opportunity Upsert"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Agent discovers a new grant — one call to register + CRM.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "plane_chooser": "Grant OS: grants.packet.compose → grants.anchor.update → grants.export. CRM evidence: grants.crm.list. On-chain proofs stay agentnet.* — not a second checkout.", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.catalog.upsert", "grants.crm.sync"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "grants_opportunity_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Upsert catalog program + seed CRM row (+ optional packet sync) in one step.", "title": "Grants Opportunity Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Agent discovers a new grant — one call to register + CRM.", "write_mode": null}], "guidance": [{"action": "guidance.list_capability_tasks", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.list_capability_tasks", "related_tools": ["discovery.get_platform_surfaces"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance List Capability Tasks"}, "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Discover taskId, domain, and comfortBudget for platform micro-tasks.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["discovery.get_platform_surfaces"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_list_capability_tasks", "semantic_input_mode": "inherit_workflow", "summary": "List Platform Task Capability (PTC) atoms from shared/fixtures/capability_tasks_v1.json. Use before Compass playbooks with kind=capability or agentstack.execute task hints.", "title": "Guidance List Capability Tasks", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Discover taskId, domain, and comfortBudget for platform micro-tasks.", "write_mode": null}, {"action": "guidance.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.list", "related_tools": ["guidance.match_playbook", "guidance.start_path", "guidance.list_capability_tasks"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance List"}, "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Browse playbooks before start_path.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.match_playbook", "guidance.start_path", "guidance.list_capability_tasks"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_list", "semantic_input_mode": "inherit_workflow", "summary": "List platform Compass playbook definitions plus tenant path overlays for a project. Mirror of REST GET /api/projects/{id}/guidance/definitions.", "title": "Guidance List", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Browse playbooks before start_path.", "write_mode": null}, {"action": "guidance.recommend_skills", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.recommend_skills", "related_tools": ["guidance.preview_instructions", "guidance.match_playbook", "discovery.search"], "semantic_input_mode": "per_step_nl", "source": "overlay", "title": "Guidance Recommend Skills"}, "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "effect_kind": "read", "examples": [{"name": "Unified skill pick", "request": {"params": {"project_id": 1, "text": "ship CRM rollout"}, "tool": "guidance.recommend_skills"}, "response": {"data": {"intent_id": "crm.pipeline.update", "skills": [{"id": "coding.kiss"}], "skills_reason": "unified"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Outcome-oriented ecosystem skill cards for a goal text.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.preview_instructions", "guidance.match_playbook", "discovery.search"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_recommend_skills", "semantic_input_mode": "per_step_nl", "summary": "Outcome-oriented skill pack for a goal (no LLM, no extra tools).", "title": "Guidance Recommend Skills", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Required params text (goal) and project_id — pass text=<user goal> plus context.project_id.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id before guidance.recommend_skills.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Outcome-oriented ecosystem skill cards for a goal text.", "write_mode": null}, {"action": "guidance.preview_instructions", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.preview_instructions", "related_tools": ["guidance.recommend_skills", "discovery.search", "discovery.describe"], "semantic_input_mode": "per_step_nl", "source": "overlay", "title": "Guidance Preview Instructions"}, "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "effect_kind": "read", "examples": [{"name": "Read-only analytics goal", "request": {"params": {"project_id": 1, "text": "Show weekly signups in a dashboard without changing data."}, "tool": "guidance.preview_instructions"}, "response": {"data": {"instruction_packet": {}, "skills_reason": "unified"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Developer preview — read-only route + instruction_packet for a goal; bind project_id for skill card…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.recommend_skills", "discovery.search", "discovery.describe"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_preview_instructions", "semantic_input_mode": "per_step_nl", "summary": "Read-only: route goal → playbook, quality, instruction packet, allowed actions (no LLM).", "title": "Guidance Preview Instructions", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Pass text=<user goal>; optional project_id for unified skill hydration.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_recommended": "Skills stay empty without project_id — pass context.project_id for parity with work_next.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "route_empty": "discovery.search or rephrase goal — no intent_id and no semantic_contract.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Developer preview — read-only route + instruction_packet for a goal; bind project_id for skill cards.", "write_mode": null}, {"action": "guidance.match_playbook", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.match_playbook", "related_tools": ["guidance.path_status", "guidance.start_session"], "semantic_input_mode": "per_step_nl", "source": "overlay", "title": "Guidance Match Playbook"}, "do_not_use_when": "Do not match a playbook when agents.work_next already returned next_action.", "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "effect_kind": "read", "examples": [{"name": "Playbook match with fingerprint echo", "request": {"params": {"goal_text": "telegram shop bot", "semantic_contract": {"fingerprint": "example-fp-playbook", "primary_intent": "commerce.storefront"}}, "tool": "guidance.match_playbook"}, "response": {"data": {"playbook_id": "commerce.telegram_storefront", "semantic_contract": {"fingerprint": "example-fp-playbook"}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "NL goal → playbook id + verifyKinds before start_path; skip when work_next already returned next_ac…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Copy the playbook id into mcp_guidance_start.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.path_status", "guidance.start_session"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_match_playbook", "semantic_input_mode": "per_step_nl", "summary": "Match natural-language goal text to a Platform Compass playbook id using bundled intent patterns + RU/EN synonyms. Returns verifyKinds for bot/commerce paths.", "title": "Guidance Match Playbook", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_not_to_use": "Do not match a playbook when agents.work_next already returned next_action.", "when_to_use": "NL goal → playbook id + verifyKinds before start_path; skip when work_next already returned next_action.", "write_mode": null}, {"action": "guidance.path_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["frontend.platform.compass.gen1"], "id": "guidance.path_status", "related_tools": ["guidance.match_playbook", "bots.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Path Status"}, "do_not_use_when": "Not a tool catalog — discovery.search lists actions; this polls verify gates.", "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Poll funnel progress — not discovery.list for step state.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.match_playbook", "bots.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_path_status", "semantic_input_mode": "inherit_workflow", "summary": "Snapshot Compass verify gates for a project: botExists, botLive, botChannelAttached, hostedVitrinePublished. Use after playbook steps or before go-live checks.", "title": "Guidance Path Status", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_not_to_use": "Not a tool catalog — discovery.search lists actions; this polls verify gates.", "when_to_use": "Poll funnel progress — not discovery.list for step state.", "write_mode": null}, {"action": "guidance.funnel_stats", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.funnel_stats", "related_tools": ["guidance.path_status", "guidance.start_session"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Funnel Stats"}, "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Ops/agent checks cross-user bot Compass funnel without OpTrace ring scan.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.path_status", "guidance.start_session"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_funnel_stats", "semantic_input_mode": "inherit_workflow", "summary": "O(1) in-process Compass funnel counters for messaging-channel-bot: path_started, per-task completions, channel mix, dual_channel_attach. No database scan.", "title": "Guidance Funnel Stats", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Ops/agent checks cross-user bot Compass funnel without OpTrace ring scan.", "write_mode": null}, {"action": "guidance.start_session", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.start_session", "related_tools": ["guidance.match_playbook", "guidance.path_status", "guidance.record_step"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Start Session"}, "domain_title": "Guidance MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "External agent starts a guided bot/commerce path for a user.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.match_playbook", "guidance.path_status", "guidance.record_step"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "guidance_start_session", "semantic_input_mode": "inherit_workflow", "summary": "Start a Platform Compass guidance session on the server (8DNA data.guidance). Use with messaging-channel-bot for cross-device resume.", "title": "Guidance Start Session", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "External agent starts a guided bot/commerce path for a user.", "write_mode": null}, {"action": "guidance.start_path", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.platform.compass.gen1"], "id": "guidance.start_path", "related_tools": ["guidance.start_session", "guidance.complete_step", "guidance.path_status"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Guidance Start Path"}, "do_not_use_when": "Raw agentstack.execute for one-off reads — resolve schema via discovery.list (optional domain=) then discovery.describe(params.action); discovery.search only in a separate execute when NL lookup is needed (avoid goal-anchored batch conflicts).", "domain_title": "Guidance MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"initial_answers": {}, "playbook_id": "example_string", "project_id": 123}, "example_request": {"action": "guidance.start_path", "params": {"initial_answers": {}, "playbook_id": "example_string", "project_id": 123}}, "execution_class": "cheap", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Begin a Compass playbook — path_status before complete_step.", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["guidance.path_status"], "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.start_session", "guidance.complete_step", "guidance.path_status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "guidance_start_path", "semantic_input_mode": "inherit_workflow", "summary": "Alias for guidance.start_session — start a Platform Compass guided path on the server. Prefer this name in agent playbooks; identical parameters and response.", "title": "Guidance Start Path", "verification": ["guidance.path_status", "guidance.get_session"], "verify": [{"action": "guidance.path_status", "predicate": "named resource is visible"}, {"action": "guidance.get_session", "predicate": "named resource is visible"}], "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_not_to_use": "Raw agentstack.execute for one-off reads — resolve schema via discovery.list (optional domain=) then discovery.describe(params.action); discovery.search only in a separate execute when NL lookup is needed (avoid goal-anchored batch conflicts).", "when_to_use": "Begin a Compass playbook — path_status before complete_step.", "write_mode": null}, {"action": "guidance.record_step", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.record_step", "related_tools": ["guidance.start_session", "guidance.get_session", "guidance.path_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Record Step"}, "domain_title": "Guidance MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Record path progress after an agent completes a playbook step.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.start_session", "guidance.get_session", "guidance.path_status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "guidance_record_step", "semantic_input_mode": "inherit_workflow", "summary": "Patch an active guidance session state (answers, currentNodeId, completedNodeIds, percent). Agent parity with SPA pathServerSync step PATCH.", "title": "Guidance Record Step", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Record path progress after an agent completes a playbook step.", "write_mode": null}, {"action": "guidance.list_active_sessions", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.list_active_sessions", "related_tools": ["guidance.get_session", "guidance.start_session"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance List Active Sessions"}, "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Resume or inspect in-progress Compass paths from an agent.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.get_session", "guidance.start_session"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_list_active_sessions", "semantic_input_mode": "inherit_workflow", "summary": "List active guidance sessions for the authenticated user in a project.", "title": "Guidance List Active Sessions", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Resume or inspect in-progress Compass paths from an agent.", "write_mode": null}, {"action": "guidance.list_active_paths", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.list_active_paths", "related_tools": ["guidance.list_active_sessions", "guidance.start_path", "guidance.complete_step"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance List Active Paths"}, "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "List in-progress guided paths before choosing resume or complete_step.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.list_active_sessions", "guidance.start_path", "guidance.complete_step"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_list_active_paths", "semantic_input_mode": "inherit_workflow", "summary": "Alias for guidance.list_active_sessions — active Compass paths with percent and state. Use for agent resume decisions.", "title": "Guidance List Active Paths", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "List in-progress guided paths before choosing resume or complete_step.", "write_mode": null}, {"action": "guidance.get_session", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.get_session", "related_tools": ["guidance.list_active_sessions", "guidance.record_step"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Get Session"}, "domain_title": "Guidance MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Hydrate path state before completing or verifying steps.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.list_active_sessions", "guidance.record_step"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "guidance_get_session", "semantic_input_mode": "inherit_workflow", "summary": "Get one guidance session by id for the authenticated user.", "title": "Guidance Get Session", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "Hydrate path state before completing or verifying steps.", "write_mode": null}, {"action": "guidance.complete_step", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["frontend.platform.compass.gen1"], "id": "guidance.complete_step", "related_tools": ["guidance.path_status", "guidance.record_step"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Guidance Complete Step"}, "domain_title": "Guidance MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "After verify kind passes — idempotent step completion.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "owner_gene": "shared.guidance.gen1", "plane": "Guided paths: guidance.list (canonical PlaybookIds), then guidance.match_playbook (catalog_entry + verifyKinds from enriched compass_playbooks_intents_v1.json, 51/51), then guidance.start_path.", "plane_chooser": "Guided paths: guidance.start_path / complete_step / path_status — Compass playbooks. Capability routing: discovery.search + discovery.describe — not docs_nav.* for execute. docs_nav.search is docs routing only — runtime tools live in discovery.*.", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.path_status", "guidance.record_step"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "guidance_complete_step", "semantic_input_mode": "inherit_workflow", "summary": "Mark a guidance step complete with optional artifact after server verify gates. Agent parity with SPA completePathStep.", "title": "Guidance Complete Step", "when_blocked": {"authenticated_user_required": "MCP session must include user_id — auth.get_profile or auth.login first.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "goal_text_required": "guidance.match_playbook requires goal_text describing the user outcome.", "invalid_parameters": "Check tool schema via discovery.describe — required params missing or wrong type.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_failed": "Step patch rejected — call guidance.path_status and retry with current session revision.", "playbook_no_match": "No Compass playbook matched — try guidance.preview_instructions, discovery.search with q=<goal>, or refine goal_text / intent_id.", "project_id_and_playbook_id_required": "start_path needs project_id + playbook_id from guidance.playbook_list.", "project_id_and_session_id_required": "Pass project_id and session_id from start_session response.", "project_id_required": "Bind context.project_id (or pass project_id) before guidance tools.", "project_id_session_id_state_required": "record_step needs project_id, session_id, step_id, and state payload.", "project_id_session_id_step_id_required": "complete_step needs project_id, session_id, and step_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_not_found": "guidance.get_session or guidance.start_session — verify session_id and project_id.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verify_failed": "Step verification failed — read verifyKinds on the playbook node and retry record_step."}, "when_to_use": "After verify kind passes — idempotent step completion.", "write_mode": null}], "hosting": [{"action": "hosting.demo.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.demo.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Demo Status"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Anonymous demo pool health: heartbeat ok vs absent, degraded_reason pool_low vs heartbeat_absent. H…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_demo_status", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Public demo hosting pool status (enabled, depth, sandbox project id).", "title": "Hosting Demo Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Anonymous demo pool health: heartbeat ok vs absent, degraded_reason pool_low vs heartbeat_absent. Hosted vitrine is hosting.demo_store.status.", "write_mode": null}, {"action": "hosting.demo_store.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.demo_store.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Demo Store Status"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Golden promo demo-store vitrine: catalog row count on sandbox, published build id, manifest bucket …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_demo_store_status", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Golden promo demo-store vitrine: catalog row count on sandbox, published build id, manifest bucket (`frontend.commerce.hosted_storefront.gen1`).", "title": "Hosting Demo Store Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Golden promo demo-store vitrine: catalog row count on sandbox, published build id, manifest bucket (`frontend.commerce.hosted_storefront.gen1`).", "write_mode": null}, {"action": "hosting.site.quick_start", "aliases": ["hosting.bucket.create", "hosting.buckets.create", "hosting.create_site", "hosting.site.create", "sites.create"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.quick_start", "mutation_risk": "low", "related_tools": ["hosting.deploy_files", "hosting.release.promote", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Hosting Site Quick Start"}, "do_not_use_when": "Do not call when a primary_public_url already exists.", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"html": "example_string", "project_id": 123, "publish": true, "slug": "example_string"}, "example_request": {"action": "hosting.site.quick_start", "params": {"html": "example_string", "project_id": 123, "publish": true, "slug": "example_string"}}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Create the first hosted bucket and publish /s/{pid}/{slug}/ only when hosting.pr… primary_public_url", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.deploy_files", "hosting.release.promote", "hosting.project.status"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "hosting_site_quick_start", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create bucket, upload HTML index, optional publish; returns public /s/{project_id}/{bucket_name}/ URL. instruction_slice and recovery_hint use context.locale / instruction_locale.", "title": "Create Hosted Site", "verification": ["hosting.site.resolve", "hosting.project.status"], "verify": [{"action": "hosting.site.resolve", "predicate": "named resource is visible"}, {"action": "hosting.project.status", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestration_step_violation": "Action is outside the current instruction step — use execution_intent=direct for authorized one-off hosting setup, or follow packet.next_action / work_next", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "sites_max_reached": "buffs.get_effective_limits — upgrade plan or archive an old site bucket", "slug_exists": "Pick another slug — hosting.project.status lists taken vanity slugs", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_not_to_use": "Do not call when a primary_public_url already exists.", "when_to_use": "Create the first hosted bucket and publish /s/{pid}/{slug}/ only when hosting.project.status shows no primary_public_url.", "write_mode": null}, {"action": "hosting.site.resolve", "aliases": ["hosting.bucket.get"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Resolve is not a file read. A known string is hosting.bucket.file.patch. GET only when the bytes are unknown.", "anti_patterns": ["Resolve is not a file read. A known string is hosting.bucket.file.patch. GET only when the bytes are unknown."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.resolve", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Resolve"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Resolve bucket_id, slug, and public path before bucket file ops when the id is unknown.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_site_resolve", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Resolve hosting bucket_name to bucket_id and public URL hints.", "title": "Hosting Site Resolve", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Resolve bucket_id, slug, and public path before bucket file ops when the id is unknown.", "write_mode": null}, {"action": "hosting.files.put", "aliases": ["hosting.bucket.file.put"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Many pages: one hosting.deploy_files batch, not parallel hosting.files.put (N separate puts).", "anti_patterns": ["Many pages: one hosting.deploy_files batch, not parallel hosting.files.put (N separate puts).", "List files with hosting.bucket.files.list. Public URL is /s/{project_id}/{bucket_name}/.", "Prefer hosting.bucket.file.patch for a small text edit. Do not GET first.", "Do not use storage.upload when the file already lives in the site bucket.", "content_base64 validation_error: fix padding and strip data: prefix — or use content UTF-8.", "Omit generation_env_uuid — hosting byte writes do not fork."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.files.put", "mutation_risk": "low", "related_tools": ["hosting.deploy_files", "hosting.bucket.files.list", "hosting.bucket.file.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Files Put"}, "do_not_use_when": "Tiny text tweak on a known path — hosting.bucket.file.patch search_replace. Omit dry_run.", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "error_hints": [{"code": "validation_error", "tip": "Strip data: URL prefix; never pass PLACEHOLDER / YOUR_TOKEN literals as base64. Prefer UTF-8 content or hosting.bucket.file.patch search_replace over base64."}], "example_params": {"allow_shrink": true, "bucket_id": "example_string", "bucket_name": "example_string", "content": "example_string", "content_base64": "example_string", "path": "example_string", "project_id": 123}, "example_request": {"action": "hosting.files.put", "params": {"allow_shrink": true, "bucket_id": "example_string", "bucket_name": "example_string", "content": "example_string", "content_base64": "example_string", "path": "example_string", "project_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_BASE64_DECODE": "Strip data: URL prefix; never pass PLACEHOLDER / YOUR_TOKEN literals as base64. Prefer UTF-8 content or hosting.bucket.file.patch search_replace over base64.", "HOSTING_BASE64_PADDING": "content_base64 validation_error: strip whitespace, add = until length % 4 — invalid padding fails before decode.", "HOSTING_GENERATION_ENV_OMIT": "Omit generation_env_uuid on hosting.* byte writes — site edits do not fork. A stale uuid in batch context fails auto-fork; let the server keep the sandbox head. generation_fork_required on hosting.deploy_files is a status-projection defect: another generation.fork does not repair the bytes.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Put one file into the active bucket tree (content or content_base64). Multi-page ship: hosting.depl…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.deploy_files", "hosting.bucket.files.list", "hosting.bucket.file.patch"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["hosting.release.promote"], "safe_action": "hosting_files_put", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Upload or replace one file in a hosting bucket. Many files: one hosting.deploy_files call. List: hosting.bucket.files.list.", "title": "Hosting Files Put", "verification": ["hosting.bucket.files.list", "hosting.bucket.file.get"], "verify": [{"action": "hosting.bucket.files.list", "predicate": "named resource is visible"}, {"action": "hosting.bucket.file.get", "predicate": "named resource is visible"}], "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Pass UTF-8 content or content_base64 (empty body rejected). Many files: hosting.deploy_files. Small edit: hosting.bucket.file.patch search_replace."}, "when_not_to_use": "Tiny text tweak on a known path — hosting.bucket.file.patch search_replace. Omit dry_run.", "when_to_use": "Put one file into the active bucket tree (content or content_base64). Multi-page ship: hosting.deploy_files — one execute step keeps JSON under gateway limits. Refuses a truncated file.get window unle", "write_mode": null}, {"action": "hosting.bucket.file.import_url", "aliases": ["hosting.bucket.file.import_from_url", "hosting.file.import_url", "hosting.import_from_url"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.file.import_url", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket File Import Url"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Fetch one HTTPS asset and write it into a hosting bucket path (SSRF-safe). For dist/site ZIP or git…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_bucket_file_import_url", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Fetch one HTTPS asset and write it into a hosting bucket path (SSRF-safe). For dist/site ZIP or git repos use hosting.site.import_archive with source_url instead.", "title": "Hosting Bucket File Import Url", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fetch one HTTPS asset and write it into a hosting bucket path (SSRF-safe). For dist/site ZIP or git repos use hosting.site.import_archive with source_url instead.", "write_mode": null}, {"action": "hosting.release.snapshot", "aliases": ["releases.snapshot"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Snapshot is not a file edit. HTML/CSS bytes are hosting.bucket.file.patch.", "anti_patterns": ["Snapshot is not a file edit. HTML/CSS bytes are hosting.bucket.file.patch.", "Do not snapshot before one file.patch. Identical public bytes return the existing release and do not copy.", "The copy is the public site tree, not user storage and not projects/{id}/src. Prior releases/ are not copied again."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.snapshot", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Snapshot"}, "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Manual immutable copy of the live public tree for recovery — not one text line (hosting.bucket.file…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_release_snapshot", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create immutable snapshot (archive bucket copy) for a site.", "title": "Hosting Release Snapshot", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "hosting_quota_exceeded": "Project hosting byte quota full (live tree + workspace) — hosting.release.list, delete stale releases (hosting.release.delete), or raise hosting buff. Same recovery as hosting_archive_quota_exceeded; snapshot may soft-fail while publish succeeds.", "hosting_snapshot_rate_limited": "Upload/publish succeeded; hourly snapshot cap hit — skip manual snapshot. Poll hosting.site.edge_health if the public URL is not ready.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "prune_exhausted": "Snapshot auto-prune dropped unpinned archives (or had none) but a full-tree hosting.release.snapshot still does not fit the owner pool. hosting.quota.breakdown → hosting.release.list → hosting.release.delete — not hosting.gc.orphans unless breakdown shows _gen drift. Do not generation.fork for byte-only hosting.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Manual immutable copy of the live public tree for recovery — not one text line (hosting.bucket.file.patch) or post-publish auto-snapshot.", "write_mode": null}, {"action": "hosting.release.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.get", "related_tools": ["hosting.release.list", "hosting.release.download"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Get"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "One release row by release_uuid. include_files=true loads live manifest (heavy).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.release.list", "hosting.release.download"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_release_get", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Fetch one hosting release row by release_uuid.", "title": "Hosting Release Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "One release row by release_uuid. include_files=true loads live manifest (heavy).", "write_mode": null}, {"action": "hosting.release.download", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.download", "related_tools": ["hosting.release.get", "hosting.release.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Download"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Metadata for one release tree (path count, bytes, sample). Not a zip body. hosting.release.get incl…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.release.get", "hosting.release.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_release_download", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Release byte manifest + TTL metadata (bulk zip via REST when enabled).", "title": "Hosting Release Download", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Metadata for one release tree (path count, bytes, sample). Not a zip body. hosting.release.get include_files=true for the manifest.", "write_mode": null}, {"action": "hosting.release.diff", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.diff", "related_tools": ["hosting.release.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Diff"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Path diff between two immutable release ids on one bucket. Both trees must still be on disk.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.release.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_release_diff", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Path-level manifest diff between two immutable release trees.", "title": "Hosting Release Diff", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Path diff between two immutable release ids on one bucket. Both trees must still be on disk.", "write_mode": null}, {"action": "hosting.release.list", "aliases": ["hosting.list", "releases.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release List"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Enumerate release rows to choose hosting.release.promote rollback targets or hosting.release.delete…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_release_list", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "List site release history (newest first).", "title": "List Hosting Releases", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enumerate release rows to choose hosting.release.promote rollback targets or hosting.release.delete candidates.", "write_mode": null}, {"action": "hosting.release.promote", "aliases": ["hosting.rollback", "hosting.upgrade", "releases.promote"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.promote", "mutation_risk": "low", "related_tools": ["hosting.release.list", "hosting.project.status", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Promote"}, "do_not_use_when": "First ship from source commits — hosting.git.init and HOSTING_SHIP_LADDER. Not generation.promote (8DNA) and not hosting.git.promote_branch.", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"bucket_id": "example_string", "bucket_name": "example_string", "project_id": 123, "release_uuid": "example_string"}, "example_request": {"action": "hosting.release.promote", "params": {"bucket_id": "example_string", "bucket_name": "example_string", "project_id": 123, "release_uuid": "example_string"}}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Promote a pinned release snapshot onto live /s/ — bypasses prod git journal compile when git_argv_r…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.release.list", "hosting.project.status", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "production_publish", "rollback": ["hosting.release.promote"], "safe_action": "hosting_release_promote", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Promote a release snapshot to the live site bucket and publish.", "title": "Promote Release", "verification": ["hosting.site.edge_health"], "verify": [{"action": "hosting.site.edge_health", "predicate": "ready"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "First ship from source commits — hosting.git.init and HOSTING_SHIP_LADDER. Not generation.promote (8DNA) and not hosting.git.promote_branch.", "when_to_use": "Promote a pinned release snapshot onto live /s/ — bypasses prod git journal compile when git_argv_rejected blocks promote_branch/site.build target=prod. Pass release_uuid from hosting.release.list (de", "write_mode": null}, {"action": "hosting.release.patch", "aliases": ["hosting.release.pin"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.patch", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Patch"}, "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Update release metadata (label and/or pinned flag).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_release_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Update release metadata (label and/or pinned flag).", "title": "Hosting Release Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update release metadata (label and/or pinned flag).", "write_mode": null}, {"action": "hosting.release.delete", "aliases": ["hosting.release.prune", "releases.delete"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.delete", "mutation_risk": "low", "related_tools": ["hosting.release.list", "hosting.release.snapshot", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Delete"}, "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Remove an unpinned release row (optional bucket purge). hosting.release.list first — never delete t…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.release.list", "hosting.release.snapshot", "hosting.project.status"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_release_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete an unpinned hosting release (optional bucket purge).", "title": "Hosting Release Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "release_pinned": "Unpin in UI or pick another release — pinned rows cannot be deleted", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove an unpinned release row (optional bucket purge). hosting.release.list first — never delete the live primary without clone.", "write_mode": null}, {"action": "hosting.release.clone_site", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.clone_site", "mutation_risk": "low", "related_tools": ["hosting.release.list", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Release Clone Site"}, "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Spin up a new /s/ bucket from an existing release_uuid after hosting.release.list picks the source …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.release.list", "hosting.project.status"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_release_clone_site", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Clone a new site from a release snapshot.", "title": "Hosting Release Clone Site", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "release_not_found": "hosting.release.list — confirm release_uuid before delete or promote", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Spin up a new /s/ bucket from an existing release_uuid after hosting.release.list picks the source snapshot — not a live file patch.", "write_mode": null}, {"action": "hosting.site.import_archive", "aliases": ["hosting.deploy_zip", "hosting.import_archive_chunk", "hosting.upload_chunk"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not pass local_path or chat attachment ids — use upload_grant or source_url.", "anti_patterns": ["Do not pass local_path or chat attachment ids — use upload_grant or source_url.", "Do not use hosting.deploy_files for ZIP archives.", "Large ZIP in MCP: content_base64 chunks with finalize=false (mints archive_upload_session_id), ≤384KiB decoded per chunk; last call finalize=true + publish/mode flags.", "Aliases: hosting.upload_chunk / hosting.import_archive_chunk → this action."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false, "publish": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.ingress.gen1", "core.hosting.bucket.gen1"], "id": "hosting.site.import_archive", "mutates_when": {"dry_run": false, "publish": true}, "mutation_risk": "low", "related_tools": ["hosting.project.status", "hosting.site.resolve", "hosting.site.upload_grant", "preflight.check", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Import Archive"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true previews ZIP gates only (no bucket write). Static dist ZIP: publish=true goes live inline unless async=true (defer publish — call hosting.publish next). async=true on static dist enqueues a background ingest job (job_id) — poll hosting.site.build_status; large ZIP avoids sync MCP batch timeout. Source/git ZIP or repo URL returns job_id and enqueues workspace build — same poll; live unchanged until build+promote. mode=replace needs confirm_site_replace; prune needs confirm_prune. Optional idempotency_key replays a prior successful import (including job_id). One-shot content_base64 ZIPs above ~384KiB decoded are rejected (mcp_archive_inline_too_large) — use chunked import_archive (finalize=false + archive_upload_session_id, ≤384KiB per chunk) or hosting.site.upload_grant + HTTPS POST. Unpacked static trees use hosting.deploy_files upload_session_id.", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false, "publish": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"archive_upload_session_id": "example_string", "async": true, "bucket_id": "example_string", "bucket_name": "example_string", "confirm_prune": true, "confirm_site_replace": true, "connection_uuid": "example_string", "content_base64": "example_string", "dry_run": true, "finalize": true, "git_branch": "example_string", "idempotency_key": "example_string", "mode": "example_string", "project_id": 123, "publish": true, "source_url": "example_string", "strip": "example_string", "token": "example_string"}, "example_request": {"action": "hosting.site.import_archive", "params": {"archive_upload_session_id": "example_string", "async": true, "bucket_id": "example_string", "bucket_name": "example_string", "confirm_prune": true, "confirm_site_replace": true, "connection_uuid": "example_string", "content_base64": "example_string", "dry_run": true, "finalize": true, "git_branch": "example_string", "idempotency_key": "example_string", "mode": "example_string", "project_id": 123, "publish": true, "source_url": "example_string", "strip": "example_string", "token": "example_string"}}, "examples": [{"name": "Vite dist from URL", "request": {"bucket_name": "my-site", "confirm_prune": true, "confirm_site_replace": true, "mode": "replace", "project_id": 1, "publish": true, "source_url": "https://cdn.example/dist.zip", "strip": "auto"}}, {"name": "Preview paths only", "request": {"bucket_id": "<uuid>", "confirm_site_replace": true, "dry_run": true, "mode": "replace", "project_id": 1, "strip": "auto"}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Import a ZIP into a bucket via HTTPS source_url or single content_base64 blob. Vite dist: mode=repl…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "pending_state": "publish=true leaves success=false until hosting.site.edge_health shows edge ready (mutation receipt committed=false).", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.status", "hosting.site.resolve", "hosting.site.upload_grant", "preflight.check", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["hosting.release.promote"], "safe_action": "hosting_site_import_archive", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Import hosted site bytes: ZIP dist publishes to live (optional publish); ZIP with package.json without dist/ enqueues workspace build on --dev (poll build_status). HTTPS git URL (GitHub/GitLab, not .z", "title": "Hosting Site Import Archive", "verification": ["hosting.project.status", "hosting.site.edge_health"], "verify": [{"action": "hosting.project.status", "predicate": "named resource is visible"}, {"action": "hosting.site.edge_health", "predicate": "named resource is visible"}], "when_blocked": {"archive_fetch_failed": "source_url fetch failed (HTTP, timeout, or size cap) — verify URL, retry, or use upload_grant", "archive_index_empty": "index.html is present but empty or too small — rebuild the dist bundle before import", "archive_index_missing": "ZIP has no index.html at root after strip=auto — list sample_paths, fix dist/ layout, or strip=off", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "framework_not_static": "Archive or journal needs a static export (dist/, build/, out/) or a buildable Vite/Astro tree. Next.js without out/ is not static — export with next export/out or upload a Vite dist ZIP. Hugo: ZIP the generated public/ folder.", "git_unrelated_histories": "Fast-forward from upstream failed and adopt_init could not align dev. Use hosting.git.status, resolve conflicts locally, or hosting.git.init on a fresh bucket.", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "hosting_concurrent_deploy": "Deploy/import burst cap for this bucket — wait a minute, reuse idempotency_key after the prior run finishes, or hosting.deploy_files with the same session", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "hosting_missing_reference": "Static href/src/url() points at a path not in the deploy batch or live bucket — hosting.deploy_files dry_run lists missing_references; upload assets or fix links", "hosting_prune_requires_confirmation": "Publish would drop live paths absent from files[] — run dry_run, review manifest_diff.removed, then confirm_prune=true.", "hosting_quota_exceeded": "Project hosting byte quota full (live tree + workspace) — hosting.release.list, delete stale releases (hosting.release.delete), or raise hosting buff. Same recovery as hosting_archive_quota_exceeded; snapshot may soft-fail while publish succeeds.", "hosting_replace_requires_confirmation": "replace_site=true requires confirm_site_replace=true — run dry_run first to preview paths", "hosting_snapshot_rate_limited": "Upload/publish succeeded; hourly snapshot cap hit — skip manual snapshot. Poll hosting.site.edge_health if the public URL is not ready.", "invalid_zip_magic": "Body is not a ZIP archive — check Content-Type and rebuild dist as .zip", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "nested_zip_not_supported": "Nested ZIP members are rejected — export a flat dist.zip", "package_manager_unsupported": "Worker install uses npm only. Add package-lock.json and retry import_archive, or regenerate lock with npm install locally and re-upload.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "source_url_required": "Pass source_url or content_base64 on hosting.site.import_archive — or upload_grant for local bytes", "unsafe_archive_url": "Blocked URL (SSRF) — use a public HTTPS git or ZIP URL", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone.", "zip_compression_ratio_exceeded": "ZIP looks like a compression bomb — export a real build dist; nested zips are rejected", "zip_member_too_large": "A single ZIP member exceeds uncompressed cap — re-export a normal Vite/build dist (no packed huge assets inside one entry)", "zip_slip": "Archive path escapes staging — rebuild dist without parent-directory entries", "zip_too_large": "Compressed archive exceeds import cap — split the dist, use hosting.git, or resumable PATCH with X-Upload-Target: hosting", "zip_too_many_entries": "Archive has too many files — split deploy, use hosting.git journal, or REST resumable ZIP", "zip_uncompressed_limit": "Total uncompressed bytes exceed site import cap — prune assets, split deploy, or use git journal"}, "when_to_use": "Import a ZIP into a bucket via HTTPS source_url or single content_base64 blob. Vite dist: mode=replace, confirm_site_replace=true, confirm_prune=true, strip=auto, publish=true. Local file: hosting.sit", "write_mode": null}, {"action": "hosting.site.upload_grant", "aliases": ["hosting.upload_grant", "storage.upload_grant"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not embed file bytes in upload_grant params — POST multipart field file to returned url.", "anti_patterns": ["Do not embed file bytes in upload_grant params — POST multipart field file to returned url.", "Send header X-Ingress-Grant from the MCP receipt (url is /api/hosting/ingress/upload)."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "execution_class": "cheap", "genetic_tags": ["core.hosting.ingress.gen1"], "id": "hosting.site.upload_grant", "mutation_risk": "low", "related_tools": ["hosting.site.import_archive", "hosting.project.status", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Upload Grant"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Mints a short-lived one-time POST grant only — live bucket bytes change on multipart HTTP POST to /api/hosting/ingress/upload with header X-Ingress-Grant (field file), not in this MCP execute step.", "execution_class": "cheap", "kind": "mutate", "mutates_when": "always", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"bucket_id": "example_string", "bucket_name": "example_string", "confirm_prune": true, "confirm_site_replace": true, "mode": "example_string", "project_id": 123, "publish": true, "strip": "example_string"}, "example_request": {"action": "hosting.site.upload_grant", "params": {"bucket_id": "example_string", "bucket_name": "example_string", "confirm_prune": true, "confirm_site_replace": true, "mode": "example_string", "project_id": 123, "publish": true, "strip": "example_string"}}, "examples": [{"name": "Local ZIP via HTTP POST", "note": "POST field file to url with headers.X-Ingress-Grant — not MCP bytes.", "request": {"bucket_name": "my-site", "confirm_prune": true, "confirm_site_replace": true, "mode": "replace", "project_id": 1, "publish": true, "strip": "auto"}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Mint one-time POST /api/hosting/ingress/upload (no bytes in MCP JSON). Client sends header X-Ingres…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.site.import_archive", "hosting.project.status", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "hosting_site_upload_grant", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Mint a one-time POST grant for multipart ZIP upload (no bytes in MCP JSON). Agent HTTP client POSTs form field file to /api/hosting/ingress/upload with header X-Ingress-Grant.", "title": "Hosting Site Upload Grant", "verification": ["hosting.site.edge_health"], "verify": [{"action": "hosting.site.edge_health", "predicate": "named resource is visible"}], "when_blocked": {"archive_index_empty": "index.html is present but empty or too small — rebuild the dist bundle before import", "archive_index_missing": "ZIP has no index.html at root after strip=auto — list sample_paths, fix dist/ layout, or strip=off", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "hosting_concurrent_deploy": "Deploy/import burst cap for this bucket — wait a minute, reuse idempotency_key after the prior run finishes, or hosting.deploy_files with the same session", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "hosting_ingress_grant_rate_limited": "Wait and retry upload_grant — max 30 mints per hour per operator", "hosting_prune_requires_confirmation": "Publish would drop live paths absent from files[] — run dry_run, review manifest_diff.removed, then confirm_prune=true.", "hosting_quota_exceeded": "Project hosting byte quota full (live tree + workspace) — hosting.release.list, delete stale releases (hosting.release.delete), or raise hosting buff. Same recovery as hosting_archive_quota_exceeded; snapshot may soft-fail while publish succeeds.", "hosting_replace_requires_confirmation": "replace_site=true requires confirm_site_replace=true — run dry_run first to preview paths", "ingress_grant_consumed": "Grant already consumed after a successful upload — mint a new upload_grant for another deploy", "ingress_grant_expired": "Mint a new hosting.site.upload_grant — TTL is 15 minutes", "ingress_grant_in_use": "Another upload is using this grant — wait for it to finish or mint a new upload_grant", "ingress_grant_invalid": "Mint a new hosting.site.upload_grant — tokens are single-use and short-lived", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_zip_magic": "Body is not a ZIP archive — check Content-Type and rebuild dist as .zip", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "nested_zip_not_supported": "Nested ZIP members are rejected — export a flat dist.zip", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "upload_grant mints POST /api/hosting/ingress/upload only — send multipart field file with header X-Ingress-Grant from the grant response. Do not pass content_base64 or source_url here; use hosting.site.import_archive.", "zip_compression_ratio_exceeded": "ZIP looks like a compression bomb — export a real build dist; nested zips are rejected", "zip_member_too_large": "A single ZIP member exceeds uncompressed cap — re-export a normal Vite/build dist (no packed huge assets inside one entry)", "zip_slip": "Archive path escapes staging — rebuild dist without parent-directory entries", "zip_too_large": "Compressed archive exceeds import cap — split the dist, use hosting.git, or resumable PATCH with X-Upload-Target: hosting", "zip_too_many_entries": "Archive has too many files — split deploy, use hosting.git journal, or REST resumable ZIP", "zip_uncompressed_limit": "Total uncompressed bytes exceed site import cap — prune assets, split deploy, or use git journal"}, "when_to_use": "Mint one-time POST /api/hosting/ingress/upload (no bytes in MCP JSON). Client sends header X-Ingress-Grant and multipart field file. Does not accept content_base64 or source_url — use import_archive f", "write_mode": null}, {"action": "hosting.storage.import_folder", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Import moves storage → bucket. One text edit is hosting.bucket.file.patch, not a GET.", "anti_patterns": ["Import moves storage → bucket. One text edit is hosting.bucket.file.patch, not a GET.", "Not for Vite dist (.js blocked in storage)."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.storage.import_folder", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Storage Import Folder"}, "do_not_use_when": "One-line edit on an existing bucket file — hosting.bucket.file.patch.", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Bulk-move a project storage folder into the site bucket; single-path edits stay hosting.bucket.file…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_storage_import_folder", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Import a project storage folder into a hosting bucket.", "title": "Hosting Storage Import Folder", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_not_to_use": "One-line edit on an existing bucket file — hosting.bucket.file.patch.", "when_to_use": "Bulk-move a project storage folder into the site bucket; single-path edits stay hosting.bucket.file.patch.", "write_mode": null}, {"action": "hosting.project.status", "aliases": ["hosting.project-status", "hosting.project.status.ladder", "hosting.project.status.ladder.sell", "hosting.project_status", "hosting.site.get", "hosting.site.list", "hosting.site.status", "hosting.sites.get", "hosting.sites.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Ladder-only polls: leave include_workspace_meta false (default). Per-bucket sources_sha → hosting.workspace.meta.", "anti_patterns": ["Ladder-only polls: leave include_workspace_meta false (default). Per-bucket sources_sha → hosting.workspace.meta.", "Do not read file content here — use hosting.bucket.file.get with bucket_id from plane.", "Do not hosting.site.quick_start when primary_public_url is already set."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.project.status", "related_tools": ["hosting.surface.resolve", "hosting.site.resolve", "hosting.workspace.meta", "hosting.bucket.file.patch", "hosting.deploy_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Project Status"}, "do_not_use_when": "Never substitute for hosting.bucket.file.get when you need file bytes.", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.surface.resolve", "hosting.site.resolve", "hosting.workspace.meta", "hosting.bucket.file.patch", "hosting.deploy_files"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_project_status", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Project hosting plane: Host/Sell/Scale ladder, sites summary, next_actions.", "title": "Inspect Project Hosting", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id required — pass params.project_id or bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Never substitute for hosting.bucket.file.get when you need file bytes.", "when_to_use": "Hosting plane overview — buckets and primary_public_url. This read does not start a file patch. Includes recommended_recipe_id when intent param is passed. Set include_workspace_meta=true only before", "write_mode": null}, {"action": "hosting.quota.breakdown", "aliases": ["hosting.bucket.quota", "hosting.bucket.usage"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not treat storage.get_quota used=0 as hosting headroom — use this breakdown.", "anti_patterns": ["Do not treat storage.get_quota used=0 as hosting headroom — use this breakdown.", "Do not bulk_delete assets/ to free quota before dry_run gc.orphans."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.quota.breakdown", "related_tools": ["hosting.project.status", "hosting.gc.orphans", "hosting.quota.recount"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Quota Breakdown"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Read-only byte split: live tree, workspace, _gen staging, archives. Use when hosting_quota_exceeded…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.status", "hosting.gc.orphans", "hosting.quota.recount"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_quota_breakdown", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Read-only hosting quota components (live, staging _gen, workspace, archives).", "title": "Hosting Quota Breakdown", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only byte split: live tree, workspace, _gen staging, archives. Use when hosting_quota_exceeded or storage hub hosting bytes look wrong. Does not delete. Follow with hosting.gc.orphans dry_run.", "write_mode": null}, {"action": "hosting.quota.recount", "annotations": {"destructiveHint": true, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.quota.recount", "mutates_when": {"dry_run": false}, "mutation_risk": "low", "related_tools": ["hosting.quota.breakdown"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Quota Recount"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true evaluates only; dry_run=false applies changes", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Reconcile DNA quota counter with on-disk measure. dry_run defaults true. apply writes the measured …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.quota.breakdown"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_quota_recount", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Reconcile DNA hosting quota with on-disk measure (owner write for apply).", "title": "Hosting Quota Recount", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reconcile DNA quota counter with on-disk measure. dry_run defaults true. apply writes the measured total — owner write, not a file delete.", "write_mode": null}, {"action": "hosting.gc.orphans", "annotations": {"destructiveHint": true, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.gc.orphans", "mutates_when": {"dry_run": false}, "mutation_risk": "low", "related_tools": ["hosting.quota.breakdown", "hosting.quota.recount"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Gc Orphans"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true evaluates only; dry_run=false applies changes", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Drop abandoned _gen upload sessions older than older_than_hours. dry_run defaults true. Does not to…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.quota.breakdown", "hosting.quota.recount"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_gc_orphans", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Remove abandoned _gen staging dirs older than TTL (dry_run default).", "title": "Hosting Gc Orphans", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drop abandoned _gen upload sessions older than older_than_hours. dry_run defaults true. Does not touch live current or releases.", "write_mode": null}, {"action": "hosting.site.preset.apply", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Rules are advisory. This call does not persist headers.", "anti_patterns": ["Rules are advisory. This call does not persist headers."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.preset.apply", "mutation_risk": "low", "related_tools": ["hosting.deploy_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Preset Apply"}, "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Returns recommended Cache-Control rules for vite_pwa, spa, or static. Does not write DNA or nginx. …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.deploy_files"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_site_preset_apply", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Apply recommended edge/header preset (vite_pwa, spa, static).", "title": "Hosting Site Preset Apply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Returns recommended Cache-Control rules for vite_pwa, spa, or static. Does not write DNA or nginx. Apply the rules in the build, then hosting.deploy_files.", "write_mode": null}, {"action": "hosting.site.purge", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Success with purged=0 is honest — there is no CDN to invalidate.", "anti_patterns": ["Success with purged=0 is honest — there is no CDN to invalidate."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.purge", "related_tools": ["hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Purge"}, "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Origin /s/ has no CDN. Returns purged=0 reason=origin_only. Change Cache-Control via deploy, do not…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_site_purge", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Invalidate edge/CDN cache for site paths (origin no-op when no CDN).", "title": "Hosting Site Purge", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Origin /s/ has no CDN. Returns purged=0 reason=origin_only. Change Cache-Control via deploy, do not expect a purge to drop bytes.", "write_mode": null}, {"action": "hosting.site.prune", "annotations": {"destructiveHint": true, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "dry_run first. keep_releases never deletes the live current tree.", "anti_patterns": ["dry_run first. keep_releases never deletes the live current tree.", "Abandoned upload sessions are hosting.gc.orphans, not prune."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.prune", "mutates_when": {"dry_run": false}, "mutation_risk": "low", "related_tools": ["hosting.release.list", "hosting.gc.orphans"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Prune"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true evaluates only; dry_run=false applies changes", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Delete inactive on-disk releases beyond keep_releases (live current stays). dry_run defaults true. …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.release.list", "hosting.gc.orphans"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_site_prune", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Prune stale hashed assets not in last K releases (dry_run default).", "title": "Hosting Site Prune", "when_blocked": {"bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete inactive on-disk releases beyond keep_releases (live current stays). dry_run defaults true. Staging orphans are hosting.gc.orphans, not this tool.", "write_mode": null}, {"action": "hosting.site.retention.set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.retention.set", "related_tools": ["hosting.project.status", "hosting.release.list", "hosting.site.prune"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Retention Set"}, "domain_title": "Demo Hosting MCP domain", "effect": {"conditional_mutate": "Updates DNA quota.releases_max_per_site (always mutates on success)", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Raise or lower how many immutable hosting.release.snapshot rows are kept per site (DNA quota.releas…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.status", "hosting.release.list", "hosting.site.prune"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_site_retention_set", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Set per-project archive release count cap (DNA quota.releases_max_per_site).", "title": "Hosting Site Retention Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "L2 admin RBAC — preflight.check or permissions.effective action=hosting.deploy_files (action_params.publish=true, slim files:[{path,bytes}] for probes); rbac.check_permission(admin). If admin granted but deploy/preflight denies: stale permissions_bitmap — reconnect OAuth; ops scripts use execution_intent=direct; core bitmap_session_reconcile + hydrate_mcp_execute_principal.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Raise or lower how many immutable hosting.release.snapshot rows are kept per site (DNA quota.releases_max_per_site). Pair with hosting.release.list before pruning.", "write_mode": null}, {"action": "hosting.surface.resolve", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.surface.resolve", "related_tools": ["hosting.project.status", "hosting.workspace.init", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Surface Resolve"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Read-only deploy surface router — returns recommended_recipe_id for agents. Execute that recipe nex…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.status", "hosting.workspace.init", "hosting.site.build"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_surface_resolve", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Read-only deploy surface router: map intent to recipe_id (agents).", "title": "Hosting Surface Resolve", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only deploy surface router — returns recommended_recipe_id for agents. Execute that recipe next; do not discovery.search when intent is known.", "write_mode": null}, {"action": "hosting.project.set_primary_site", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.project.set_primary_site", "mutation_risk": "low", "related_tools": ["hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Project Set Primary Site"}, "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "When several buckets exist, set which one is canonical primary — run hosting.project.status first, …", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.status"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_project_set_primary_site", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Set the project's primary public site URL when multiple sites exist (PH-18).", "title": "Hosting Project Set Primary Site", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "When several buckets exist, set which one is canonical primary — run hosting.project.status first, then patch/deploy against that bucket_id.", "write_mode": null}, {"action": "hosting.bucket.publish", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.publish", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket Publish"}, "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Publish live /s/ bytes for a bucket (gates + manifest + edge health).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "production_publish", "safe_action": "hosting_bucket_publish", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Publish live /s/ bytes for a bucket (gates + manifest + edge health).", "title": "Hosting Bucket Publish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Publish live /s/ bytes for a bucket (gates + manifest + edge health).", "write_mode": null}, {"action": "hosting.bucket.preview_publish", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.preview_publish", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket Preview Publish"}, "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Copy live bucket tree to preview plane and refresh preview symlink.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "production_publish", "safe_action": "hosting_bucket_preview_publish", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Copy live bucket tree to preview plane and refresh preview symlink.", "title": "Hosting Bucket Preview Publish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Copy live bucket tree to preview plane and refresh preview symlink.", "write_mode": null}, {"action": "hosting.site.edge_health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.edge_health", "related_tools": ["hosting.deploy_files", "hosting.release.promote", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Edge Health"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Read-only edge probe — after publish, poll until edge_ready=true. When edge_ready=true the result i…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.deploy_files", "hosting.release.promote", "hosting.project.status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_site_edge_health", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Check nginx edge readiness (symlinks, index.html) for a hosting bucket.", "title": "Check Edge Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only edge probe — after publish, poll until edge_ready=true. When edge_ready=true the result is probe_kind=read_only, success=true, committed=false and has no mutation accepted flag. A hint hosti", "write_mode": null}, {"action": "hosting.site.build", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not deploy_files dist/ when workspace + site.build.yaml exists — hosting.site.build publishes compile output.", "anti_patterns": ["Do not deploy_files dist/ when workspace + site.build.yaml exists — hosting.site.build publishes compile output.", "Dev-first: git push HEAD:dev → poll hosting.site.build_status → open --dev/ URL; then main or promote_branch target=prod.", "Default async=true: poll hosting.site.build_status in a later MCP execute (HOSTING_BATCH_POLL_SAFE).", "Do not bulk-copy live current/ via deploy_files for dev preview — use target=dev build or workspace import.", "After enqueue copy job_id — poll hosting.site.build_status only; do not re-pass bucket_name/target on poll."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.build", "mutation_risk": "low", "related_tools": ["hosting.workspace.init", "hosting.workspace.file.put", "hosting.site.build_status", "hosting.site.build_cancel", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Build"}, "do_not_use_when": "Push to dev expecting preview without git — use git push dev or hosting.site.build target=dev. Do not use target=prod before dev preview is verified.", "domain_title": "Demo Hosting MCP domain", "effect": {"conditional_mutate": "Always mutates on success (async=true enqueues — poll hosting.site.build_status; async=false runs sync compile in the request). Scheduling mode is not read-class.", "execution_class": "cheap", "kind": "mutate", "mutates_when": "always", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Enqueue dev preview", "request": {"params": {"bucket_name": "frontend", "project_id": 1, "publish": true, "target": "dev"}, "tool": "hosting.site.build"}}, {"name": "Go live after green dev preview", "request": {"params": {"bucket_name": "frontend", "project_id": 1, "publish": true, "ref": "dev", "target": "prod"}, "tool": "hosting.git.promote_branch"}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_BATCH_SEMANTIC_ANCHOR": "Sync hosting mutations need a batch anchor: options.execution_intent=direct, options.goal, or preflight.check in the same execute. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor. Poll hosting.site.build_status in a separate execute — one job_id per poll loop; honor poll_backoff_ms; stop when status is completed|failed|cancelled or on job_not_found (re-list via hosting.project.status then hosting.site.build).", "HOSTING_BUILD_PROOF_SIDECARS": "After hosting.site.build publish, live/preview trees expose build-id.txt and sources-sha.txt for edge probes, plus changelog.json (JSON Feed) and changelog.html when git projection succeeds. hosting.workspace.meta sources_sha is the workspace hash before build — sidecars update after publish. Do not hand-PUT sidecars; rebuild or ensure_proof_tree_provenance on ops paths.", "HOSTING_COPYTREE_ANTIPATTERN": "Do not hosting.deploy_files an entire compiled SPA into preview/dev. Use hosting.site.build target=dev, hosting.workspace.import_tree, or ops seed_dev_preview_minimal — never bulk-copy live current/ as deploy_files. Symlink fallback on disk copies public live root only (not releases/).", "HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_MCP_AUTH_FOR_MUTATIONS": "hosting.* writes need session_ready + can_execute_mutation + service caps (user_full / Connect OAuth). service_cap_denied on hosting.workspace.init: widen API key (apikeys.create preset user_full) or Device Code --scope-preset=full — same recovery as other MCP mutations. VPS SSH scripts are ops fallback only; agents should use MCP with context.project_id on every execute. CLI bridge: node provided_plugins/cursor-plugin/scripts/mcp-execute.mjs --project-id <pid> --execution-intent direct <action> --params '{...}' (avoids batch_semantic_anchor_required).", "HOSTING_SUBMODULE_LINK_MISSING": "App .gitmodules URL https://agentstack.tech/api/git/1/sdk.git (or shared-ui) must resolve to projects/1/_sources/{bucket} on the worker. One-time: hosting.git.init project_id=1 bucket_name=sdk and shared-ui (or ops setup_platform_git_library.py). The build symlinks vendor/ — no import_tree or git submodule update on the worker. Fix .gitmodules paths, push HEAD:dev, poll build_status.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": [{"action": "hosting.site.build_status", "params": {"job_id": "<from enqueue>"}, "why": "Poll until completed or failed. job_id only — project_id not required on poll."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "pending_state": "Default async=true enqueues a job — success is not final until hosting.site.build_status reports completed or failed. Poll in a later MCP execute (see HOSTING_BATCH_POLL_SAFE).", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.workspace.init", "hosting.workspace.file.put", "hosting.site.build_status", "hosting.site.build_cancel", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_site_build", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Run site.build.yaml in bucket workspace into staging; default async. target=dev → preview /s/{project_id}/{bucket}--dev/. target=prod rebuilds main only — after green dev use hosting.git.promote_branc", "title": "Hosting Site Build", "verification": "job_id from enqueue → hosting.site.build_status (one job_id per poll execute).", "when_blocked": {"async_required_for_vite": "node_vite builds must use async=true (default). Poll hosting.site.build_status — do not await vite inside a sync MCP execute (neural_bus / batch wall-clock).", "batch_semantic_anchor_required": "Default async=true still needs a batch anchor: options.execution_intent=direct, options.goal, or preflight.check. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor.", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "build_already_queued": "Poll hosting.site.build_status; a new dev push refreshes pending/running sources_sha", "build_cmd_failed": "Read error_tail and failed_cmd. Fix package.json/site.build.yaml in workspace (patch_plane=workspace). Land on dev: git push agentstack HEAD:dev or hosting.git.promote_branch ref=HEAD target=dev with git_push on patch. Poll hosting.site.build_status. Green dev preview → hosting.git.promote_branch ref=dev target=prod (not hosting.site.build target=prod as first go-live).", "build_cwd_missing": "site.build.yaml cwd is not in the journal. Fix the recipe, push dev, poll build_status.", "build_not_enqueued": "Worker-only role cannot enqueue — use AGENTSTACK_PROCESS_ROLE=all|api or async=false sync build", "build_timeout": "Raise build_timeout_seconds or shrink the step, push dev, poll hosting.site.build_status.", "bytes_exceeded": "Staged build output exceeds the byte cap. Shrink the dist, push dev, poll hosting.site.build_status.", "changelog_degraded": "Release published but public changelog.json was not refreshed (git read error, output size cap, or preserve-stale path). completed jobs expose changelog_degraded; when site.build.yaml sets changelog_strict=true the job fails with this code. hosting.git.log for the operator slice; fix journal or lower changelog_limit; rebuild with force=true.", "competence_blocked": "read_only competence_tier blocks mutations — set dev_operator on the session or use Storage Hub Sources UI (PTC hosting.workspace_build) for human publish", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "enqueue_lock_busy": "Retry hosting.site.build with the same project_id and bucket — the lock has no job_id yet. Do not poll hosting.site.build_status until enqueue returns job_id.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "git_argv_rejected": "Server git allowlist blocked a prod worktree step (often reset --hard HEAD after ensure_prod_worktree). Check system.version build_id/git_sha — stale image if fix missing. Until RebuildBackend ships hosting_git_sync reset allowlist: (1) hosting.site.build target=dev publish=true async=true, poll build_status; (2) hosting.release.list; (3) hosting.release.promote with release_uuid only (omit bucket_id on nano site ids); (4) hosting.site.edge_health. Do not loop promote_branch target=prod on the same error.", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "journal_context_missing": "Platform shell worker layout: monorepo siblings beside the journal (assert-journal-build-context.mjs). Set PLATFORM_BUILD_CONTEXT_ROOTS to the host checkout on api+worker, or run platform_shell_seed once. Tenant apps: prefer project 1 sdk/shared-ui git journals + .gitmodules symlink bind — not import_tree per app.", "journal_not_initialized": "Git journal missing under the bucket workspace — hosting.git.init before git push or site.build.", "journal_requires_push": "Catalog git_journal bucket — workspace SHA builds are disabled. Run hosting.git.init, push refs/heads/dev (preview), then main or promote_branch for prod.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "module_not_resolved": "error_tail names the missing import. Fix the journal resolve or dependency, push dev, poll hosting.site.build_status, test the --dev URL, then target=prod.", "npm_install_failed": "error_tail is the npm error. Fix the lockfile or sibling package, push dev, poll hosting.site.build_status. Promote with target=prod only after the preview completes.", "platform_shell_layout_missing": "site.build.yaml is the platform monorepo file but this bucket has no agentstack-unified-sdk tree. Delete that yaml and run hosting.workspace.init with profile static or node_vite. Do not import_tree the SDK into this bucket. Platform shell seed is ops-only; app SDK pins are .gitmodules.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen the key with apikeys.create preset user_full, or Device Code --scope-preset=full. Same denial on hosting.git.init, hosting.workspace.init, and hosting.site.build.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_build_in_progress": "Another site.build holds the bucket lock — poll hosting.site.build_status with job_id from enqueue or build_already_queued", "site_not_found": "hosting.project.status — confirm primary site before file ops", "submodule_link_missing": "App .gitmodules points at agentstack.tech git but projects/1/_sources/{sdk|shared-ui} is missing, empty, or vendor/ could not symlink. hosting.git.init bucket_name=sdk (and shared-ui if pinned), then seed once (ops setup_platform_git_library.py --library sdk, or git push to /api/git/1/sdk.git). Fix .gitmodules to https://agentstack.tech/api/git/1/sdk.git; package.json file:vendor/...; poll build_status. No worker git clone and no import_tree SDK into tenant buckets.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "workspace_sources_sha_truncated": "Source hash walks the whole tree. Bulk copy is hosting.workspace.import_tree, then hosting.site.build. hosting.deploy_files writes live bytes, not workspace sources."}, "when_not_to_use": "Push to dev expecting preview without git — use git push dev or hosting.site.build target=dev. Do not use target=prod before dev preview is verified.", "when_to_use": "Compile bucket workspace/ (site.build.yaml) into a release. target=dev writes preview and /s/{pid}/{name}--dev/. target=prod moves current. Push refs/heads/dev to build the preview. Push refs/heads/ma", "write_mode": null}, {"action": "hosting.site.build_status", "aliases": ["hosting.build.status", "hosting.site.build.poll", "hosting.site.build.status"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Poll only — not a build trigger. Re-enqueue via hosting.site.build when job failed or stale.", "anti_patterns": ["Poll only — not a build trigger. Re-enqueue via hosting.site.build when job failed or stale.", "Params are job_id only — do not pass bucket_name, target, publish, or force from hosting.site.build.", "Aliases hosting.site.build.status / hosting.build.status share the same poll schema."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.build_status", "related_tools": ["hosting.site.build", "hosting.site.build_cancel", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Build Status"}, "do_not_use_when": "Enqueue or change target — use hosting.site.build with bucket_name + target; status is poll-only with job_id from enqueue.", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Poll build job", "request": {"params": {"job_id": "00000000-0000-0000-0000-000000000000"}, "tool": "hosting.site.build_status"}}, {"name": "Running job response", "response": {"job": {"job_id": "…", "status": "running", "target": "dev"}, "ok": true, "verification_action": "hosting.site.build_status"}}, {"name": "Failed gate response", "response": {"error_code": "hosting_gate_failed", "job": {"error": "hosting_gate_failed:missing_index_html", "error_code": "hosting_gate_failed", "status": "failed"}, "ok": true}}], "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_BUILD_PROOF_SIDECARS": "After hosting.site.build publish, live/preview trees expose build-id.txt and sources-sha.txt for edge probes, plus changelog.json (JSON Feed) and changelog.html when git projection succeeds. hosting.workspace.meta sources_sha is the workspace hash before build — sidecars update after publish. Do not hand-PUT sidecars; rebuild or ensure_proof_tree_provenance on ops paths.", "HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_SUBMODULE_LINK_MISSING": "App .gitmodules URL https://agentstack.tech/api/git/1/sdk.git (or shared-ui) must resolve to projects/1/_sources/{bucket} on the worker. One-time: hosting.git.init project_id=1 bucket_name=sdk and shared-ui (or ops setup_platform_git_library.py). The build symlinks vendor/ — no import_tree or git submodule update on the worker. Fix .gitmodules paths, push HEAD:dev, poll build_status.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": [{"action": "hosting.site.build_status", "params": {"job_id": "<from enqueue>"}, "why": "Poll until completed or failed."}, {"action": "hosting.git.promote_branch", "params": {"bucket_name": "<from prior result>", "project_id": "<context.project_id>", "ref": "dev", "target": "prod"}, "why": "After dev job=completed: open /s/{project_id}/{bucket_name}--dev/ then promote to prod."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.site.build", "hosting.site.build_cancel", "hosting.site.edge_health"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_site_build_status", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Poll async hosting.site.build job by job_id.", "title": "Hosting Site Build Status", "verification": "Terminal: completed → check changelog_degraded / changelog_skip_reason on poll body; optional hosting.site.edge_health; failed → error_code → HOSTING_WHEN_BLOCKED ladder; re-enqueue via hosting.site.build.", "when_blocked": {"build_cmd_failed": "Read error_tail and failed_cmd. Fix package.json/site.build.yaml in workspace (patch_plane=workspace). Land on dev: git push agentstack HEAD:dev or hosting.git.promote_branch ref=HEAD target=dev with git_push on patch. Poll hosting.site.build_status. Green dev preview → hosting.git.promote_branch ref=dev target=prod (not hosting.site.build target=prod as first go-live).", "build_cwd_missing": "site.build.yaml cwd is not in the journal. Fix the recipe, push dev, poll build_status.", "build_job_stale_running": "Worker died mid-build — job failed automatically. Re-run hosting.site.build with force=true or push dev again after fixing workspace.", "build_timeout": "Raise build_timeout_seconds or shrink the step, push dev, poll hosting.site.build_status.", "bytes_exceeded": "Staged build output exceeds the byte cap. Shrink the dist, push dev, poll hosting.site.build_status.", "changelog_degraded": "Release published but public changelog.json was not refreshed (git read error, output size cap, or preserve-stale path). completed jobs expose changelog_degraded; when site.build.yaml sets changelog_strict=true the job fails with this code. hosting.git.log for the operator slice; fix journal or lower changelog_limit; rebuild with force=true.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "job_id_required": "Missing job_id — run hosting.site.build first and poll with the returned job_id.", "job_lost_after_restart": "Job file is gone after restart — do not poll the same id. hosting.project.status → hosting.site.build (new enqueue) → poll the new job_id only.", "job_not_found": "Unknown or expired job_id — do not poll the same id for minutes. hosting.project.status → hosting.site.build (new enqueue) → poll the new job_id only.", "journal_context_missing": "Platform shell worker layout: monorepo siblings beside the journal (assert-journal-build-context.mjs). Set PLATFORM_BUILD_CONTEXT_ROOTS to the host checkout on api+worker, or run platform_shell_seed once. Tenant apps: prefer project 1 sdk/shared-ui git journals + .gitmodules symlink bind — not import_tree per app.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "module_not_resolved": "error_tail names the missing import. Fix the journal resolve or dependency, push dev, poll hosting.site.build_status, test the --dev URL, then target=prod.", "npm_install_failed": "error_tail is the npm error. Fix the lockfile or sibling package, push dev, poll hosting.site.build_status. Promote with target=prod only after the preview completes.", "platform_shell_layout_missing": "site.build.yaml is the platform monorepo file but this bucket has no agentstack-unified-sdk tree. Delete that yaml and run hosting.workspace.init with profile static or node_vite. Do not import_tree the SDK into this bucket. Platform shell seed is ops-only; app SDK pins are .gitmodules.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "submodule_link_missing": "App .gitmodules points at agentstack.tech git but projects/1/_sources/{sdk|shared-ui} is missing, empty, or vendor/ could not symlink. hosting.git.init bucket_name=sdk (and shared-ui if pinned), then seed once (ops setup_platform_git_library.py --library sdk, or git push to /api/git/1/sdk.git). Fix .gitmodules to https://agentstack.tech/api/git/1/sdk.git; package.json file:vendor/...; poll build_status. No worker git clone and no import_tree SDK into tenant buckets.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "hosting.site.build_status accepts job_id only — not bucket_name, target, or project_id. Copy job_id from hosting.site.build (or build_already_queued) enqueue response; re-enqueue with hosting.site.build when you need a new build."}, "when_not_to_use": "Enqueue or change target — use hosting.site.build with bucket_name + target; status is poll-only with job_id from enqueue.", "when_to_use": "Poll hosting.site.build when async=true (default). job_id from the enqueue response. On failed: job.error_code maps to when_blocked — platform_shell_layout_missing → delete site.build.yaml and hosting", "write_mode": null}, {"action": "hosting.site.build_cancel", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.build_cancel", "mutation_risk": "high", "related_tools": ["hosting.site.build_status", "hosting.site.build", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Build Cancel"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Cancels pending or running build for bucket target (dev|prod). No-op when job already terminal.", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Cancel a pending or running async build using job_id from hosting.site.build_status. Does not rever…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.site.build_status", "hosting.site.build", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "hosting_site_build_cancel", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Cancel a pending or running hosting.site.build job.", "title": "Hosting Site Build Cancel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "job_id_required": "Pass job_id from hosting.site.build enqueue response", "job_not_found": "Unknown or expired job_id — do not poll the same id for minutes. hosting.project.status → hosting.site.build (new enqueue) → poll the new job_id only.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_cancellable": "Job already terminal — poll hosting.site.build_status; enqueue a new hosting.site.build with force after a successful cancel of pending|running only.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cancel a pending or running async build using job_id from hosting.site.build_status. Does not revert a completed release — use hosting.release.promote rollback when live is wrong.", "write_mode": null}, {"action": "hosting.git.migrate", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.migrate", "mutates_when": {"dry_run": false}, "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Migrate"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true returns planned adopt/migrate steps only; dry_run=false rewrites workspace git layout and protected sources binding", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Repair AgentGit journal/worktree/hooks for legacy buckets. dry_run=true lists steps only; dry_run=f…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "hosting_git_migrate", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Repair AgentGit journal/worktree/hooks for legacy hosting buckets.", "title": "Hosting Git Migrate", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "git_repo_missing": "Existing bucket: hosting.git.init with bucket_name or bucket_id. hosting.site.quick_start only when hosting.project.status shows no site.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Repair AgentGit journal/worktree/hooks for legacy buckets. dry_run=true lists steps only; dry_run=false refreshes hooks and may rewrite post-receive when project_id and bucket_id are set.", "write_mode": null}, {"action": "hosting.workspace.init", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.init", "mutation_risk": "low", "related_tools": ["hosting.workspace.file.put", "hosting.site.build", "hosting.workspace.meta"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace Init"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Greenfield React journal", "request": {"params": {"bucket_name": "frontend", "profile": "node_vite", "project_id": 1}, "tool": "hosting.workspace.init"}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_BATCH_SEMANTIC_ANCHOR": "Sync hosting mutations need a batch anchor: options.execution_intent=direct, options.goal, or preflight.check in the same execute. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor. Poll hosting.site.build_status in a separate execute — one job_id per poll loop; honor poll_backoff_ms; stop when status is completed|failed|cancelled or on job_not_found (re-list via hosting.project.status then hosting.site.build).", "HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_MCP_AUTH_FOR_MUTATIONS": "hosting.* writes need session_ready + can_execute_mutation + service caps (user_full / Connect OAuth). service_cap_denied on hosting.workspace.init: widen API key (apikeys.create preset user_full) or Device Code --scope-preset=full — same recovery as other MCP mutations. VPS SSH scripts are ops fallback only; agents should use MCP with context.project_id on every execute. CLI bridge: node provided_plugins/cursor-plugin/scripts/mcp-execute.mjs --project-id <pid> --execution-intent direct <action> --params '{...}' (avoids batch_semantic_anchor_required).", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.workspace.file.put", "hosting.site.build", "hosting.workspace.meta"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_workspace_init", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Prepare bucket workspace/ (the tree hosting.site.build compiles). seed_from_live copies live only when index.html is absent. mirror_from_live overwrites workspace copies from the live site so a later ", "title": "Hosting Workspace Init", "when_blocked": {"batch_semantic_anchor_required": "Default async=true still needs a batch anchor: options.execution_intent=direct, options.goal, or preflight.check. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor.", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen the key with apikeys.create preset user_full, or Device Code --scope-preset=full. Same denial on hosting.git.init, hosting.workspace.init, and hosting.site.build.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create workspace/site.build.yaml beside releases/current for any project bucket. Then hosting.workspace.file.put and hosting.site.build.", "write_mode": null}, {"action": "hosting.workspace.meta", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.meta", "related_tools": ["hosting.workspace.init", "hosting.workspace.files.list", "hosting.site.build", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace Meta"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Light read for one bucket — workspace_initialized, sources_sha, operator_ssh_workspace_root. Prefer…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.workspace.init", "hosting.workspace.files.list", "hosting.site.build", "hosting.project.status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_workspace_meta", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Per-bucket workspace init flag and sources_sha (no full project.status scan).", "title": "Hosting Workspace Meta", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Light read for one bucket — workspace_initialized, sources_sha, operator_ssh_workspace_root. Prefer over hosting.project.status with include_workspace_meta when UI only needs one site.", "write_mode": null}, {"action": "hosting.workspace.files.list", "aliases": ["hosting.workspace.file.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.files.list", "related_tools": ["hosting.workspace.file.get", "hosting.workspace.file.put"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace Files List"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "List source paths under bucket workspace/ (not the live current tree).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.workspace.file.get", "hosting.workspace.file.put"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_workspace_files_list", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "List source files in bucket workspace/ (not the live current tree).", "title": "Hosting Workspace Files List", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List source paths under bucket workspace/ (not the live current tree).", "write_mode": null}, {"action": "hosting.workspace.file.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.file.get", "related_tools": ["hosting.workspace.file.put", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace File Get"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Read a source file in workspace/ before editing. Live served bytes are hosting.bucket.file.get.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.workspace.file.put", "hosting.site.build"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_workspace_file_get", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Read a source file from bucket workspace/ (edit tree, not live /s/).", "title": "Hosting Workspace File Get", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "path_required": "Pass path relative to workspace/ — hosting.workspace.files.list to discover paths", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "workspace_file_missing": "File absent in workspace/ — hosting.workspace.init or seed_from_live", "workspace_path_escape": "Path escapes workspace root — use a relative path under workspace/", "workspace_path_invalid": "Path must be relative under workspace/ without .. segments"}, "when_to_use": "Read a source file in workspace/ before editing. Live served bytes are hosting.bucket.file.get.", "write_mode": null}, {"action": "hosting.workspace.file.put", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.file.put", "mutation_risk": "low", "related_tools": ["hosting.workspace.files.list", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace File Put"}, "do_not_use_when": "Operator laptop without MCP/API session — use platform_tooling.py vps fs put/push against operator_ssh_workspace_root from hosting.workspace.meta (SSH break-glass only).", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "error_hints": [{"code": "validation_error", "tip": "Strip data: URL prefix; never pass PLACEHOLDER / YOUR_TOKEN literals as base64. Prefer UTF-8 content or hosting.bucket.file.patch search_replace over base64."}], "examples": [{"name": "Put React source", "request": {"params": {"bucket_name": "frontend", "content": "export default function App() { return <h1>Hi</h1>; }", "path": "src/App.tsx", "project_id": 1}, "tool": "hosting.workspace.file.put"}}, {"name": "Equivalent patch plane", "request": {"params": {"bucket_name": "frontend", "git_commit": true, "git_push": true, "patch_plane": "workspace", "path": "src/App.tsx", "project_id": 1, "write_mode": "replace"}, "tool": "hosting.bucket.file.patch"}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_BASE64_DECODE": "Strip data: URL prefix; never pass PLACEHOLDER / YOUR_TOKEN literals as base64. Prefer UTF-8 content or hosting.bucket.file.patch search_replace over base64.", "HOSTING_BASE64_PADDING": "content_base64 validation_error: strip whitespace, add = until length % 4 — invalid padding fails before decode.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.workspace.files.list", "hosting.site.build"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_workspace_file_put", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Write a source file into bucket workspace/. Publish with hosting.site.build.", "title": "Hosting Workspace File Put", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "content_required": "Pass UTF-8 content or content_base64 for workspace writes — hosting.workspace.file.get before full replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "path_required": "Pass path relative to workspace/ — hosting.workspace.files.list to discover paths", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "workspace_file_too_large": "Split file or use hosting.deploy_files for large assets", "workspace_path_escape": "Path escapes workspace root — use a relative path under workspace/", "workspace_path_invalid": "Path must be relative under workspace/ without .. segments"}, "when_not_to_use": "Operator laptop without MCP/API session — use platform_tooling.py vps fs put/push against operator_ssh_workspace_root from hosting.workspace.meta (SSH break-glass only).", "when_to_use": "Write source into workspace/ next to the compiled site. Publish with hosting.site.build. Binary assets: content_base64 (same as hosting.files.put).", "write_mode": null}, {"action": "hosting.workspace.file.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.file.delete", "mutation_risk": "high", "related_tools": ["hosting.workspace.files.list", "hosting.workspace.file.put", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace File Delete"}, "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Remove a workspace source path. Does not delete live /s/ bytes — use hosting.site.build after edits.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.workspace.files.list", "hosting.workspace.file.put", "hosting.site.build"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_workspace_file_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete a source file from bucket workspace/ (not live current).", "title": "Hosting Workspace File Delete", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "path_required": "Pass path relative to workspace/ — hosting.workspace.files.list to discover paths", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "workspace_file_missing": "File absent in workspace/ — hosting.workspace.init or seed_from_live", "workspace_path_escape": "Path escapes workspace root — use a relative path under workspace/", "workspace_path_invalid": "Path must be relative under workspace/ without .. segments"}, "when_to_use": "Remove a workspace source path. Does not delete live /s/ bytes — use hosting.site.build after edits.", "write_mode": null}, {"action": "hosting.verify", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Post-publish smoke only — not hosting.bucket.file.get.", "anti_patterns": ["Post-publish smoke only — not hosting.bucket.file.get.", "Do not poll before deploy finishes — run after hosting.deploy_files or patch publish.", "Do not call hosting.verify and hosting.site.edge_health in the same loop — pick one."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.verify", "related_tools": ["hosting.site.edge_health", "hosting.release.promote", "hosting.deploy_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Verify"}, "do_not_use_when": "Before live bytes exist — verify after publish or patch with publish=true.", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Post-publish smoke — alias of hosting.site.edge_health with verify_kind=edge_health.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.site.edge_health", "hosting.release.promote", "hosting.deploy_files"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_verify", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Verify live/preview hosting health (alias of hosting.site.edge_health; intent taxonomy edge_health).", "title": "Hosting Verify", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Before live bytes exist — verify after publish or patch with publish=true.", "when_to_use": "Post-publish smoke — alias of hosting.site.edge_health with verify_kind=edge_health.", "write_mode": null}, {"action": "hosting.deploy_files", "aliases": ["hosting.deploy", "hosting.deploy.files", "hosting.publish", "hosting.upload_session"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "replace_site=true requires confirm_site_replace=true — default overlay preserves live pages.", "anti_patterns": ["replace_site=true requires confirm_site_replace=true — default overlay preserves live pages.", "Do not deploy_files for one-line CSS — use hosting.bucket.file.patch.", "Write one file with hosting.files.put. List with hosting.bucket.files.list.", "dry_run previews paths and does not write. publish defaults true and needs index.html on the live tree.", "dry_run fail-closed: gate_would_pass=false when missing_references or static_gate_issues (secrets, bytes, index) — fix before publish.", "reference_warnings (foreign_project / foreign_site_slug): cross-site /s/{pid}/{slug}/ links are informational — not missing_references; prefer same-site relative paths."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false, "publish": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.deploy_files", "mutates_when": {"dry_run": false, "publish": true}, "mutation_risk": "low", "related_tools": ["permissions.effective", "preflight.check", "hosting.site.resolve", "hosting.site.edge_health", "hosting.release.promote"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Hosting Deploy Files"}, "do_not_use_when": "Single-file text edit on existing /s/ path.", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_param_sensitive": true, "conditional_mutate": "Omitted publish goes live. dry_run=true returns manifest_diff only. publish=false finalizes without going live. confirm_prune when removed[] is non-empty.", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false, "publish": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "error_hints": [{"code": "validation_error", "tip": "Strip data: URL prefix; never pass PLACEHOLDER / YOUR_TOKEN literals as base64. Prefer UTF-8 content or hosting.bucket.file.patch search_replace over base64."}], "example_params": {"bucket_id": "example_string", "bucket_name": "example_string", "confirm_prune": true, "confirm_site_replace": true, "dry_run": true, "files": [], "finalize": true, "mode": "example_string", "project_id": 123, "publish": true, "publish_graph_snapshot": true, "replace_site": true, "upload_session_id": "example_string"}, "example_request": {"action": "hosting.deploy_files", "params": {"bucket_id": "example_string", "bucket_name": "example_string", "confirm_prune": true, "confirm_site_replace": true, "dry_run": true, "files": [], "finalize": true, "mode": "example_string", "project_id": 123, "publish": true, "publish_graph_snapshot": true, "replace_site": true, "upload_session_id": "example_string"}}, "examples": [{"name": "Dry-run path preview (L2 read-class)", "request": {"params": {"dry_run": true, "files": [{"content_base64": "PGg+PC9oPg==", "path": "docs/index.html"}], "project_id": 1444, "publish": false}, "tool": "hosting.deploy_files"}, "response": {"data": {"dry_run": true, "paths": ["docs/index.html"]}, "success": true}}, {"name": "Before live publish — preflight + permissions", "request": {"params": {"action": "hosting.deploy_files", "action_params": {"files": [{"bytes": 1200, "path": "docs/index.html"}], "publish": true}, "execution_intent": "direct", "project_id": 1444}, "tool": "preflight.check"}, "response": {"data": {"effect_policy_allowed": true}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_BASE64_DECODE": "Strip data: URL prefix; never pass PLACEHOLDER / YOUR_TOKEN literals as base64. Prefer UTF-8 content or hosting.bucket.file.patch search_replace over base64.", "HOSTING_BASE64_PADDING": "content_base64 validation_error: strip whitespace, add = until length % 4 — invalid padding fails before decode.", "HOSTING_COPYTREE_ANTIPATTERN": "Do not hosting.deploy_files an entire compiled SPA into preview/dev. Use hosting.site.build target=dev, hosting.workspace.import_tree, or ops seed_dev_preview_minimal — never bulk-copy live current/ as deploy_files. Symlink fallback on disk copies public live root only (not releases/).", "HOSTING_GENERATION_ENV_OMIT": "Omit generation_env_uuid on hosting.* byte writes — site edits do not fork. A stale uuid in batch context fails auto-fork; let the server keep the sandbox head. generation_fork_required on hosting.deploy_files is a status-projection defect: another generation.fork does not repair the bytes.", "HOSTING_POST_DEPLOY_VERIFY": "After hosting.deploy_files publish on flagship tenants: run agentstack-core/scripts/unity/unity_post_deploy_verify_1444.py (--prod-only or --quick). Published HTML/JSON report includes priemka_coverage (68 checklist items) — do not treat report.ok as full priemka sign-off when manual/partial counts remain.", "HOSTING_REPLACE_SITE_CONFIRM": "replace_site=true wipes live pages — pass confirm_site_replace=true after dry_run. Default overlay: replace_site=false (merge upload).", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Upload static files to a hosting bucket (HTML, assets, text batches — not ZIP archives). ZIP / Vite…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "pending_state": "publish=true leaves success=false until hosting.site.edge_health shows edge ready (mutation receipt committed=false).", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["permissions.effective", "preflight.check", "hosting.site.resolve", "hosting.site.edge_health", "hosting.release.promote"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["hosting.release.promote"], "safe_action": "hosting_deploy_files", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Batch-upload files to a bucket and optionally publish (max 50 files per call, 2MiB inline per file). Large trees: chunk with finalize=false (server returns upload_session_id), then repeat with same up", "title": "Hosting Deploy Files", "verification": ["hosting.project.status", "hosting.site.edge_health"], "verify": [{"action": "hosting.project.status", "predicate": "named resource is visible"}, {"action": "hosting.site.edge_health", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosting_archive_quota_exceeded": "Project release-archive bytes over buff cap — hosting.release.list, delete stale releases (hosting.release.delete), or upgrade limits. Live publish can succeed; auto_snapshot is soft-fail only.", "hosting_gate_failed": "Publish gates failed on staged build — read issues[] / error_tail. Common node_vite: absolute href/src like /messenger/assets/... while preview is /s/{pid}/{bucket}--dev/ — rebuild with vite --base ./ in site.build.yaml. Then push dev and poll hosting.site.build_status.", "hosting_inline_file_too_large": "Inline MCP cap 2MiB/file — hosting.site.upload_grant (alias storage.upload_grant) + HTTP POST for ZIP; or hosting.deploy_files with finalize=false and reuse upload_session_id from response; not one giant app.js in JSON", "hosting_missing_reference": "Static href/src/url() points at a path not in the deploy batch or live bucket — hosting.deploy_files dry_run lists missing_references; upload assets or fix links", "hosting_prune_requires_confirmation": "Publish would drop live paths absent from files[] — run dry_run, review manifest_diff.removed, then confirm_prune=true.", "hosting_quota_exceeded": "Project hosting byte quota full (live tree + workspace) — hosting.release.list, delete stale releases (hosting.release.delete), or raise hosting buff. Same recovery as hosting_archive_quota_exceeded; snapshot may soft-fail while publish succeeds.", "hosting_replace_requires_confirmation": "replace_site=true requires confirm_site_replace=true — run dry_run first to preview paths", "hosting_snapshot_rate_limited": "Upload/publish succeeded; hourly snapshot cap hit — skip manual snapshot. Poll hosting.site.edge_health if the public URL is not ready.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "L2 admin RBAC — preflight.check or permissions.effective action=hosting.deploy_files (action_params.publish=true, slim files:[{path,bytes}] for probes); rbac.check_permission(admin). If admin granted but deploy/preflight denies: stale permissions_bitmap — reconnect OAuth; ops scripts use execution_intent=direct; core bitmap_session_reconcile + hydrate_mcp_execute_principal.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_not_to_use": "Single-file text edit on existing /s/ path.", "when_to_use": "Upload static files to a hosting bucket (HTML, assets, text batches — not ZIP archives). ZIP / Vite dist: hosting.site.import_archive or hosting.site.upload_grant. Before large publish: permissions.ef", "write_mode": null}, {"action": "hosting.bucket.files.list", "aliases": ["hosting.bucket.file.list", "hosting.bucket.list", "hosting.bucket.list_files", "hosting.buckets.list", "hosting.files.list", "hosting.site.list_files"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.files.list", "related_tools": ["hosting.project.status", "hosting.bucket.file.get", "hosting.bucket.file.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket Files List"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "List objects in a site bucket (prefix, cursor, optional q path filter ≥2 chars). Prefer prefix=fold…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.status", "hosting.bucket.file.get", "hosting.bucket.file.patch"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_bucket_files_list", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "List files in a hosting bucket (optional prefix, cursor pagination, optional q path substring filter).", "title": "Hosting Bucket Files List", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List objects in a site bucket (prefix, cursor, optional q path filter ≥2 chars). Prefer prefix=folder/ for junk sweeps — avoids full-bucket scan. Use before bulk_delete or when patch path is unknown.", "write_mode": null}, {"action": "hosting.sync.plan", "aliases": ["hosting.site.manifest", "hosting.sync.manifest"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Read-only manifest — options.goal is not required.", "anti_patterns": ["Read-only manifest — options.goal is not required.", "Diff locally, upload chunks via hosting.deploy_files + upload_session_id, then hosting.sync.commit.", "Default include_hashes=false — do not sha256-scan large buckets unless diff needs hashes."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.sync.plan", "related_tools": ["hosting.deploy_files", "hosting.sync.commit", "hosting.bucket.files.list", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Sync Plan"}, "do_not_use_when": "Upload without a local tree diff — use hosting.deploy_files directly.", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Live-tree manifest (path, bytes, stat_fingerprint). Set include_hashes=true only when you need sha2…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.deploy_files", "hosting.sync.commit", "hosting.bucket.files.list", "hosting.project.status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_sync_plan", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Server manifest (path, sha256, bytes) for client-side hash diff before batched upload.", "title": "Hosting Sync Plan", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Upload without a local tree diff — use hosting.deploy_files directly.", "when_to_use": "Live-tree manifest (path, bytes, stat_fingerprint). Set include_hashes=true only when you need sha256 (heavy). Diff locally, upload via hosting.deploy_files with upload_session_id, then hosting.sync.c", "write_mode": null}, {"action": "hosting.sync.commit", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Finalizes upload_session staging — set finalize via commit, not a second full zip upload.", "anti_patterns": ["Finalizes upload_session staging — set finalize via commit, not a second full zip upload.", "options.goal is not required for commit when only promoting staged bytes."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"publish": true}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.sync.commit", "mutates_when": {"publish": true}, "mutation_risk": "low", "related_tools": ["hosting.sync.plan", "hosting.deploy_files", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Sync Commit"}, "do_not_use_when": "Before all deploy_files chunks for upload_session_id are staged.", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_param_sensitive": true, "conditional_mutate": "publish defaults true — set publish=false for finalize-only", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "mutates_when": {"publish": true}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Finalize upload_session after all deploy_files chunks land; publish defaults true. options.goal not…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.sync.plan", "hosting.deploy_files", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_sync_commit", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Finalize upload_session staging and optionally publish (after hosting.deploy_files chunks).", "title": "Hosting Sync Commit", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_not_to_use": "Before all deploy_files chunks for upload_session_id are staged.", "when_to_use": "Finalize upload_session after all deploy_files chunks land; publish defaults true. options.goal not required for byte promote.", "write_mode": null}, {"action": "hosting.content.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not use for HTML/CSS/JS — hosting.bucket.file.patch on the served path.", "anti_patterns": ["Do not use for HTML/CSS/JS — hosting.bucket.file.patch on the served path.", "Do not projects.patch_data for site bytes — bucket file patch is the SoT.", "Do not GET+hand-edit YAML when patch_path segments are known."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.content.patch", "mutation_risk": "low", "related_tools": ["hosting.bucket.file.patch", "hosting.bucket.file.get", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Content Patch"}, "do_not_use_when": "Binary or large HTML bodies — use hosting.bucket.file.patch replace.", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Structured YAML leaf writes (default content/site.yaml) without hand-editing HTML. Uses hosting.buc…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.bucket.file.patch", "hosting.bucket.file.get", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_content_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch content/site.yaml (or other YAML path) via structured path/value writes.", "title": "Hosting Content Patch", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "extension_not_patchable": "Text patch on live allows html, css, js, ts, json, md, txt, svg only — not tsx/jsx/yaml. React/Vite sources: hosting.workspace.file.put or patch_plane=workspace. Missing package.json on live tree means edit workspace/, not served /s/ bytes.", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "revision_conflict": "expected_sha256 mismatch — hosting.bucket.file.get then retry with fresh content_sha256", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_not_to_use": "Binary or large HTML bodies — use hosting.bucket.file.patch replace.", "when_to_use": "Structured YAML leaf writes (default content/site.yaml) without hand-editing HTML. Uses hosting.bucket.file.patch replace under the hood — pair with site.build when enabled.", "write_mode": null}, {"action": "hosting.bucket.grep", "aliases": ["hosting.bucket.search", "hosting.files.grep"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not grep the whole bucket without glob=*.html or prefix=assets/ — default max_files=80 truncates.", "anti_patterns": ["Do not grep the whole bucket without glob=*.html or prefix=assets/ — default max_files=80 truncates.", "Do not use grep instead of hosting.bucket.file.patch when the target string is already known.", "truncated=true — narrow glob/prefix before raising max_files above 80.", "truncated_reason is max_files|max_matches — tighten glob/prefix before raising caps."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.grep", "related_tools": ["hosting.project.status", "hosting.bucket.files.list", "hosting.bucket.file.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket Grep"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Find substring/regex in live UTF-8 text files before planning many search_replace patches. Always p…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.status", "hosting.bucket.files.list", "hosting.bucket.file.patch"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_bucket_grep", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Search UTF-8 bucket text files for a substring or regex. Optional glob (e.g. *.html) and prefix narrow the scan. Returns truncated=true when max_files or max_matches hit — tighten glob/prefix first.", "title": "Hosting Bucket Grep", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "hosting_grep_truncated": "truncated_reason max_files|max_matches — add glob or prefix, then hosting.bucket.file.patch. Do not raise max_files to 500 on the first retry.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Find substring/regex in live UTF-8 text files before planning many search_replace patches. Always pass glob (e.g. *.css) or prefix. Defaults: max_files=80, max_matches=200; truncated=true means tighte", "write_mode": null}, {"action": "hosting.gc.ix", "annotations": {"destructiveHint": true, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.gc.ix", "mutates_when": {"dry_run": false}, "mutation_risk": "high", "related_tools": ["hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Gc Ix"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true lists orphans; default dry_run=false removes symlinks", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Ecosystem-admin repair of stale hosting_buckets/_ix symlinks after list/patch drift — not for tenan…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.status"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_gc_ix", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Prune orphan hosting_buckets/_ix symlinks (admin diagnostics broken_ix).", "title": "Hosting Gc Ix", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem admin required — auth.get_profile for owner role", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ecosystem-admin repair of stale hosting_buckets/_ix symlinks after list/patch drift — not for tenant file edits.", "write_mode": null}, {"action": "hosting.bucket.file.get", "aliases": ["hosting.site.asset", "hosting.site.asset.get", "hosting.storage.download", "storage.download"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not use storage.upload to read /s/ site files.", "anti_patterns": ["Do not use storage.upload to read /s/ site files.", "search_replace does not need a prior GET. Read the file when you need its bytes."], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.file.get", "related_tools": ["hosting.bucket.file.patch", "hosting.project.status", "hosting.bucket.files.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket File Get"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Read site bytes when the edit is unknown. UTF-8 comes back whole until 64000 characters; pass offse…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.bucket.file.patch", "hosting.project.status", "hosting.bucket.files.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_bucket_file_get", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Read a bucket file. UTF-8 text is a window only past 64000 characters (offset). Base64 is the file read, max 2MB.", "title": "Hosting Bucket File Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "not_ready": "Batch write still projecting — poll hosting.bucket.file.get or hosting.bucket.files.list", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read site bytes when the edit is unknown. UTF-8 comes back whole until 64000 characters; pass offset only when truncated is true. A known search_replace skips this GET.", "workflow_ladder": ["hosting.project.status — if primary_public_url is set, edit that bucket", "hosting.bucket.file.patch search_replace — replacements [{\"find\":\"...\",\"replace\":\"...\"}]. Pass expected_sha256 when you have it. Identical bytes skip the write", "agent_completion.done — gzip and cache_bust already ran. Skip edge_health unless the public URL 404s"], "write_mode": null}, {"action": "hosting.bucket.file.patch", "ai_tips": "One UTF-8 text edit. patch_plane=live (default) patches served /s/ and refreshes .gz. patch_plane=workspace edits sources beside releases — pair with hosting.site.build. Default write_mode=search_replace + replacements; use replace for full-file body.", "aliases": ["hosting.bucket.file.content_patch", "hosting.file.patch", "hosting.files.patch", "hosting.workspace.file.patch"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not use storage.upload for in-place site edits.", "anti_patterns": ["Do not use storage.upload for in-place site edits.", "When workspace/ has site.build.yaml, edit sources with patch_plane=workspace or hosting.workspace.file.put — not live assets.", "Do not search_replace assets/index-*.js. That file is build output. Edit src, then build and publish.", "Do not call generation.fork for a single CSS/HTML line change.", "Do not bulk_delete the .gz sibling. gzip_sibling on the result means it was refreshed.", "Do not hand-edit the script query. cache_bust index.html means the src was updated."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1", "core.hosting.mcp_file_edit.gen1"], "id": "hosting.bucket.file.patch", "mutates_when": {"dry_run": false}, "mutation_risk": "low", "related_tools": ["hosting.bucket.file.get", "hosting.project.status", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket File Patch"}, "do_not_use_when": "Do not patch assets/index-*.js. App Studio source uses ai_builder.source.patch.", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true returns diff only (no bucket write); default applies UTF-8 patch (mutate)", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"allow_shrink": true, "bucket_id": "example_string", "bucket_name": "example_string", "content": "example_string", "dry_run": true, "expected_sha256": "example_string", "git_commit": true, "git_push": true, "ops": [], "patch_plane": "live", "path": "example_string", "project_id": 123, "publish": true, "replacements": [], "strict_diff": true, "unified_diff": "example_string", "write_mode": "search_replace"}, "example_request": {"action": "hosting.bucket.file.patch", "params": {"allow_shrink": true, "bucket_id": "example_string", "bucket_name": "example_string", "content": "example_string", "dry_run": true, "expected_sha256": "example_string", "git_commit": true, "git_push": true, "ops": [], "patch_plane": "live", "path": "example_string", "project_id": 123, "publish": true, "replacements": [], "strict_diff": true, "unified_diff": "example_string", "write_mode": "search_replace"}}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_GENERATION_ENV_OMIT": "Omit generation_env_uuid on hosting.* byte writes — site edits do not fork. A stale uuid in batch context fails auto-fork; let the server keep the sandbox head. generation_fork_required on hosting.deploy_files is a status-projection defect: another generation.fork does not repair the bytes.", "HOSTING_STRICT_DIFF_HTML": ".html/.htm unified_diff is strict (no fuzzy) by default — use search_replace for small edits or strict_diff=false only when hunks are exact.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_file_edit", "agentstack_write_modes"], "related_tools": ["hosting.bucket.file.get", "hosting.project.status", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["hosting.release.promote"], "safe_action": "hosting_bucket_file_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Edit one UTF-8 file. Pass bucket_id (project 1 has many sites; omit only for the primary). write_mode=search_replace + replacements [{find, replace}] for a small edit. write_mode=replace (alias conten", "title": "Patch Hosted File", "verification": ["hosting.bucket.file.get"], "verify": [{"action": "hosting.bucket.file.get", "predicate": "named resource is visible"}], "when_blocked": {"ambiguous_anchor": "Multiple find matches — use a longer unique find or set count on the replacement pair", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "content_shrink_blocked": "allow_shrink=true when intentional, else search_replace for a partial edit", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "extension_not_patchable": "Text patch on live allows html, css, js, ts, json, md, txt, svg only — not tsx/jsx/yaml. React/Vite sources: hosting.workspace.file.put or patch_plane=workspace. Missing package.json on live tree means edit workspace/, not served /s/ bytes.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_path": "hosting.bucket.files.list — confirm path exists and suffix is patchable", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "patch_apply_failed": "hosting.bucket.file.get, then search_replace or strict_diff=true", "preview_too_large": "Output >2MB — search_replace a section or hosting.deploy_files for large assets", "replacement_not_found": "search_replace needs find and replace — hosting.bucket.file.get and confirm the substring", "revision_conflict": "expected_sha256 mismatch — hosting.bucket.file.get then retry with fresh content_sha256", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "secret_pattern_blocked": "Remove API keys / bearer literals from site bytes — use hosted session cookie flow", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_not_to_use": "Binary files, >2MB bodies, or files outside TEXT_PATCH suffix allowlist.", "when_to_use": "One UTF-8 text edit. patch_plane=live (default) patches served /s/ and refreshes .gz. patch_plane=workspace edits sources beside releases — pair with hosting.site.build. Default write_mode=search_repl", "workflow_ladder": ["hosting.project.status — if primary_public_url is set, edit that bucket", "hosting.bucket.file.patch search_replace — replacements [{\"find\":\"...\",\"replace\":\"...\"}]. Pass expected_sha256 when you have it. Identical bytes skip the write", "agent_completion.done — gzip and cache_bust already ran. Skip edge_health unless the public URL 404s"], "write_mode": null}, {"action": "hosting.site.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.delete", "mutation_risk": "low", "related_tools": ["hosting.release.snapshot", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Delete"}, "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Remove one hosted /s/ bucket. Read hosting.project.status first and delete only the duplicate slug,…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.release.snapshot", "hosting.project.status"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_site_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Remove a hosted site bucket (same as REST DELETE /api/hosting/buckets/{bucket_id}).", "title": "Hosting Site Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove one hosted /s/ bucket. Read hosting.project.status first and delete only the duplicate slug, not the primary site.", "write_mode": null}, {"action": "hosting.bucket.file.rename", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.file.rename", "mutation_risk": "low", "related_tools": ["hosting.bucket.file.get", "hosting.bucket.files.list", "hosting.project.status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket File Rename"}, "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Move or rename one object inside the site bucket. hosting.bucket.file.get to confirm source path be…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.bucket.file.get", "hosting.bucket.files.list", "hosting.project.status"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_bucket_file_rename", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Rename or move a file within a bucket.", "title": "Hosting Bucket File Rename", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "Path absent on bucket — hosting.bucket.files.list before patch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Move or rename one object inside the site bucket. hosting.bucket.file.get to confirm source path before rename.", "write_mode": null}, {"action": "hosting.bucket.files.bulk_delete", "aliases": ["hosting.bucket.bulk_delete", "hosting.bucket.files.delete", "hosting.files.bulk_delete"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.files.bulk_delete", "mutation_risk": "low", "related_tools": ["hosting.bucket.files.list", "hosting.release.snapshot", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Bucket Files Bulk Delete"}, "domain_title": "Demo Hosting MCP domain", "effect": {"conditional_mutate": "Destructive — execute batches need options.execution_intent=direct or workflow anchor (options.goal / focus_node_id). discovery.describe effect.audit_batch_allowed.", "execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Delete many paths or everything under a prefix — irreversible. hosting.release.snapshot then hostin…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.bucket.files.list", "hosting.release.snapshot", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "hosting_bucket_files_bulk_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete multiple files by path list or prefix.", "title": "Hosting Bucket Files Bulk Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "paths_or_prefix_required": "Pass paths[] or prefix — hosting.bucket.files.list to build the path set first", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete many paths or everything under a prefix — irreversible. hosting.release.snapshot then hosting.bucket.files.list.", "write_mode": null}, {"action": "hosting.visual.inspect", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.hosting.gen1"], "id": "hosting.visual.inspect", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Visual Inspect"}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Post-publish layout smoke (overflow/CTA/viewports) — not a substitute for hosting.site.edge_health.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_visual_inspect", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Capture viewport screenshots for visual QA (375 and 1440). Requires preview_url.", "title": "Hosting Visual Inspect", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id and bucket_id or bucket_name required for bucket file ops", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Post-publish layout smoke (overflow/CTA/viewports) — not a substitute for hosting.site.edge_health.", "write_mode": null}, {"action": "hosting.workspace.import_tree", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Import seeds workspace sources — follow with hosting.site.build, not deploy_files to live.", "anti_patterns": ["Import seeds workspace sources — follow with hosting.site.build, not deploy_files to live."], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.workspace.import_tree", "mutation_risk": "low", "related_tools": ["hosting.workspace.files.list", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Workspace Import Tree"}, "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Platform shell manifest import", "request": {"params": {"bucket_name": "frontend", "paths": ["agentstack-frontend", "agentstack-unified-sdk", "shared-ui", "scripts/docker"], "project_id": 1, "source_root": "/opt/agentstack"}, "tool": "hosting.workspace.import_tree"}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_COPYTREE_ANTIPATTERN": "Do not hosting.deploy_files an entire compiled SPA into preview/dev. Use hosting.site.build target=dev, hosting.workspace.import_tree, or ops seed_dev_preview_minimal — never bulk-copy live current/ as deploy_files. Symlink fallback on disk copies public live root only (not releases/).", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Copy an allowlisted directory into workspace sources. hosting.deploy_files is the live hotfix path,…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.workspace.files.list", "hosting.site.build"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_workspace_import_tree", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Copy an allowlisted source directory into the bucket workspace. Does not publish. hosting.deploy_files writes live bytes, not this tree.", "title": "Hosting Workspace Import Tree", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Copy an allowlisted directory into workspace sources. hosting.deploy_files is the live hotfix path, not the source tree.", "write_mode": null}, {"action": "hosting.site.settings.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.settings.patch", "mutation_risk": "low", "related_tools": ["hosting.project.set_primary_site", "hosting.site.build", "hosting.release.snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Site Settings Patch"}, "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Set mount_apex_hosts, csp_profile, or git upstream on one site. Same-edge host pointer. DNS and cer…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.project.set_primary_site", "hosting.site.build", "hosting.release.snapshot"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_site_settings_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch mount_apex_hosts, csp_profile, and git upstream on one site. This is the same-edge domain connection (hosting.domain.connect).", "title": "Hosting Site Settings Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Set mount_apex_hosts, csp_profile, or git upstream on one site. Same-edge host pointer. DNS and certificates stay a separate backlog.", "write_mode": null}, {"action": "hosting.domain.connect", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.domain.connect", "mutation_risk": "low", "related_tools": ["hosting.site.settings.patch", "hosting.site.edge_health", "hosting.release.snapshot"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Domain Connect"}, "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Point an already-served hostname at this site's current build. Same leaf as hosting.site.settings.p…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.site.settings.patch", "hosting.site.edge_health", "hosting.release.snapshot"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_domain_connect", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Alias of hosting.site.settings.patch for mount_apex_hosts on an already-served host.", "title": "Hosting Domain Connect", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "site_not_found": "hosting.project.status — confirm primary site before file ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_to_use": "Point an already-served hostname at this site's current build. Same leaf as hosting.site.settings.patch mount_apex_hosts. DNS and certificates stay backlog.", "write_mode": null}, {"action": "hosting.git.init", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.init", "mutation_risk": "low", "related_tools": ["hosting.git.status", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Init"}, "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Init frontend journal", "request": {"params": {"bucket_name": "frontend", "project_id": 1}, "tool": "hosting.git.init"}}, {"name": "Second bucket (messenger)", "request": {"params": {"bucket_name": "messenger", "project_id": 1}, "tool": "hosting.git.init"}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_BATCH_SEMANTIC_ANCHOR": "Sync hosting mutations need a batch anchor: options.execution_intent=direct, options.goal, or preflight.check in the same execute. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor. Poll hosting.site.build_status in a separate execute — one job_id per poll loop; honor poll_backoff_ms; stop when status is completed|failed|cancelled or on job_not_found (re-list via hosting.project.status then hosting.site.build).", "HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_GIT_PLANE_CHOOSER": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branches dev or main. (2) generation.promote moves 8DNA only (config, fleet, knowledge) — not site bytes. Pass env_uuid on the write params. Skip a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. (3) Platform checkouts agentstack-core and shared often have no git remote — they ship by VPS deploy. Empty origin means do not git push origin. agentstack-frontend tracks agentstack/dev. 'push to dev' is plane 1, not generation.promote and not target=prod.", "HOSTING_MCP_AUTH_FOR_MUTATIONS": "hosting.* writes need session_ready + can_execute_mutation + service caps (user_full / Connect OAuth). service_cap_denied on hosting.workspace.init: widen API key (apikeys.create preset user_full) or Device Code --scope-preset=full — same recovery as other MCP mutations. VPS SSH scripts are ops fallback only; agents should use MCP with context.project_id on every execute. CLI bridge: node provided_plugins/cursor-plugin/scripts/mcp-execute.mjs --project-id <pid> --execution-intent direct <action> --params '{...}' (avoids batch_semantic_anchor_required).", "HOSTING_SUBMODULE_LINK_MISSING": "App .gitmodules URL https://agentstack.tech/api/git/1/sdk.git (or shared-ui) must resolve to projects/1/_sources/{bucket} on the worker. One-time: hosting.git.init project_id=1 bucket_name=sdk and shared-ui (or ops setup_platform_git_library.py). The build symlinks vendor/ — no import_tree or git submodule update on the worker. Fix .gitmodules paths, push HEAD:dev, poll build_status.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": [{"action": "hosting.git.status", "params": {"bucket_name": "<from init>", "project_id": "<context.project_id>"}, "why": "Confirm journal is clean. Next is a local `git push agentstack HEAD:dev` — init does not push."}, {"action": "hosting.site.build_status", "params": {"job_id": "<from post-receive after push>"}, "why": "Poll until completed; preview URL /s/{project_id}/{bucket_name}--dev/"}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_git_journal", "agentstack_hosting_workspace_build"], "related_tools": ["hosting.git.status", "hosting.site.build"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_git_init", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Init platform git on the protected source folder. Branches dev and main. Post-receive enqueues preview on push to dev and production on push to main — poll hosting.site.build_status; do not assume URL", "title": "Hosting Git Init", "when_blocked": {"batch_semantic_anchor_required": "Default async=true still needs a batch anchor: options.execution_intent=direct, options.goal, or preflight.check. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor.", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; agentstack_diagnose if enqueue or quick_start persists", "git_binary_missing": "Rebuild backend image (apt git); optional GIT_BINARY env", "git_failed:checkout": "Could not checkout dev or main — hosting.git.init refreshes the journal hooks", "git_failed:init": "hosting.git.init failed — check API image has git; then platform_shell_seed", "git_push_body_too_large": "Push pack exceeded API body cap or nginx limit — never commit node_modules/dist; sources only; VPS runs site.build.yaml npm ci + vite", "git_symlink_failed": "Smart HTTP git requires Linux VPS _sources symlink layout", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen the key with apikeys.create preset user_full, or Device Code --scope-preset=full. Same denial on hosting.git.init, hosting.workspace.init, and hosting.site.build.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create platform git (branches dev and main) on the protected source tree. Push to remote branch dev (not master) for preview build — post-receive enqueues hosting.site.build. Poll hosting.site.build_s", "write_mode": null}, {"action": "hosting.git.status", "aliases": ["git.list_repos", "git.status"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.status", "related_tools": ["hosting.git.pull_upstream", "hosting.git.init", "hosting.git.log", "hosting.site.quick_start", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Status"}, "do_not_use_when": "Before hosting.git.init on the bucket — status requires a journal repo.", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Status by bucket name", "request": {"params": {"bucket_name": "studio", "project_id": 1600}, "tool": "hosting.git.status"}}], "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_GIT_PLANE_CHOOSER": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branches dev or main. (2) generation.promote moves 8DNA only (config, fleet, knowledge) — not site bytes. Pass env_uuid on the write params. Skip a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. (3) Platform checkouts agentstack-core and shared often have no git remote — they ship by VPS deploy. Empty origin means do not git push origin. agentstack-frontend tracks agentstack/dev. 'push to dev' is plane 1, not generation.promote and not target=prod.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.git.pull_upstream", "hosting.git.init", "hosting.git.log", "hosting.site.quick_start", "hosting.site.build"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_git_status", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Git status of the protected source tree.", "title": "Hosting Git Status", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "git_failed:status": "Journal git broken — hosting.git.init or platform_shell_seed then re-init", "git_push_body_too_large": "Push pack exceeded API body cap or nginx limit — never commit node_modules/dist; sources only; VPS runs site.build.yaml npm ci + vite", "git_repo_missing": "Existing bucket: hosting.git.init with bucket_name or bucket_id. hosting.site.quick_start only when hosting.project.status shows no site.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Before hosting.git.init on the bucket — status requires a journal repo.", "when_to_use": "Porcelain of the protected journal. Dirty tracked files block promote. Untracked docs are ignored. Next: hosting.git.log or push HEAD:dev / HEAD:main.", "write_mode": null}, {"action": "hosting.git.log", "aliases": ["git.log"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "hosting", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.log", "related_tools": ["hosting.git.status", "hosting.git.promote_branch", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Log"}, "do_not_use_when": "Player-facing patch notes after build — fetch /s/{pid}/{bucket}/changelog.json (preview: {bucket}--dev). Use hosting.git.log only for operator pagination and task_ids.", "domain_title": "Demo Hosting MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_GIT_PLANE_CHOOSER": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branches dev or main. (2) generation.promote moves 8DNA only (config, fleet, knowledge) — not site bytes. Pass env_uuid on the write params. Skip a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. (3) Platform checkouts agentstack-core and shared often have no git remote — they ship by VPS deploy. Empty origin means do not git push origin. agentstack-frontend tracks agentstack/dev. 'push to dev' is plane 1, not generation.promote and not target=prod.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Paginated journal history. Each entry includes task_ids parsed from AgentStack-Task / Task-Id / Wor…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": [{"action": "hosting.git.log", "params": {"bucket_name": "<from prior result>", "limit": 20, "project_id": "<context.project_id>", "ref": "dev"}, "why": "First page of journal; pass cursor=next_cursor from the result for older commits."}, {"action": "hosting.site.build", "params": {"bucket_name": "<from prior result>", "project_id": "<context.project_id>", "publish": true, "target": "dev"}, "why": "Regenerate public changelog.json/html after new commits land on dev or main."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.git.status", "hosting.git.promote_branch", "hosting.site.build"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "hosting_git_log", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Paginated git log (main|dev). Returns task_ids from AgentStack-Task trailers (Work Graph node id). Public changelog.json is the player feed.", "title": "Hosting Git Log", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "git_cursor_invalid": "cursor must be a hex commit SHA from prior next_cursor", "git_failed:log": "Could not read journal log — hosting.git.status then hosting.git.init", "git_ref_not_allowed": "Use ref main or dev only — public changelog uses the same refs", "git_repo_missing": "Journal not initialized: hosting.git.log returns ok:true with entries:[] (not a hard error). Run hosting.git.init before expecting history.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Player-facing patch notes after build — fetch /s/{pid}/{bucket}/changelog.json (preview: {bucket}--dev). Use hosting.git.log only for operator pagination and task_ids.", "when_to_use": "Paginated journal history. Each entry includes task_ids parsed from AgentStack-Task / Task-Id / Work-Graph trailers (Work Graph node ids). Players read /s/{pid}/{bucket}/changelog.json after hosting.s", "write_mode": null}, {"action": "hosting.git.pull_upstream", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.pull_upstream", "mutation_risk": "low", "related_tools": ["hosting.git.status", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Pull Upstream"}, "do_not_use_when": "Before hosting.git.init or when porcelain is dirty.", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_GIT_PLANE_CHOOSER": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branches dev or main. (2) generation.promote moves 8DNA only (config, fleet, knowledge) — not site bytes. Pass env_uuid on the write params. Skip a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. (3) Platform checkouts agentstack-core and shared often have no git remote — they ship by VPS deploy. Empty origin means do not git push origin. agentstack-frontend tracks agentstack/dev. 'push to dev' is plane 1, not generation.promote and not target=prod.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "Fast-forward an optional GitHub or GitLab upstream into platform git. Refuses a dirty tree. Does no…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": [{"action": "hosting.site.build", "params": {"bucket_name": "<from prior result>", "project_id": "<context.project_id>", "publish": true, "target": "dev"}, "why": "Rebuild preview after ff-only pull. Pass the same project_id and bucket_name."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Founder laptop + deploy SSH: platform_tooling.py vps fs (resolve/pull/put) hits the same host bind mount as workspace/ — hosting.workspace.meta returns operator_ssh_workspace_root; prefer MCP hosting.workspace.file.* when API session is available. Open the project site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. hosting.site.resolve uses the primary site when bucket_id is omitted. New /s/ bucket only when status has no site: hosting.site.quick_start with slug (returns public_path /s/{pid}/{slug}/; absolute URL = https://agentstack.tech + path). AI Builder is off — do not call ai_builder.build.enqueue, ai_builder.publish, or ai_builder.source.* to ship a game. Game ship: (1) hosting.project.status, keep that bucket_id. (2) Put code: git push agentstack HEAD:dev after hosting.git.init (remote https://agentstack.tech/api/git/{pid}/{bucket}.git), or hosting.workspace.file.put / patch_plane=workspace, or hosting.site.import_archive for a zip. (3) Build: the dev push enqueues it, or hosting.site.build target=dev; poll hosting.site.build_status until completed. Preview /s/{pid}/{bucket}--dev/. (4) Prod: git push agentstack HEAD:main or hosting.git.promote_branch bucket_id ref=dev target=prod. Live /s/{pid}/{bucket}/. That is not generation.promote (8DNA only). Prompt agentstack_hosting_git_journal. Sources in workspace/: hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace, then hosting.site.build. One live hotfix: hosting.bucket.file.patch (live). The write refreshes the .gz sibling. Many files: one hosting.deploy_files. Do not snapshot after every file. External dist ZIP or git repo: hosting.site.import_archive — static publishes; package.json sources return job_id → poll hosting.site.build_status before live publish. No window.API_KEY and no /agentstack-sdk.js in the page. Visitor sign-in is a form on the page: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. Do not call MCP auth.login for the visitor. On load the page calls /s/{project_id}/mcp (no trailing slash) with credentials. The cookie path is /s/{project_id}/, so reload does not POST /api/hosted-apps. A React-state bearer disappears on reload. Project config: projects.patch_data — never site HTML.", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.git.status", "hosting.site.build"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_git_pull_upstream", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Fast-forward optional upstream into platform git. Refuses a dirty tree. Token is not stored in the site leaf. Then build target=dev yourself.", "title": "Hosting Git Pull Upstream", "when_blocked": {"bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "git_binary_missing": "Rebuild backend image (apt git); optional GIT_BINARY env", "git_dirty": "Commit or reset the journal before pull_upstream or git_commit on a dirty tree", "git_failed:fetch": "Upstream fetch failed — hosting.git.status; fix remote URL or credentials", "git_failed:merge": "Merge onto dev failed — hosting.git.status. Dirty tree is git_dirty. hosting.git.promote_branch retries ff then a merge commit; pull_upstream stays ff-only.", "git_repo_missing": "Existing bucket: hosting.git.init with bucket_name or bucket_id. hosting.site.quick_start only when hosting.project.status shows no site.", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_not_to_use": "Before hosting.git.init or when porcelain is dirty.", "when_to_use": "Fast-forward an optional GitHub or GitLab upstream into platform git. Refuses a dirty tree. Does not promote production. The token is not stored in git config. Param branch defaults to dev and does no", "write_mode": null}, {"action": "hosting.git.promote_branch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.git.promote_branch", "mutation_risk": "low", "related_tools": ["hosting.git.status", "hosting.site.build_status", "hosting.site.build"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Hosting Git Promote Branch"}, "do_not_use_when": "8DNA config/fleet/knowledge — generation.promote. hosting.release.promote — snapshot rollback, not journal ship. Platform agentstack-core or shared with an empty origin — VPS deploy, not this action. Default preview is git push agentstack HEAD:dev; target=prod is the live site.", "domain_title": "Demo Hosting MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"name": "Publish tested dev to prod", "request": {"params": {"bucket_name": "frontend", "project_id": 1, "ref": "dev", "target": "prod"}, "tool": "hosting.git.promote_branch"}}, {"name": "Feature branch onto dev preview", "request": {"params": {"bucket_name": "frontend", "project_id": 1, "ref": "feature/my-branch", "target": "dev"}, "tool": "hosting.git.promote_branch"}}], "execution_class": "cheap", "genetic_tags": ["core.hosting.bucket.gen1"], "growth": [{"action": "auth.get_profile", "id": "operator", "recipe_id": "mcp_session_setup", "skip_when": "Session user_id is already set.", "tip": "auth.get_profile, then context.project_id on every batch. Skip auth.login when the session already has user_id.", "when": "First call in a project."}, {"action": "apikeys.create", "id": "scoped_key", "recipe_id": "", "skip_when": "Bearer session, or the key already lists the caps you need.", "tip": "apikeys.create with service_caps hosting, storage, and projects. An interactive Bearer session skips this step.", "when": "The API key has service_caps=null."}, {"action": "hosting.deploy_files", "id": "site", "recipe_id": "mcp_hosting_static_landing_v1", "skip_when": "You only need to read hosting.project.status.", "tip": "If hosting.project.status has primary_public_url, edit that bucket. Do not quick_start a second site. Many files: one hosting.deploy_files. One text file: mcp_hosting_edit_text_file_v1. No window.API_KEY and no /agentstack-sdk.js in the HTML.", "when": "Publish or refresh HTML on /s/{project_id}/{slug}/."}, {"action": "auth.register", "id": "visitor_auth", "recipe_id": "", "skip_when": "The page is public and does not identify visitors.", "tip": "The operator MCP session is already authorized. Do not call MCP auth.login for visitors and do not paste the operator Bearer into the page. The page has an email and password form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session with that bearer. On the HTML page use the project SDK import map. The page then calls /s/{project_id}/mcp with credentials. On load, call that URL again. Do not POST /api/hosted-apps to resume. A bearer kept only in React state disappears on reload. clearSession only when the call status is 401. A 403 or a data error leaves the session and the last snapshot. HTTP 200 with unauthorized on POST /s/{project_id}/mcp means the hosted cookie was absent.", "when": "People who open the site should sign in."}, {"action": "storage.get_quota", "id": "files", "recipe_id": "", "skip_when": "The only bytes are the hosted site.", "tip": "storage.get_quota, then REST POST /api/storage/upload. quota_mode is member, project, or both. Site HTML stays on hosting.* at /s/{project_id}/{slug}/.", "when": "User uploads that are not the site HTML."}, {"action": "projects.patch_data", "id": "project_data", "recipe_id": "mcp_project_data_safe_patch", "skip_when": "You are not changing project config.", "tip": "projects.get_data, then projects.patch_data with a leaf path and write_mode (auto_generation_mode auto-forks sandbox — do not call generation.fork to fill lists). generation.diff_vs_prod, generation.gates, generation.promote — each its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Do not write a full data blob.", "when": "Shared project config."}, {"action": "projects.patch_my_data", "id": "member_data", "recipe_id": "", "skip_when": "The value is shared project config, not one member.", "tip": "projects.get_my_data and projects.patch_my_data (path + value, write_mode merge or replace). Same leaf as PATCH /api/projects/{id}/users/me/data.", "when": "Private state for the signed-in member."}, {"action": "ai_builder.compose.apply", "id": "app", "recipe_id": "mcp_app_studio_create_v1", "skip_when": "The page is static HTML with no React build.", "tip": "Phases: mcp_app_studio_create_v1, edit, build, publish. mcp_app_studio_v1 does not run. Read view=skeleton, then one body with view=symbol. Replace that function with symbols:[{name, replace}], or one replacements find/replace. Pass expected_sha256 from the read. A mismatch writes nothing. Do not patch assets/index-*.js. The page imports @agentstack/sdk from /sdk/v{version}/commerce.esm.js. Operator scripts use sdk.platform and getCapabilityMatrix(). OpenAPI is the contract, not a second client. Tools with no required_cap run on the hosted cookie. Curated reads use cap hosted_shell_read (OR on allowlist in hosted_shell_read.py). scheduler.list_tasks needs cap scheduler and generation.list needs mcp_read; both return service_cap_denied. Do not add mcp_read to that cookie. Publish blocks window.API_KEY, /agentstack-sdk.js, and the stub Your app is being generated. Do not copy the operator Bearer into the page.", "when": "Build a React app and publish it onto the site."}, {"action": "logic.dry_run", "id": "later", "recipe_id": "", "skip_when": "The static site is the whole product.", "tip": "logic.create then logic.dry_run. Balances: payments.get_balance. Catalog: assets.list_presets, then assets.create. Do not replace data.assets.items[]. The app calls assets.list. Wallets hold the balance. CRM: mcp_crm_contact_deal. Docs: mcp_knowledge_ingest. Bots: mcp_bots_simulate.", "when": "The site needs rules, money, CRM, knowledge, or a bot."}], "hosting_atoms": {"HOSTED_MCP_COOKIE": "Hosted /s/{pid}/mcp: session cookie aud=hosted_app with credentials:include — not operator MCP Bearer. POST /api/hosted-apps/{pid}/session mints the cookie. Keep nginx session affinity on this path when StackScript hosted defer is on (process-local neural pending); `script.run` coop may expose timings.neural_defer and dna_persisted=false until PG flush — see stackscript instruction plane_chooser.", "HOSTING_BATCH_SEMANTIC_ANCHOR": "Sync hosting mutations need a batch anchor: options.execution_intent=direct, options.goal, or preflight.check in the same execute. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor. Poll hosting.site.build_status in a separate execute — one job_id per poll loop; honor poll_backoff_ms; stop when status is completed|failed|cancelled or on job_not_found (re-list via hosting.project.status then hosting.site.build).", "HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_GIT_PLANE_CHOOSER": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branches dev or main. (2) generation.promote moves 8DNA only (config, fleet, knowledge) — not site bytes. Pass env_uuid on the write params. Skip a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. (3) Platform checkouts agentstack-core and shared often have no git remote — they ship by VPS deploy. Empty origin means do not git push origin. agentstack-frontend tracks agentstack/dev. 'push to dev' is plane 1, not generation.promote and not target=prod.", "MCP_OPERATOR_SESSION": "Operator MCP plane: X-API-Key or Bearer (Device Code OAuth). Bind context.project_id after auth.get_profile — not the hosted /s/ cookie."}, "instruction_hint": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstac…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "owner_gene": "core.hosting.bucket.gen1", "plane": "Site: hosting.project.status. If primary_public_url is set, edit that bucket — do not quick_start a second site. One text file: hosting.bucket.file.patch. The write refreshes the .gz sibling. Do not delete it. Many files: hosting.deploy_files. No window.API_KEY. Visitor form: POST /api/auth/login, then POST /api/hosted-apps/{project_id}/session, then /s/{project_id}/mcp with credentials. Do not search_replace assets/index-*.js. Edit src, then build and publish.", "plane_chooser": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branc…", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_showcase_vps_ops", "agentstack_text_editor", "agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site"], "related_tools": ["hosting.git.status", "hosting.site.build_status", "hosting.site.build"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "hosting_git_promote_branch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "ship_ladder": "hosting.project.status → hosting.workspace.init profile=node_vite (avoid seed_from_live when live is dist-only) → hosting.workspace.file.put or hosting.bucket.file.patch patch_plane=workspace → hosting.git.init (bucket_name) → local git push agentstack HEAD:dev (remote agentstack, not origin/main) → poll hosting.site.build_status → open /s/{project_id}/{bucket_name}--dev/ → hosting.git.promote_branch ref=dev target=prod → live /s/{project_id}/{bucket_name}/. Not generation.promote, ai_builder.publish, or hosting.release.promote.", "summary": "Land any journal branch on dev (preview) or fast-forward main for production. target=dev merges ref onto refs/heads/dev and enqueues the preview build. target=prod requires the ref already on dev, fas", "title": "Hosting Git Promote Branch", "when_blocked": {"batch_semantic_anchor_required": "Default async=true still needs a batch anchor: options.execution_intent=direct, options.goal, or preflight.check. CLI: mcp-execute.mjs --execution-intent direct. async=false does not skip the anchor.", "bucket_id_or_bucket_name_required": "hosting.project.status — use primary_site_bucket_id or bucket_name; in a batch, pass bucket_id from the prior step result (refs) or primary_site_bucket_id; omit bucket_id only when primary or exactly one site exists; hosting.site.quick_start only when zero sites", "bucket_not_found": "hosting.project.status — verify bucket_id/bucket_name; DNA/index drift — not quick_start if sites exist", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "first_prod": "When refs/heads/main is still the lone init commit, use hosting.git.promote_branch ref=dev target=prod — not git push dev:main (unrelated histories).", "git_argv_rejected": "Server git allowlist blocked a prod worktree step (often reset --hard HEAD after ensure_prod_worktree). Check system.version build_id/git_sha — stale image if fix missing. Until RebuildBackend ships hosting_git_sync reset allowlist: (1) hosting.site.build target=dev publish=true async=true, poll build_status; (2) hosting.release.list; (3) hosting.release.promote with release_uuid only (omit bucket_id on nano site ids); (4) hosting.site.edge_health. Do not loop promote_branch target=prod on the same error.", "git_binary_missing": "Rebuild backend image (apt git); optional GIT_BINARY env", "git_dirty": "Commit or reset the journal before pull_upstream or git_commit on a dirty tree", "git_failed:checkout": "Could not checkout dev or main — hosting.git.init refreshes the journal hooks", "git_failed:merge": "Merge onto dev failed — hosting.git.status. Dirty tree is git_dirty. hosting.git.promote_branch retries ff then a merge commit; pull_upstream stays ff-only.", "git_not_ff": "main is not a fast-forward of this ref. Push the prod commit onto main, or merge main into dev first. promote_branch does not rewind main.", "git_push_body_too_large": "Push pack exceeded API body cap or nginx limit — never commit node_modules/dist; sources only; VPS runs site.build.yaml npm ci + vite", "git_ref_missing": "Ref is not on this journal — git push the branch first, then hosting.git.promote_branch", "git_ref_not_on_dev": "target=prod requires the ref already on dev. hosting.git.promote_branch target=dev first, open /s/{project_id}/{bucket}--dev/, then target=prod ref=dev. That fast-forwards main. A direct git push to main also builds production.", "git_repo_missing": "Existing bucket: hosting.git.init with bucket_name or bucket_id. hosting.site.quick_start only when hosting.project.status shows no site.", "git_worktree_update_failed": "quick_start left untracked index.html — hosting.git.init scrubs stubs and sets receive.denyCurrentBranch=ignore; push dev again", "insufficient_permissions": "Project read or hosting operator required — auth.get_profile then rbac.check_permission", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen the key with apikeys.create preset user_full, or Device Code --scope-preset=full. Same denial on hosting.git.init, hosting.workspace.init, and hosting.site.build.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unrelated_main_init": "Git client rejected dev:main — server main placeholder is not an ancestor of dev. Use hosting.git.promote_branch ref=dev target=prod, then poll hosting.site.build_status.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch. hosting.site.quick_start: slug only — not bucket_name. hosting.git.status: pass bucket_name or site_id from quick_start / project.status. hosting.site.build.status: pass job_id from enqueue receipt — not bucket_name alone."}, "when_not_to_use": "8DNA config/fleet/knowledge — generation.promote. hosting.release.promote — snapshot rollback, not journal ship. Platform agentstack-core or shared with an empty origin — VPS deploy, not this action. Default preview is git push agentstack HEAD:dev; target=prod is the live site.", "when_to_use": "Hosting git only — not generation.promote (8DNA) and not a local origin push. Param is bucket_id, not bucket. Land any journal ref on dev, or fast-forward main for production. target=dev (default) mer", "write_mode": null}], "integrations": [{"action": "integrations.list_recipes", "aliases": ["discovery.list_recipes"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.list_recipes", "related_tools": ["integrations.connector_schema", "integrations.install_recipe", "integrations.list_connections"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Recipes"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "First step for any SaaS/API connect — filter provider/category/q, then integrations.connector_schem…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.connector_schema", "integrations.install_recipe", "integrations.list_connections"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_recipes", "semantic_input_mode": "inherit_workflow", "summary": "List integration recipe templates (Stripe, GitHub, Telegram, etc.).", "title": "List Integration Recipes", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "Filter params must be valid strings when provided", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "First step for any SaaS/API connect — filter provider/category/q, then integrations.connector_schema and integrations.install_recipe.", "write_mode": null}, {"action": "integrations.recipe_taxonomies", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.recipe_taxonomies", "related_tools": ["integrations.connector_schema", "integrations.install_recipe", "integrations.list_connections"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Recipe Taxonomies"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Facet lists for integration recipes (provider, category, tags). Use before integrations.list_recipe…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.connector_schema", "integrations.install_recipe", "integrations.list_connections"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_recipe_taxonomies", "semantic_input_mode": "inherit_workflow", "summary": "Facet lists for integration recipes (provider, category, tags). Use before integrations.list_recipes to build filters — same payload as GET /api/integrations/recipes/taxonomies.", "title": "Integrations Recipe Taxonomies", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Facet lists for integration recipes (provider, category, tags). Use before integrations.list_recipes to build filters — same payload as GET /api/integrations/recipes/taxonomies.", "write_mode": null}, {"action": "integrations.install_recipe", "aliases": ["webhooks.create_endpoint", "webhooks.register"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not store signing_secret or API tokens in projects.patch_data — use secrets= on install.", "Do not call webhooks.register — use Integration Hub recipes/connections.", "Retry with the same idempotency_key only when params unchanged; else use a new key."], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.install_recipe", "mutation_risk": "low", "related_tools": ["integrations.list_recipes", "integrations.connector_schema", "integrations.list_connections", "integrations.test_hook", "logic.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Integrations Install Recipe"}, "do_not_use_when": "A catalog recipe is missing — integrations.list_recipes first. Preview imports do not install.", "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"config": {}, "idempotency_key": "example_string", "label": "example_string", "owner_kind": "example_string", "project_id": 123, "recipe_id": "example_string", "secrets": {}, "slug": "example_string", "user_id": 123}, "example_request": {"action": "integrations.install_recipe", "params": {"config": {}, "idempotency_key": "example_string", "label": "example_string", "owner_kind": "example_string", "project_id": 123, "recipe_id": "example_string", "secrets": {}, "slug": "example_string", "user_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Install inbound/outbound recipe — replaces legacy webhooks.register. Secrets in secrets= only — nev…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_recipes", "integrations.connector_schema", "integrations.list_connections", "integrations.test_hook", "logic.create"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["generation.realign_to_prod"], "safe_action": "integrations_install_recipe", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Install a recipe: creates connection + declarative logic rule.", "title": "Integrations Install Recipe", "verification": ["integrations.list_connections", "integrations.connection_health"], "verify": [{"action": "integrations.list_connections", "predicate": "named resource is visible"}, {"action": "integrations.connection_health", "predicate": "named resource is visible"}], "when_blocked": {"connection_not_found": "integrations.list_connections — reinstall or create_connection", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "duplicate_request": "same idempotency_key only when params unchanged — else new key", "forbidden": "Permission denied — integrations:write or project_admin", "insufficient_permissions": "integrations:write cap + project_admin on tenant PID", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "recipe_not_found": "integrations.list_recipes (provider/q) → connector_schema before install", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "A catalog recipe is missing — integrations.list_recipes first. Preview imports do not install.", "when_to_use": "Install inbound/outbound recipe — replaces legacy webhooks.register. Secrets in secrets= only — never projects.patch_data.", "write_mode": null}, {"action": "integrations.list_connections", "aliases": ["webhooks.get", "webhooks.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.list_connections", "related_tools": ["integrations.get_connection", "integrations.connection_health", "integrations.oauth_begin"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Integrations List Connections"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"owner_kind": "example_string", "project_id": 123, "provider": "example_string", "user_id": 123}, "example_request": {"action": "integrations.list_connections", "params": {"owner_kind": "example_string", "project_id": 123, "provider": "example_string", "user_id": 123}}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List connectors for a tenant project_id — not ecosystem PID 1. Bind context.project_id via auth.get…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.get_connection", "integrations.connection_health", "integrations.oauth_begin"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_connections", "semantic_input_mode": "inherit_workflow", "summary": "List integration connections for project or personal scope. Each row is id plus spec.provider, spec.label, and spec.status. webhook_activation, routing, and logic_id are null here. The nested card_row", "title": "Integrations List Connections", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "rbac.check_permission on tenant project — integrations:read or project membership", "invalid_parameters": "Tenant connectors: bind context.project_id to a workspace PID (> ecosystem). Ecosystem project_id=1: pass owner_kind=personal + user_id for operator-linked hooks (inbound /api/hooks/ecosystem/users/{user_id}/...). auth.get_profile or projects.get_projects — not OAuth default PID 1 for tenant app hooks.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List connectors for a tenant project_id — not ecosystem PID 1. Bind context.project_id via auth.get_profile or projects.get_projects.", "write_mode": null}, {"action": "integrations.get_connection", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_connection", "related_tools": ["integrations.list_connections", "integrations.delete_connection"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get Connection"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Load connector config after integrations.list_connections.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_connections", "integrations.delete_connection"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_get_connection", "semantic_input_mode": "inherit_workflow", "summary": "Get integration connection metadata (secrets redacted).", "title": "Integrations Get Connection", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load connector config after integrations.list_connections.", "write_mode": null}, {"action": "integrations.delete_connection", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.delete_connection", "mutation_risk": "high", "related_tools": ["integrations.get_connection", "integrations.list_connections"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Delete Connection"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Rollback after certification or remove stale connectors.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.get_connection", "integrations.list_connections"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "integrations_delete_connection", "semantic_input_mode": "inherit_workflow", "summary": "Delete an integration connection and unregister webhook bindings.", "title": "Integrations Delete Connection", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "insufficient_permissions": "project_admin + integrations:write", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rollback after certification or remove stale connectors.", "write_mode": null}, {"action": "integrations.create_connection", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Prefer install_recipe when a catalog recipe exists — less schema drift.", "Inbound/bidirectional requires signing material unless allow_unsigned_dev_only (dev only)."], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.create_connection", "mutation_risk": "low", "related_tools": ["integrations.install_recipe", "integrations.list_connections", "integrations.connector_schema"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Create Connection"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"config": {}, "direction": "example_string", "generation": 123, "idempotency_key": "example_string", "label": "example_string", "owner_kind": "example_string", "project_id": 123, "provider": "example_string", "secrets": {}, "slug": "example_string", "user_id": 123}, "example_request": {"action": "integrations.create_connection", "params": {"config": {}, "direction": "example_string", "generation": 123, "idempotency_key": "example_string", "label": "example_string", "owner_kind": "example_string", "project_id": 123, "provider": "example_string", "secrets": {}, "slug": "example_string", "user_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Low-level connector birth when no recipe covers the provider. Prefer integrations.install_recipe wh…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.install_recipe", "integrations.list_connections", "integrations.connector_schema"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["integrations.delete_connection"], "safe_action": "integrations_create_connection", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create an integration connection (REST POST /api/integrations/connections parity). Prefer integrations.install_recipe for packaged inbound webhooks.", "title": "Integrations Create Connection", "verification": ["integrations.list_connections"], "verify": [{"action": "integrations.list_connections", "predicate": "named resource is visible"}], "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "duplicate_request": "list_connections — reuse connection_id or new idempotency_key", "forbidden": "Permission denied — integrations:write or project_admin", "insufficient_permissions": "integrations:write + signing material for inbound", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_not_found": "list_recipes or list_apps — use catalog provider id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Low-level connector birth when no recipe covers the provider. Prefer integrations.install_recipe when a catalog recipe exists. Recipe mcp_tenant_business_assistant_v1 uses Telegram token + bots.attach", "write_mode": null}, {"action": "integrations.test_hook", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not treat success=false as transport failure — read error_code (hook_verify_failed, hook_no_rule_match).", "Include provider signature headers in headers= when testing Stripe/Svix connectors."], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.test_hook", "related_tools": ["integrations.install_recipe", "integrations.connector_schema", "integrations.list_connections", "logic.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Integrations Test Hook"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "effect_depends_on_params": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "example_params": {"body_json": {}, "headers": {}, "owner_kind": "example_string", "project_id": 123, "provider": "example_string", "slug": "example_string", "user_id": 123}, "example_request": {"action": "integrations.test_hook", "params": {"body_json": {}, "headers": {}, "owner_kind": "example_string", "project_id": 123, "provider": "example_string", "slug": "example_string", "user_id": 123}}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Dry-run provider signature + payload mapping before go-live — read error_code, not only success=fal…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.install_recipe", "integrations.connector_schema", "integrations.list_connections", "logic.dry_run"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_test_hook", "semantic_input_mode": "inherit_workflow", "summary": "Dry-run inbound hook verify + normalize (sync dispatch to logic).", "title": "Integrations Test Hook", "when_blocked": {"connection_not_found": "integrations.list_connections — install_recipe first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "hook_no_rule_match": "logic.dry_run on installed rule_id — fix FieldMap transforms", "hook_verify_failed": "connector_schema for headers; Telegram needs X-Telegram-Bot-Api-Secret-Token matching connection webhook_secret — after deploy run integrations.activate_webhook or platform_telegram_doctor (401 detail.code webhook_secret_missing | webhook_signature_mismatch)", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_not_found": "list_recipes / list_apps — exact provider id from catalog row", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run provider signature + payload mapping before go-live — read error_code, not only success=false (hook_verify_failed, hook_no_rule_match).", "write_mode": null}, {"action": "integrations.export_connection", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.export_connection", "related_tools": ["integrations.list_connections", "integrations.get_connection", "integrations.import_connection"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Export Connection"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Backup or audit one connector — public spec + config; signing_secret redacted. Pair with integratio…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_connections", "integrations.get_connection", "integrations.import_connection"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_export_connection", "semantic_input_mode": "inherit_workflow", "summary": "Export connection public spec + config (secrets redacted).", "title": "Integrations Export Connection", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "mcp_read on tenant project or ecosystem operator scope", "invalid_parameters": "connection_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Backup or audit one connector — public spec + config; signing_secret redacted. Pair with integrations.import_connection on target project (secrets= optional).", "write_mode": null}, {"action": "integrations.import_connection", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.import_connection", "mutation_risk": "low", "related_tools": ["integrations.export_connection", "integrations.list_connections", "integrations.install_recipe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import Connection"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Restore connector from export_connection JSON — project_admin; use secrets= when rotating into a ne…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.export_connection", "integrations.list_connections", "integrations.install_recipe"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_import_connection", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Import connection from export JSON (optionally with secrets).", "title": "Integrations Import Connection", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project_admin on target project_id", "invalid_parameters": "project_id and connection object required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Restore connector from export_connection JSON — project_admin; use secrets= when rotating into a new workspace without re-OAuth.", "write_mode": null}, {"action": "integrations.rotate_secret", "aliases": ["webhooks.rotate_secret"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.rotate_secret", "mutation_risk": "low", "related_tools": ["integrations.get_connection", "integrations.list_connections", "integrations.test_hook"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Integrations Rotate Secret"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "example_params": {"connection_id": "example_string", "key": "example_string", "value": "example_string"}, "example_request": {"action": "integrations.rotate_secret", "params": {"connection_id": "example_string", "key": "example_string", "value": "example_string"}}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Rotate signing secret atomically for a connection.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.get_connection", "integrations.list_connections", "integrations.test_hook"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "integrations_rotate_secret", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Rotate a protected secret key for a connection.", "title": "Integrations Rotate Secret", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "insufficient_permissions": "project_admin — protected secret rotation", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rotate signing secret atomically for a connection.", "write_mode": null}, {"action": "integrations.replay_delivery", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.replay_delivery", "related_tools": ["integrations.list_issues", "integrations.list_connections"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Integrations Replay Delivery"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"delivery_id": "example_string", "owner_kind": "example_string", "project_id": 123, "user_id": 123}, "example_request": {"action": "integrations.replay_delivery", "params": {"delivery_id": "example_string", "owner_kind": "example_string", "project_id": 123, "user_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Re-send one failed outbound delivery by delivery_id after integrations.list_issues.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_issues", "integrations.list_connections"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_replay_delivery", "semantic_input_mode": "inherit_workflow", "summary": "Replay outbound delivery by durable delivery_id (execution log).", "title": "Integrations Replay Delivery", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "delivery_not_found": "integrations.list_issues — copy delivery_id from failed row", "forbidden": "mcp_read on tenant project", "invalid_parameters": "project_id and delivery_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_target_url": "integrations.list_issues — row lacks target_url; fix connection", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Re-send one failed outbound delivery by delivery_id after integrations.list_issues.", "write_mode": null}, {"action": "integrations.replay_delivery_url", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.replay_delivery_url", "related_tools": ["integrations.list_issues", "integrations.test_hook"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Replay Delivery Url"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Debug one outbound target_url (ops) — same as REST deliveries/replay; not batch replay.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_issues", "integrations.test_hook"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_replay_delivery_url", "semantic_input_mode": "inherit_workflow", "summary": "Replay outbound POST to an explicit target_url (same as REST deliveries/replay query).", "title": "Integrations Replay Delivery Url", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "mcp_read on tenant project", "invalid_parameters": "project_id and target_url required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Debug one outbound target_url (ops) — same as REST deliveries/replay; not batch replay.", "write_mode": null}, {"action": "integrations.connection_health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.connection_health", "related_tools": ["integrations.list_connections", "integrations.get_connection", "integrations.test_hook"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Connection Health"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "After install_recipe — verify connector snapshot before test_hook go-live.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_connections", "integrations.get_connection", "integrations.test_hook"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_connection_health", "semantic_input_mode": "inherit_workflow", "summary": "Read connection health snapshot (public spec only).", "title": "Integrations Connection Health", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "needs_auth": "integrations.oauth_begin then refresh_token — reconnect OAuth", "oauth_credentials_missing": "BYO secrets missing — Quick Setup client_id/secret then install", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "x_credits_depleted": "Top up X API credits / check developer console", "x_rate_limited": "Backoff; honor Retry-After; retry with same idempotency_key"}, "when_to_use": "After install_recipe — verify connector snapshot before test_hook go-live.", "write_mode": null}, {"action": "integrations.connector_schema", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.connector_schema", "related_tools": ["integrations.list_recipes", "integrations.install_recipe", "integrations.create_connection"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Connector Schema"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Provider setup schema before install_recipe or create_connection — copy secrets= keys from setup_st…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_recipes", "integrations.install_recipe", "integrations.create_connection"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_connector_schema", "semantic_input_mode": "inherit_workflow", "summary": "Provider setup schema (required secrets, setup_steps, quick_setup) — call before install_recipe or create_connection so agents know which secrets= keys to pass.", "title": "Read Connector Schema", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "provider string required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "provider_not_found": "integrations.list_recipes — exact provider id from catalog row", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Provider setup schema before install_recipe or create_connection — copy secrets= keys from setup_steps.", "write_mode": null}, {"action": "integrations.process_inbox_batch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.process_inbox_batch", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Process Inbox Batch"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Process durable inbound integration inbox (worker-style batch).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_process_inbox_batch", "semantic_input_mode": "inherit_workflow", "summary": "Process durable inbound integration inbox (worker-style batch).", "title": "Integrations Process Inbox Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Process durable inbound integration inbox (worker-style batch).", "write_mode": null}, {"action": "integrations.process_outbound_batch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.process_outbound_batch", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Process Outbound Batch"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Process outbound webhook delivery work queue (webhooks.outbound batch).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_process_outbound_batch", "semantic_input_mode": "inherit_workflow", "summary": "Process outbound webhook delivery work queue (webhooks.outbound batch).", "title": "Integrations Process Outbound Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Process outbound webhook delivery work queue (webhooks.outbound batch).", "write_mode": null}, {"action": "integrations.process_polling_batch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.process_polling_batch", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Process Polling Batch"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Worker sweep for due poll connectors — ops diagnose, not connect ladder step 1.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_process_polling_batch", "semantic_input_mode": "inherit_workflow", "summary": "Poll due integration connections (config.poll_enabled, cursor watermark).", "title": "Integrations Process Polling Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Worker sweep for due poll connectors — ops diagnose, not connect ladder step 1.", "write_mode": null}, {"action": "integrations.hydrate_triggers", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": true, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.hydrate_triggers", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Hydrate Triggers"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": true, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Rebuild trigger registry from connection DNA before rebind_triggers when rules are missing.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_hydrate_triggers", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Hydrate integration trigger registry from connection DNA (cold start recovery).", "title": "Integrations Hydrate Triggers", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rebuild trigger registry from connection DNA before rebind_triggers when rules are missing.", "write_mode": null}, {"action": "integrations.rebind_triggers", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": true, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.rebind_triggers", "related_tools": ["integrations.hydrate_triggers", "integrations.list_connections", "logic.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Rebind Triggers"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": true, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Re-sync enabled logic rule triggers for a project or all connection projects.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.hydrate_triggers", "integrations.list_connections", "logic.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_rebind_triggers", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Re-sync enabled logic rule triggers for a project or all connection projects.", "title": "Integrations Rebind Triggers", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id must be a positive int when provided", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Re-sync enabled logic rule triggers for a project or all connection projects.", "write_mode": null}, {"action": "integrations.list_inbox_events", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.list_inbox_events", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Inbox Events"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Audit inbound intake after test_hook — inspect queued rows before integrations.replay_inbox.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_inbox_events", "semantic_input_mode": "inherit_workflow", "summary": "List durable integration inbox audit rows for a project.", "title": "Integrations List Inbox Events", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit inbound intake after test_hook — inspect queued rows before integrations.replay_inbox.", "write_mode": null}, {"action": "integrations.replay_inbox", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.replay_inbox", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Replay Inbox"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Re-drive one inbox audit row when the provider delivered but logic did not run.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_replay_inbox", "semantic_input_mode": "inherit_workflow", "summary": "Replay a durable inbox event through the test-hook intake path.", "title": "Integrations Replay Inbox", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Re-drive one inbox audit row when the provider delivered but logic did not run.", "write_mode": null}, {"action": "integrations.export_scenario", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.export_scenario", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Export Scenario"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Export portable scenario bundle (rule document + field maps, secrets redacted).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_export_scenario", "semantic_input_mode": "inherit_workflow", "summary": "Export portable scenario bundle (rule document + field maps, secrets redacted).", "title": "Integrations Export Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export portable scenario bundle (rule document + field maps, secrets redacted).", "write_mode": null}, {"action": "integrations.preview_scenario_maps", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.preview_scenario_maps", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Preview Scenario Maps"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Evaluate scenario field maps against a sample payload (secrets redacted).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_preview_scenario_maps", "semantic_input_mode": "inherit_workflow", "summary": "Evaluate scenario field maps against a sample payload (secrets redacted).", "title": "Integrations Preview Scenario Maps", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Evaluate scenario field maps against a sample payload (secrets redacted).", "write_mode": null}, {"action": "integrations.generate_signing_secret", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.generate_signing_secret", "mutation_risk": "low", "related_tools": ["integrations.list_connections", "integrations.rotate_secret", "integrations.test_hook"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Generate Signing Secret"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Rotate webhook signing_secret server-side when old value is unknown — prefer over integrations.rota…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_connections", "integrations.rotate_secret", "integrations.test_hook"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_generate_signing_secret", "semantic_input_mode": "inherit_workflow", "summary": "Rotate signing_secret server-side without reading the old value.", "title": "Integrations Generate Signing Secret", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project_admin on connection project", "invalid_parameters": "connection_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rotate webhook signing_secret server-side when old value is unknown — prefer over integrations.rotate_secret when key name is signing_secret.", "write_mode": null}, {"action": "integrations.export_connection_manifest", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.export_connection_manifest", "related_tools": ["integrations.list_connections", "integrations.export_connection"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Export Connection Manifest"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Compact manifest for agent tool loops — ids/providers only; use export_connection for full spec per…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_connections", "integrations.export_connection"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_export_connection_manifest", "semantic_input_mode": "inherit_workflow", "summary": "Export project integration connections as JSON manifest for agent tool loops.", "title": "Integrations Export Connection Manifest", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "mcp_read on tenant project", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compact manifest for agent tool loops — ids/providers only; use export_connection for full spec per connector.", "write_mode": null}, {"action": "integrations.import_zapier_preview", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.import_zapier_preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import Zapier Preview"}, "do_not_use_when": "Applying the import. Preview does not install or run.", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "read_only_hint": true, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Dry-run preview: map Zapier export JSON to recipe + logic block draft.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_import_zapier_preview", "semantic_input_mode": "inherit_workflow", "summary": "Dry-run preview: map Zapier export JSON to recipe + logic block draft.", "title": "Integrations Import Zapier Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Applying the import. Preview does not install or run.", "when_to_use": "Dry-run preview: map Zapier export JSON to recipe + logic block draft.", "write_mode": null}, {"action": "integrations.import_zapier_commit", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.import_zapier_commit", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import Zapier Commit"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Commit Zapier export JSON → installed connection + logic (not dry-run).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "integrations:write", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_import_zapier_commit", "semantic_input_mode": "inherit_workflow", "summary": "Commit Zapier export JSON → installed connection + logic (not dry-run).", "title": "Integrations Import Zapier Commit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Commit Zapier export JSON → installed connection + logic (not dry-run).", "write_mode": null}, {"action": "integrations.import_make_commit", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.import_make_commit", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import Make Commit"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Commit Make scenario JSON → installed connection + logic (not dry-run).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "integrations:write", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_import_make_commit", "semantic_input_mode": "inherit_workflow", "summary": "Commit Make scenario JSON → installed connection + logic (not dry-run).", "title": "Integrations Import Make Commit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Commit Make scenario JSON → installed connection + logic (not dry-run).", "write_mode": null}, {"action": "integrations.import_make_preview", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.import_make_preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import Make Preview"}, "do_not_use_when": "Applying the import. Preview does not install or run.", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "read_only_hint": true, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Dry-run preview: map Make scenario JSON to recipe + logic block draft.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_import_make_preview", "semantic_input_mode": "inherit_workflow", "summary": "Dry-run preview: map Make scenario JSON to recipe + logic block draft.", "title": "Integrations Import Make Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Applying the import. Preview does not install or run.", "when_to_use": "Dry-run preview: map Make scenario JSON to recipe + logic block draft.", "write_mode": null}, {"action": "integrations.list_issues", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.list_issues", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Issues"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Cluster failed outbound deliveries before integrations.replay_delivery.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_issues", "semantic_input_mode": "inherit_workflow", "summary": "Cluster failed outbound deliveries into issues (Hookdeck-style).", "title": "Integrations List Issues", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cluster failed outbound deliveries before integrations.replay_delivery.", "write_mode": null}, {"action": "integrations.get_diagnostics", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.get_diagnostics", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get Diagnostics"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Roll up Integration Hub worker health for a tenant project_id when hooks look stuck.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_get_diagnostics", "semantic_input_mode": "inherit_workflow", "summary": "Integration Hub diagnostics rollup and worker flags.", "title": "Integrations Get Diagnostics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Roll up Integration Hub worker health for a tenant project_id when hooks look stuck.", "write_mode": null}, {"action": "integrations.get_platform_diagnostics", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_platform_diagnostics", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get Platform Diagnostics"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Cross-tenant Integration Hub rollup (platform admin ops).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_get_platform_diagnostics", "semantic_input_mode": "inherit_workflow", "summary": "Cross-tenant Integration Hub rollup (platform admin ops).", "title": "Integrations Get Platform Diagnostics", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cross-tenant Integration Hub rollup (platform admin ops).", "write_mode": null}, {"action": "integrations.get_hubspot_relay_stats", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_hubspot_relay_stats", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get Hubspot Relay Stats"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "HubSpot platform relay rollup (7d success/denied/no-connection/missing portal).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_get_hubspot_relay_stats", "semantic_input_mode": "inherit_workflow", "summary": "HubSpot platform relay rollup (7d success/denied/no-connection/missing portal).", "title": "Integrations Get Hubspot Relay Stats", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "HubSpot platform relay rollup (7d success/denied/no-connection/missing portal).", "write_mode": null}, {"action": "integrations.migrate_legacy_webhooks", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.migrate_legacy_webhooks", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Migrate Legacy Webhooks"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Copy projects.config.webhooks into integration_connection rows.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_migrate_legacy_webhooks", "semantic_input_mode": "inherit_workflow", "summary": "Copy projects.config.webhooks into integration_connection rows.", "title": "Integrations Migrate Legacy Webhooks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Copy projects.config.webhooks into integration_connection rows.", "write_mode": null}, {"action": "integrations.poll_connection", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.poll_connection", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Poll Connection"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Poll one poll_enabled connector — use scheduler + process_polling_batch for cadence.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_poll_connection", "semantic_input_mode": "inherit_workflow", "summary": "Run connector polling for a connection (cursor watermark in config.poll_state).", "title": "Integrations Poll Connection", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll one poll_enabled connector — use scheduler + process_polling_batch for cadence.", "write_mode": null}, {"action": "integrations.oauth_begin", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Callback URI must include /oauth/{provider}/callback/{project_id} — copy from Quick Setup.", "Provider id is x — not twitter.", "Secrets only via install_recipe secrets= or rotate — never projects.patch_data."], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.oauth_begin", "related_tools": ["integrations.list_connections", "integrations.list_recipes", "integrations.refresh_token", "integrations.connection_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Oauth Begin"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "OAuth 2.0 PKCE — returns authorization_url after install_recipe or create_connection. User complete…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_connections", "integrations.list_recipes", "integrations.refresh_token", "integrations.connection_health"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_oauth_begin", "semantic_input_mode": "inherit_workflow", "summary": "Start OAuth 2.0 PKCE flow for an integration connection (returns authorization_url).", "title": "Integrations Oauth Begin", "when_blocked": {"connection_not_found": "install_recipe or create_connection before oauth_begin", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "rbac.check_permission — integrations:read on tenant project", "input_required": "provider and connection_id required — integrations.list_connections", "invalid_parameters": "provider/connection_id strings required; request_base optional", "invalid_state": "Restart OAuth from hub — stale browser tab or CSRF state.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "oauth_credentials_missing": "Paste client_id/client_secret in Quick Setup, install, then oauth_begin", "project_mismatch": "Register callback URI with same project_id as workspace.", "provider_mismatch": "Reconnect using the connection's provider row (e.g. x not twitter).", "provider_not_found": "list_recipes — OAuth provider must exist in catalog", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "OAuth 2.0 PKCE — returns authorization_url after install_recipe or create_connection. User completes browser flow; then integrations.refresh_token / connection_health.", "write_mode": null}, {"action": "integrations.refresh_token", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.refresh_token", "related_tools": ["integrations.oauth_begin", "integrations.connection_health", "integrations.list_connections"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Refresh Token"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "After oauth_begin and the browser flow — refresh an expired OAuth token before outbound calls.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.oauth_begin", "integrations.connection_health", "integrations.list_connections"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_refresh_token", "semantic_input_mode": "inherit_workflow", "summary": "Refresh OAuth access token for a connection when expired (protected storage).", "title": "Integrations Refresh Token", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "connection_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_refresh_token": "integrations.oauth_begin — offline.access consent", "needs_auth": "oauth_begin then refresh_token", "no_access_token": "Token exchange succeeded but access_token empty", "refresh_failed": "Retry; then oauth_begin if HTTP persists", "refresh_no_token": "integrations.oauth_begin — reconnect OAuth", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "token_exchange_failed": "Token endpoint HTTP error during refresh", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After oauth_begin and the browser flow — refresh an expired OAuth token before outbound calls.", "write_mode": null}, {"action": "integrations.diagnose_telegram", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.diagnose_telegram", "related_tools": ["integrations.activate_webhook", "integrations.connection_health", "integrations.rotate_secret"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Diagnose Telegram"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Telegram webhook triage before integrations.activate_webhook — token, secret, public URL, getWebhoo…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.activate_webhook", "integrations.connection_health", "integrations.rotate_secret"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_diagnose_telegram", "semantic_input_mode": "inherit_workflow", "summary": "Read-only Telegram connection health: token, webhook_secret, public URL, getWebhookInfo.", "title": "Integrations Diagnose Telegram", "when_blocked": {"connection_not_found": "integrations.list_connections — verify connection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Permission denied — integrations:write or project_admin", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_a_telegram_connection": "Provider must be telegram", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Telegram webhook triage before integrations.activate_webhook — token, secret, public URL, getWebhookInfo alignment. Read-only; no setWebhook.", "write_mode": null}, {"action": "integrations.activate_webhook", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.activate_webhook", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Activate Webhook"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Hub-level setWebhook when OAuth/manual retry needs it. Prefer bots.go_live activate_webhook=true fo…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_activate_webhook", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Register provider inbound webhook for a connection (post-OAuth or manual retry). Telegram: sets BotFather webhook URL to this connection's hook slug.", "title": "Integrations Activate Webhook", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hub-level setWebhook when OAuth/manual retry needs it. Prefer bots.go_live activate_webhook=true for fleet bots (mentor gate + lifecycle). Dual-token migration: bots.pause legacy primary first.", "write_mode": null}, {"action": "integrations.update_connection", "aliases": ["webhooks.delete"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.update_connection", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Update Connection"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Patch label, status, direction, or poll config — never secrets (use rotate_secret).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_update_connection", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch integration connection metadata (label, status, config, direction).", "title": "Integrations Update Connection", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch label, status, direction, or poll config — never secrets (use rotate_secret).", "write_mode": null}, {"action": "integrations.list_scenarios", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_scenarios", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Scenarios"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List integration scenarios for a project scope.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_scenarios", "semantic_input_mode": "inherit_workflow", "summary": "List integration scenarios for a project scope.", "title": "Integrations List Scenarios", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List integration scenarios for a project scope.", "write_mode": null}, {"action": "integrations.get_scenario", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_scenario", "related_tools": ["integrations.list_scenarios", "integrations.save_scenario_draft"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get Scenario"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Get integration scenario detail (draft + publish metadata).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_scenarios", "integrations.save_scenario_draft"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_get_scenario", "semantic_input_mode": "inherit_workflow", "summary": "Get integration scenario detail (draft + publish metadata).", "title": "Integrations Get Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get integration scenario detail (draft + publish metadata).", "write_mode": null}, {"action": "integrations.reveal_secrets", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.reveal_secrets", "related_tools": ["integrations.get_connection", "integrations.rotate_secret"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Reveal Secrets"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Reveal connection secrets for operators (audit-logged; high privilege).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.get_connection", "integrations.rotate_secret"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_reveal_secrets", "semantic_input_mode": "inherit_workflow", "summary": "Reveal connection secrets for operators (audit-logged; high privilege).", "title": "Integrations Reveal Secrets", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reveal connection secrets for operators (audit-logged; high privilege).", "write_mode": null}, {"action": "integrations.create_scenario", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.create_scenario", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Create Scenario"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Draft multi-step outbound HTTP when catalog recipes are too narrow — pair with logic.create.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_create_scenario", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a draft integration scenario with backing logic rule.", "title": "Integrations Create Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Draft multi-step outbound HTTP when catalog recipes are too narrow — pair with logic.create.", "write_mode": null}, {"action": "integrations.save_scenario_draft", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": true, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.save_scenario_draft", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Save Scenario Draft"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": true, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Save scenario draft (spec and/or logic patch). Parity with REST POST /scenarios/{id}/draft.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_save_scenario_draft", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Save scenario draft (spec and/or logic patch). Parity with REST POST /scenarios/{id}/draft.", "title": "Integrations Save Scenario Draft", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Save scenario draft (spec and/or logic patch). Parity with REST POST /scenarios/{id}/draft.", "write_mode": null}, {"action": "integrations.unpublish_scenario", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.unpublish_scenario", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Unpublish Scenario"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Unpublish scenario (pause) and disable backing logic. Parity with REST unpublish.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "production_publish", "safe_action": "integrations_unpublish_scenario", "semantic_input_mode": "inherit_workflow", "summary": "Unpublish scenario (pause) and disable backing logic. Parity with REST unpublish.", "title": "Integrations Unpublish Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Unpublish scenario (pause) and disable backing logic. Parity with REST unpublish.", "write_mode": null}, {"action": "integrations.publish_scenario", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.publish_scenario", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Publish Scenario"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Go live on a draft scenario only after integrations.test_scenario_step passes.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "production_publish", "safe_action": "integrations_publish_scenario", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Publish scenario (live) and enable backing logic.", "title": "Integrations Publish Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scenario_not_found": "integrations.list_scenarios — create_scenario or import preview first", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "verification_failed": "integrations.test_scenario_step before publish"}, "when_to_use": "Go live on a draft scenario only after integrations.test_scenario_step passes.", "write_mode": null}, {"action": "integrations.test_scenario_step", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.test_scenario_step", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Test Scenario Step"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Dry-run one scenario step before publish_scenario.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_test_scenario_step", "semantic_input_mode": "inherit_workflow", "summary": "Dry-run a scenario step via logic simulation.", "title": "Integrations Test Scenario Step", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dry-run one scenario step before publish_scenario.", "write_mode": null}, {"action": "integrations.list_scenario_runs", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_scenario_runs", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Scenario Runs"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List recorded test/run history for a scenario.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_scenario_runs", "semantic_input_mode": "inherit_workflow", "summary": "List recorded test/run history for a scenario.", "title": "Integrations List Scenario Runs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List recorded test/run history for a scenario.", "write_mode": null}, {"action": "integrations.list_apps", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_apps", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Apps"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List integration app catalog entries (connectors + recipe metadata).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_apps", "semantic_input_mode": "inherit_workflow", "summary": "List integration app catalog entries (connectors + recipe metadata).", "title": "Integrations List Apps", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List integration app catalog entries (connectors + recipe metadata).", "write_mode": null}, {"action": "integrations.get_app", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_app", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Get App"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Get a single integration app definition by provider id.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_get_app", "semantic_input_mode": "inherit_workflow", "summary": "Get a single integration app definition by provider id.", "title": "Integrations Get App", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get a single integration app definition by provider id.", "write_mode": null}, {"action": "integrations.list_app_triggers", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_app_triggers", "related_tools": ["integrations.get_app", "integrations.list_app_actions"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List App Triggers"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List trigger definitions for an integration app provider.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.get_app", "integrations.list_app_actions"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_app_triggers", "semantic_input_mode": "inherit_workflow", "summary": "List trigger definitions for an integration app provider.", "title": "Integrations List App Triggers", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List trigger definitions for an integration app provider.", "write_mode": null}, {"action": "integrations.list_app_actions", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_app_actions", "related_tools": ["integrations.get_app", "integrations.list_app_triggers"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List App Actions"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List action definitions for an integration app provider.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.get_app", "integrations.list_app_triggers"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_app_actions", "semantic_input_mode": "inherit_workflow", "summary": "List action definitions for an integration app provider.", "title": "Integrations List App Actions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List action definitions for an integration app provider.", "write_mode": null}, {"action": "integrations.dynamic_fields", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.dynamic_fields", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Dynamic Fields"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List dynamic field sources for an integration app (schema-only in Phase 1).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_dynamic_fields", "semantic_input_mode": "inherit_workflow", "summary": "List dynamic field sources for an integration app (schema-only in Phase 1).", "title": "Integrations Dynamic Fields", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List dynamic field sources for an integration app (schema-only in Phase 1).", "write_mode": null}, {"action": "integrations.list_dlq_deliveries", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_dlq_deliveries", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Dlq Deliveries"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List integration outbound deliveries in DLQ or terminal failure state.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_dlq_deliveries", "semantic_input_mode": "inherit_workflow", "summary": "List integration outbound deliveries in DLQ or terminal failure state.", "title": "Integrations List Dlq Deliveries", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List integration outbound deliveries in DLQ or terminal failure state.", "write_mode": null}, {"action": "integrations.generate_scenario", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.generate_scenario", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Generate Scenario"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Keyword-only RuleDocumentV1 draft (no LLM). Server sets preview_only=true. Continue with integratio…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_generate_scenario", "semantic_input_mode": "inherit_workflow", "summary": "Keyword-only RuleDocumentV1 draft (no LLM). Server sets preview_only=true. Continue with integrations.save_scenario_draft then logic.dry_run before publish.", "title": "Integrations Generate Scenario", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Keyword-only RuleDocumentV1 draft (no LLM). Server sets preview_only=true. Continue with integrations.save_scenario_draft then logic.dry_run before publish.", "write_mode": null}, {"action": "integrations.import_n8n_preview", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.import_n8n_preview", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import N8N Preview"}, "do_not_use_when": "Applying the import. Preview does not install or run.", "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "read_only_hint": true, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Map known nodes (webhook, set, manual, schedule, if). parameters and edges are copied. stub is true…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_import_n8n_preview", "semantic_input_mode": "inherit_workflow", "summary": "Preview n8n workflow JSON as AgentStack steps. Does not install or run it.", "title": "Integrations Import N8N Preview", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Applying the import. Preview does not install or run.", "when_to_use": "Map known nodes (webhook, set, manual, schedule, if). parameters and edges are copied. stub is true when a node has no action. This preview does not install or run the workflow.", "write_mode": null}, {"action": "integrations.import_n8n_commit", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.import_n8n_commit", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Import N8N Commit"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Commit n8n workflow JSON → installed connection + logic (not dry-run).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "integrations:write", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_import_n8n_commit", "semantic_input_mode": "inherit_workflow", "summary": "Commit n8n workflow JSON → installed connection + logic (not dry-run).", "title": "Integrations Import N8N Commit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Commit n8n workflow JSON → installed connection + logic (not dry-run).", "write_mode": null}, {"action": "integrations.list_modules", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_modules", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Modules"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List reusable sub-scenario module stubs.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_modules", "semantic_input_mode": "inherit_workflow", "summary": "List reusable sub-scenario module stubs.", "title": "Integrations List Modules", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List reusable sub-scenario module stubs.", "write_mode": null}, {"action": "integrations.register_module", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.register_module", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Register Module"}, "domain_title": "Integrations MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Register a reusable sub-scenario module stub on a parent connection.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "integrations_register_module", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Register a reusable sub-scenario module stub on a parent connection.", "title": "Integrations Register Module", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Register a reusable sub-scenario module stub on a parent connection.", "write_mode": null}, {"action": "integrations.list_module_registrations", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_module_registrations", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations List Module Registrations"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List module registrations persisted on connection DNA rows.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_list_module_registrations", "semantic_input_mode": "inherit_workflow", "summary": "List module registrations persisted on connection DNA rows.", "title": "Integrations List Module Registrations", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List module registrations persisted on connection DNA rows.", "write_mode": null}, {"action": "integrations.mailbox", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not put the message body or the OAuth token in logs or in a second chat sender.", "anti_patterns": ["Do not put the message body or the OAuth token in logs or in a second chat sender.", "Do not call op=send to reply to corporate mail; that path is the outbound queue.", "Do not request gmail.modify."], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.oauth.gen1"], "id": "integrations.mailbox", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Mailbox"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "The user connected Gmail or Microsoft Mail and wants those letters listed, read, or answered. For @…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "integrations_mailbox", "semantic_input_mode": "inherit_workflow", "summary": "Read or send mail on a connected Gmail or Microsoft mailbox. op is list, get, or send. Tokens stay on the connection. list returns id, subject, from, snippet (max 10). get returns plain text whole unt", "title": "Integrations Mailbox", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "The user connected Gmail or Microsoft Mail and wants those letters listed, read, or answered. For @agentstack.tech use the corporate mailbox. For chat delivery use notifications.update_prefs {category", "write_mode": null}, {"action": "integrations.social_post", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not call without connection_id from list_connections after recipe_x_publish + oauth_begin.", "Do not blind-retry x_duplicate_content; change text or accept failure.", "Do not use build_outbound/http_fetch when integrations.social_post exists.", "Do not omit idempotency_key on live create/thread/delete."], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1", "core.integrations.oauth.gen1"], "id": "integrations.social_post", "mutation_risk": "high", "related_tools": ["integrations.oauth_begin", "integrations.refresh_token", "integrations.list_connections", "agents.approve_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Integrations Social Post"}, "domain_title": "Integrations MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Connected X (provider=x): op=create|thread|delete|draft_upsert|cancel. Prefer dry_run then same ide…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "owner_gene": "core.integrations.hub.gen1", "plane": "Connect: integrations.list_recipes, then connector_schema, then install_recipe or create_connection, then test_hook. OAuth: integrations.oauth_begin. integrations.import_n8n_preview copies node parameters and edges. It does not install or run.", "plane_chooser": "External APIs and SaaS: integrations.list_recipes (filter provider/category/q) → integrations.connector_schema(provider) for required secrets/fields → integrations.install_recipe (packaged) OR integrations.create_connection (custom inbound). OAuth providers: integrations.oauth_begin → user completes browser flow → integrations.refresh_token. Verify: integrations.test_hook (dry-run signature + logic match) → integrations.connection_health. Automate reactions: logic.create / logic.dry_run — Hub installs rules; do not run a second webhook server. Outbound HTTP to arbitrary APIs: logic blocks + integrations scenarios (integrations.create_scenario) or recipe modules. Import Zapier/Make/n8n: integrations.import_*_preview copies node parameters and edges, then commit via REST/UI. The preview does not install. Ops: integrations.list_inbox_events, integrations.list_issues, integrations.get_diagnostics. Caps: integrations:read|write|execute. Secrets only in install secrets= / protected — never projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.oauth_begin", "integrations.refresh_token", "integrations.list_connections", "agents.approve_run"], "required_cap": "mcp_write", "requires_preflight": true, "risk_class": "read", "safe_action": "integrations_social_post", "semantic_input_mode": "inherit_workflow", "summary": "Publish, thread, delete, or draft on a connected X account (provider=x). OAuth connection required. Prefer over raw http_fetch. Not for user alerts (notifications.deliver) or TG chat (bots.staff_reply", "title": "Integrations Social Post", "when_blocked": {"connection_not_found": "integrations.list_connections — install recipe_x_publish first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "draft_id_required": "op=cancel requires draft_id from draft_upsert", "forbidden": "Permission denied — integrations:write or project_admin", "idempotency_conflict": "Wait and replay; completed claim returns same tweet_id", "idempotency_key_required": "Pass stable idempotency_key on live create/thread/delete (dry_run may omit)", "idempotency_unavailable": "Idempotency store unavailable — retry with same key; do not assume dedupe", "invalid_op": "op must be create|thread|delete|draft_upsert|cancel", "invalid_parameters": "Required parameters missing or malformed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "needs_auth": "integrations.oauth_begin then refresh_token — reconnect X", "oauth_credentials_missing": "Store client_id/client_secret on connection secrets, then oauth_begin", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "provider_error": "X API error — read status in response; fix text/credits/auth", "provider_mismatch": "Connection provider must be x — integrations.list_connections", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "thread_parts_required": "op=thread needs parts[] with ≥2 strings (or text+parts)", "unsupported_channel": "provider must be x (not twitter alias)", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "x_credits_depleted": "Top up X API credits / check developer console", "x_duplicate_content": "Change text or accept failure — do not blind retry", "x_rate_limited": "Backoff; honor Retry-After; retry with same idempotency_key"}, "when_to_use": "Connected X (provider=x): op=create|thread|delete|draft_upsert|cancel. Prefer dry_run then same idempotency_key on live create/thread/delete. Not notifications.deliver, bots.staff_reply, or AgentSocia", "write_mode": null}], "knowledge": [{"action": "knowledge.config.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.config.get", "related_tools": ["knowledge.config.patch", "knowledge.prompt.get", "knowledge.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Config Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Prod config", "request": {"params": {"project_id": 1}, "tool": "knowledge.config.get"}, "response": {"data": {"config": {}, "safety_playbooks": []}, "success": true}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts."}, "instruction_hint": "Read knowledge config before patch or playground. When shape.mode is not leaf, config is null and o…", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT", "KNOWLEDGE_CONFIG_PATCH_VS_PATCH_DATA", "KNOWLEDGE_TENANT_EDIT_LADDER", "GENERATION_SAFE_CYCLE_LADDER"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.config.patch", "knowledge.prompt.get", "knowledge.health"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_config_get", "semantic_input_mode": "inherit_workflow", "summary": "GET knowledge config — RAG lanes, entitlements, default_playground_bot_uuid, ingest policy.", "title": "Knowledge Config Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read knowledge config before patch or playground. When shape.mode is not leaf, config is null and outline is names only. Do not patch that outline back. Fat configs (Unity gene_pack): pass detail=full", "write_mode": null}, {"action": "knowledge.prompt.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.prompt.get", "related_tools": ["knowledge.prompt.patch", "knowledge.playground", "knowledge.kb.ingest"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Prompt Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Default grounded prompt", "request": {"params": {"project_id": 1}, "tool": "knowledge.prompt.get"}, "response": {"data": {"prompt": {}}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Load Plan instructions before prompt.patch. Check plan_instructions_chars before replace.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.prompt.patch", "knowledge.playground", "knowledge.kb.ingest"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_prompt_get", "semantic_input_mode": "inherit_workflow", "summary": "Grounded assistant preamble + plan_instructions (same as GET /knowledge/prompt). Both strings come back whole. A field over the compact envelope is a preview, not the field to patch. system_preamble_c", "title": "Knowledge Prompt Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load Plan instructions before prompt.patch. Check plan_instructions_chars before replace.", "write_mode": null}, {"action": "knowledge.prompt.patch", "ai_tips": "GET first and check plan_instructions_chars. Sending a short stub as plan_instructions used to wipe a 7k-char plan. write_mode=append adds a bullet. write_mode=search_replace plus replacements edits the stored field without pasting it. Stub replace → prompt_shrink_blocked unless allow_shrink=true. See GET /mcp/actions write_modes and prompt agentstack_write_modes.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Sending a 7-line plan_instructions as a patch — omit-unset is keys only; the sent string replaces the whole field.", "anti_patterns": ["Sending a 7-line plan_instructions as a patch — omit-unset is keys only; the sent string replaces the whole field.", "Skipping knowledge.prompt.get and inventing a shorter plan.", "Using write_mode=merge on prompt fields (unsupported; use append or get+replace)."], "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.prompt.patch", "mutation_risk": "low", "related_tools": ["knowledge.prompt.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Prompt Patch"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Edit one sentence with search_replace (field=plan_instructions). Append a bullet, or replace the wh…", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "body", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.prompt.get"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_prompt_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch grounded assistant system_preamble and/or plan_instructions (same as PATCH /knowledge/prompt). omit-unset keeps unsent keys; a sent field is the full string. Writes prompt_settings leaf via patc", "title": "Knowledge Prompt Patch", "when_blocked": {"ambiguous_anchor": "Multiple find matches — set count or use a longer unique find", "assistant_agent_not_found": "knowledge.prompt.get — bind a grounded assistant first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "Re-read the prompt field; retry unified_diff or search_replace", "patch_too_large": "Shorten unified_diff or edit a smaller field window", "prompt_patch_required": "Pass system_preamble, plan_instructions, version, or replacements", "prompt_shrink_blocked": "search_replace on field=plan_instructions|system_preamble", "replacement_not_found": "GET prompt — substring not in that field", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "Unknown write_mode — see BODY_WRITE_MODE_ENUM", "write_mode_unsupported": "Prompt fields: append|search_replace|replace — not merge"}, "when_to_use": "Edit one sentence with search_replace (field=plan_instructions). Append a bullet, or replace the whole field after prompt.get.", "write_mode": ["replace", "write", "append", "prepend", "search_replace", "unified_diff"], "write_mode_note": "omit-unset keeps unsent keys only. A sent plan_instructions / system_preamble replaces that entire string. GET first; write_mode=append for a new bullet; search_replace edits field without a full paste; stub replace → prompt_shrink_blocked."}, {"action": "knowledge.access.grant", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "entitlement", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.access.grant", "related_tools": ["knowledge.access.list", "knowledge.access.revoke", "knowledge.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Access Grant"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Grant product/tier access to a principal user (entitlement row).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.access.list", "knowledge.access.revoke", "knowledge.health"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_access_grant", "semantic_input_mode": "inherit_workflow", "summary": "Grant product/tier access to a principal user (entitlement row).", "title": "Knowledge Access Grant", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "principal_user_id_and_product_id_required": "principal_user_id and product_id required — knowledge.access.list for rows", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Grant product/tier access to a principal user (entitlement row).", "write_mode": null}, {"action": "knowledge.access.revoke", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "entitlement", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.access.revoke", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Access Revoke"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Revoke a principal product grant after refund or role change.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": true, "risk_class": "destructive", "safe_action": "knowledge_access_revoke", "semantic_input_mode": "inherit_workflow", "summary": "Revoke a principal product grant after refund or role change.", "title": "Knowledge Access Revoke", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "grant_not_found": "knowledge.access.list — no row for principal_user_id + product_id", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke a principal product grant after refund or role change.", "write_mode": null}, {"action": "knowledge.access.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "entitlement", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.access.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Access List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List access grants before grant/revoke or entitlement QA.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_access_list", "semantic_input_mode": "inherit_workflow", "summary": "List access grants before grant/revoke or entitlement QA.", "title": "Knowledge Access List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List access grants before grant/revoke or entitlement QA.", "write_mode": null}, {"action": "knowledge.kb.ingest", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "mutates_when": {"validate_only": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.kb.ingest", "mutates_when": {"validate_only": false}, "related_tools": ["rag.document_add_batch", "rag.ingest_job_status", "rag.search", "knowledge.playground", "knowledge.eval.run", "knowledge.export"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Knowledge Kb Ingest"}, "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "validate_only=true validates paths and queue policy without enqueue; default queues ingest job (mutate)", "effect_depends_on_params": true, "execution_class": "cheap", "generation": true, "kind": "mutate", "mutates_when": {"validate_only": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"collection": "example_string", "collection_id": "example_string", "dedupe": true, "documents": [], "enqueue": true, "ingest_run_id": "example_string", "project_id": 123, "text": "example_string", "title": "example_string", "user_id": 123, "validate_only": false}, "example_request": {"action": "knowledge.kb.ingest", "params": {"collection": "example_string", "collection_id": "example_string", "dedupe": true, "documents": [], "enqueue": true, "ingest_run_id": "example_string", "project_id": 123, "text": "example_string", "title": "example_string", "user_id": 123, "validate_only": false}}, "examples": [{"name": "Async ingest one doc", "request": {"params": {"documents": [{"content": "Hello", "metadata": {"title": "demo"}}], "project_id": 1}, "tool": "knowledge.kb.ingest"}, "response": {"data": {"job_ids": [], "queued": true}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Ingest KB document into project knowledge index.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "next_actions": ["knowledge.health"], "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["rag.document_add_batch", "rag.ingest_job_status", "rag.search", "knowledge.playground", "knowledge.eval.run", "knowledge.export"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "rollback": ["generation.realign_to_prod"], "safe_action": "knowledge_kb_ingest", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Ingest documents into a KB collection (async by default). Failures attach instruction_slice and recovery_hint in the request locale.", "title": "Knowledge Kb Ingest", "verification": ["knowledge.health", "knowledge.config.get"], "verify": [{"action": "knowledge.health", "predicate": "named resource is visible"}, {"action": "knowledge.config.get", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "entitlement_blocked": "RAG tier/collection limit — knowledge.health or buffs.get_effective_limits", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "ingest_shed": "Queue shed — retry later or enqueue=false for sync ingest", "invalid_parameters": "documents[] shape or project_id invalid — discovery.describe", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "knowledge_entitlement_denied": "Check buffs / tier before bulk ingest", "knowledge_ingest_failed": "See data.errors[] for per-document failure rows", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ingest KB document into project knowledge index.", "write_mode": null}, {"action": "knowledge.kb.heal_index", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.kb.heal_index", "related_tools": ["knowledge.health", "knowledge.kb.ingest", "knowledge.content.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Kb Heal Index"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Fix rag_index_sha256_mismatch without wiping collection.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.health", "knowledge.kb.ingest", "knowledge.content.list"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_kb_heal_index", "semantic_input_mode": "inherit_workflow", "summary": "Realign DNA storage_ref.sha256 to on-disk sqlite for a KB collection (no wipe). Fixes rag_index_sha256_mismatch. Default collection_id=content_registry.", "title": "Knowledge Kb Heal Index", "when_blocked": {"collection_not_found": "knowledge.health — verify collection_id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rag_index_sha256_mismatch": "This action realigns index; retry heal_index after ingest", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fix rag_index_sha256_mismatch without wiping collection.", "write_mode": null}, {"action": "knowledge.export", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.export", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Export"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Export knowledge config + KB snapshot for backup. A fat bundle returns shape.mode outline and no bo…", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_export", "semantic_input_mode": "inherit_workflow", "summary": "Export knowledge config + KB snapshot for backup. A fat bundle returns shape.mode outline and no bodies. detail=full raises the ceiling.", "title": "Knowledge Export", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export knowledge config + KB snapshot for backup. A fat bundle returns shape.mode outline and no bodies. detail=full raises the ceiling.", "write_mode": null}, {"action": "knowledge.eval.run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.eval.run", "related_tools": ["knowledge.eval.run_all", "knowledge.eval.retrieval", "knowledge.doctor.run", "generation.gates", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Eval Run"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "instruction_hint": "Run single eval case against knowledge config.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.eval.run_all", "knowledge.eval.retrieval", "knowledge.doctor.run", "generation.gates", "generation.promote"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_eval_run", "semantic_input_mode": "inherit_workflow", "summary": "Golden safety eval cases against live KnowledgeConfig.", "title": "Knowledge Eval Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eval_failed": "data.eval_passed false — not transport success; read cases[]", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before eval", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run single eval case against knowledge config.", "write_mode": null}, {"action": "knowledge.eval.retrieval", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.eval.retrieval", "related_tools": ["mentor.eval.retrieval", "knowledge.eval.run_all", "knowledge.health", "knowledge.kb.ingest"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Eval Retrieval"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "instruction_hint": "Retrieval fixture eval — parity with mentor.eval.retrieval and REST POST /eval/retrieval.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["mentor.eval.retrieval", "knowledge.eval.run_all", "knowledge.health", "knowledge.kb.ingest"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_eval_retrieval", "semantic_input_mode": "inherit_workflow", "summary": "Retrieval fixture eval — parity with mentor.eval.retrieval and REST POST /eval/retrieval.", "title": "Knowledge Eval Retrieval", "when_blocked": {"collection_id_required": "Pass collection_id from knowledge.health", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "corpus_empty": "knowledge.kb.ingest + heal_index; data.corpus_empty on empty store", "eval_failed": "data.eval_passed false — ingest KB then knowledge.doctor.run", "feature_not_available": "knowledge.doctor.run — collections entitlement before eval", "fixture_missing": "Alias of fixture_required — resolved path empty or unreadable", "fixture_required": "Pass fixture or fixture_path (not retrieval_smoke_v1 for canonical_310826)", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Retrieval fixture eval — parity with mentor.eval.retrieval and REST POST /eval/retrieval.", "write_mode": null}, {"action": "knowledge.config.patch", "ai_tips": "safety_playbooks_write_mode: patch (default) overlays one playbook; replace wipes to the sent dict only; merge fills empty template fields only. Use knowledge.policy_templates.apply for catalog overlays. context_lanes sets faq|consult|coding|design|architecture collections and a preamble. coding/design/architecture default to project_code, project_design, project_architecture. context_limits (prompt_tail_chars, lane_preamble_chars, builder_snippet_chars, resource_text_chars, lane_collection_cap) is the size SoT — patch it instead of assuming a fixed cap. Ingest design CSS/HTML with knowledge.kb.ingest content_type css|html|style|code. After patch, use config_stats (response=stats or default compact echo). One g", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "PATCHing knowledge.config.get outline when config is null.", "anti_patterns": ["PATCHing knowledge.config.get outline when config is null.", "Full gene_pack fixture via config.patch when knowledge.phenotype.upsert fits.", "Bundling gene_pack + product_id_map in one sync execute on large tenants."], "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.config.patch", "mutation_risk": "low", "related_tools": ["knowledge.config.get", "knowledge.phenotype.upsert", "knowledge.gene_pack.pinned_shape.upsert", "knowledge.kb.ingest", "knowledge.content.patch", "knowledge.prompt.patch"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Knowledge Config Patch"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"config": {}, "detail": "example_string", "patch": {}, "response": "example_string"}, "example_request": {"action": "knowledge.config.patch", "params": {"config": {}, "detail": "example_string", "patch": {}, "response": "example_string"}}, "execution_class": "cheap", "generation_atoms": {"GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts."}, "instruction_hint": "Patch one knowledge config key — prefer leaf paths over full blob. One heavy key per sync execute: …", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT", "KNOWLEDGE_CONFIG_PATCH_VS_PATCH_DATA", "KNOWLEDGE_TENANT_EDIT_LADDER", "GENERATION_SAFE_CYCLE_LADDER"], "mutation_kind": "body", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.config.get", "knowledge.phenotype.upsert", "knowledge.gene_pack.pinned_shape.upsert", "knowledge.kb.ingest", "knowledge.content.patch", "knowledge.prompt.patch"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "rollback": ["generation.realign_to_prod"], "safe_action": "knowledge_config_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch knowledge DNA config + safety playbooks (same as PATCH /knowledge/config). gene_pack merges by name; safety_playbooks default write_mode is patch (per-playbook overlay — other playbook ids are k", "title": "Knowledge Config Patch", "verification": ["knowledge.config.get", "knowledge.health"], "verify": [{"action": "knowledge.config.get", "predicate": "named resource is visible"}, {"action": "knowledge.health", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before config patch", "generation_fork_required": "auto_generation_mode on — omit env_uuid for auto-fork on patch or pass sandbox anchor; then generation.diff_vs_prod → generation.gates → generation.promote", "invalid_parameters": "discovery.describe; bind context.project_id; use env_uuid in generation sandbox", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_required": "Pass patch or config with at least one KnowledgeConfig field", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch one knowledge config key — prefer leaf paths over full blob. One heavy key per sync execute: full gene_pack OR product_id_map, not both.", "write_mode": null}, {"action": "knowledge.policy_templates.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.policy_templates.list", "related_tools": ["knowledge.policy_templates.apply", "knowledge.prompt.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Policy Templates List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Discover safety/policy templates before apply.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.policy_templates.apply", "knowledge.prompt.get"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_policy_templates_list", "semantic_input_mode": "inherit_workflow", "summary": "Platform policy templates (synthesis / crisis / situational needles / gate). Same catalog as GET /knowledge/policy-templates. Apply writes 8DNA via existing prompt+config PATCH — not a second bus.", "title": "Knowledge Policy Templates List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover safety/policy templates before apply.", "write_mode": null}, {"action": "knowledge.policy_templates.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.policy_templates.status", "related_tools": ["knowledge.policy_templates.list", "knowledge.policy_templates.apply", "knowledge.prompt.get", "knowledge.config.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Policy Templates Status"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read which policy templates are active on project.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.policy_templates.list", "knowledge.policy_templates.apply", "knowledge.prompt.get", "knowledge.config.get"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_policy_templates_status", "semantic_input_mode": "inherit_workflow", "summary": "Read-only policy snapshot: synthesis [policy:id] markers in plan_instructions, playbook ids, gate mode, situational needle count. Same as GET /knowledge/policy-templates/status.", "title": "Knowledge Policy Templates Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.health — confirm project scope before status read", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read which policy templates are active on project.", "write_mode": null}, {"action": "knowledge.policy_templates.apply", "ai_tips": "Default slots = all slots on the template. Re-apply is a no-op (skipped). Do not put program track names in Core — templates are generic; Unity stays in tenant Plan. knowledge.prompt.patch omit-unset is still keys-only.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Inventing a second policy service or full-blob DNA write.", "anti_patterns": ["Inventing a second policy service or full-blob DNA write.", "Sending Unity program nouns as a new Core template."], "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.policy_templates.apply", "mutation_risk": "low", "related_tools": ["knowledge.policy_templates.list", "knowledge.config.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Policy Templates Apply"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Apply curated policy template slots to project config.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "body", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.policy_templates.list", "knowledge.config.patch"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_policy_templates_apply", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Apply a platform policy template onto the tenant: plan_instructions append (marker [policy:id]), merge crisis match_any (keep tenant template), union gene_pack.situational_needles, optional safety_fai", "title": "Knowledge Policy Templates Apply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before policy apply", "invalid_parameters": "discovery.describe; bind context.project_id; pass template_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "slots_empty": "Omit slots or pick synthesis|crisis|situational|gate from list row", "template_id_required": "Pass template_id from knowledge.policy_templates.list", "unknown_template": "knowledge.policy_templates.list — use a catalog template_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply curated policy template slots to project config.", "write_mode": null}, {"action": "knowledge.journal.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.journal.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Journal List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Audit mentor turn journal — support escalations and replay triage.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_journal_list", "semantic_input_mode": "inherit_workflow", "summary": "Mentor journal turns. Default 50, server max 200. No cursor.", "title": "Knowledge Journal List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier before journal reads", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit mentor turn journal — support escalations and replay triage.", "write_mode": null}, {"action": "knowledge.eval.run_all", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.eval.run_all", "related_tools": ["knowledge.eval.run", "knowledge.eval.retrieval", "knowledge.acceptance.run", "knowledge.health", "generation.gates", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Eval Run All"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "instruction_hint": "Run full platform eval harness (hit-rate gate before promote).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.eval.run", "knowledge.eval.retrieval", "knowledge.acceptance.run", "knowledge.health", "generation.gates", "generation.promote"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_eval_run_all", "semantic_input_mode": "inherit_workflow", "summary": "Full platform eval harness (safety + retrieval + readback).", "title": "Knowledge Eval Run All", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eval_failed": "data.eval_passed false — read harness sections; not transport success", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before run_all", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run full platform eval harness (hit-rate gate before promote).", "write_mode": null}, {"action": "knowledge.health", "aliases": ["knowledge.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.health", "related_tools": ["preflight.check", "knowledge.kb.ingest", "knowledge.config.get", "knowledge.config.patch", "generation.diff_vs_prod", "knowledge.eval.run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Health"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Preflight KB empty", "request": {"params": {"project_id": 1}, "tool": "knowledge.health"}, "response": {"data": {"kb_empty": true, "ready": false}, "success": true}}], "execution_class": "plain_read", "generation_atoms": {"GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts."}, "instruction_hint": "Knowledge plane health before ingest or playground.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT", "KNOWLEDGE_TENANT_EDIT_LADDER", "GENERATION_SAFE_CYCLE_LADDER"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["preflight.check", "knowledge.kb.ingest", "knowledge.config.get", "knowledge.config.patch", "generation.diff_vs_prod", "knowledge.eval.run"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_health", "semantic_input_mode": "inherit_workflow", "summary": "Knowledge plane health snapshot before ingest or playground. instruction_slice and recovery_hint use context.locale / instruction_locale.", "title": "Knowledge Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Knowledge plane health before ingest or playground.", "write_mode": null}, {"action": "knowledge.content.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.content.list", "related_tools": ["knowledge.content.get", "knowledge.kb.ingest", "discovery.describe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Content List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Default collection", "request": {"params": {"collection_id": "knowledge_kb", "project_id": 1}, "tool": "knowledge.content.list"}, "response": {"data": {"items": []}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Page operator KB documents. Each item's text is the joined body of this fetch, not a preview.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.content.get", "knowledge.kb.ingest", "discovery.describe"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_content_list", "semantic_input_mode": "inherit_workflow", "summary": "Page operator KB documents (default 50). Each item includes title, source_doc_id, chunk_count, and joined text from this fetch (at most 2000 chunks), not an unbounded document.", "title": "Knowledge Content List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Page operator KB documents. Each item's text is the joined body of this fetch, not a preview.", "write_mode": null}, {"action": "knowledge.content.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.content.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Content Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "The joined body comes back whole until 64000 characters. Pass offset only when truncated is true, b…", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_content_get", "semantic_input_mode": "inherit_workflow", "summary": "Get one KB document by source_doc_id. text is a character window only past the compact envelope (64000). Concatenate windows before a replace. One window is not the document. text_chars is the full jo", "title": "Knowledge Content Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "document_not_found": "knowledge.content.list — fix source_doc_id or collection_id", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_doc_id_required": "Pass source_doc_id from knowledge.content.list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "The joined body comes back whole until 64000 characters. Pass offset only when truncated is true, before content.patch replace.", "write_mode": null}, {"action": "knowledge.content.patch", "ai_tips": "A known substring: write_mode=search_replace and replacements [{find, replace}]. A hunk from a diff: write_mode=unified_diff and unified_diff (fuzzy if context drifts). Full replace: GET first. Truncated body → content_shrink_blocked; allow_shrink=true only when the shorter body is intentional. See GET /mcp/actions write_modes and prompt agentstack_write_modes.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Sending one H2 as text without write_mode=append — that used to wipe the rest of the card.", "anti_patterns": ["Sending one H2 as text without write_mode=append — that used to wipe the rest of the card.", "Skipping knowledge.content.get and inventing a shorter full body.", "Using write_mode=merge on markdown (unsupported; use append or get+replace)."], "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.content.patch", "mutation_risk": "low", "related_tools": ["knowledge.content.get", "knowledge.content.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Content Patch"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Change a known sentence with search_replace (no GET). Append a section, or replace the whole body a…", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT", "KNOWLEDGE_CONTENT_PATCH_DRY_RUN"], "mutation_kind": "body", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.content.get", "knowledge.content.list"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_content_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch a KB document: metadata (title, gene_stems, …) and/or body. Body write_mode is replace, append, prepend, search_replace, or unified_diff (fuzzy, same editor as App Studio source.patch). Same as ", "title": "Knowledge Content Patch", "when_blocked": {"ambiguous_anchor": "Multiple find matches — set count or use a longer unique find", "anchor_not_found": "knowledge.content.get — confirm find/where against joined text", "content_shrink_blocked": "Use search_replace or allow_shrink=true for a shorter body", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "document_not_found": "knowledge.content.list — fix source_doc_id", "empty_patch": "Pass patch.text or metadata fields", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "project_id, source_doc_id, or patch shape invalid", "invalid_patch": "Pass patch.text, replacements, unified_diff, or metadata fields", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "metadata_patch_failed": "Retry metadata-only fields or knowledge.kb.ingest; check RAG/index health", "patch_apply_failed": "Re-read body; retry unified_diff or strict_diff=true", "patch_too_large": "Shorter unified_diff or search_replace", "replacement_not_found": "GET content.get — find string not in joined document", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_doc_id_and_patch_required": "source_doc_id + patch object required", "text_anchor_miss": "Narrow find or GET body before unified_diff", "text_revision_conflict": "dry_run again or GET body — commit with previous_sha256 as expected_sha256", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "Use BODY_WRITE_MODE_ENUM values on write_mode param", "write_mode_unsupported": "Body text: append|prepend|search_replace|unified_diff|replace — not merge"}, "when_to_use": "Change a known sentence with search_replace (no GET). Append a section, or replace the whole body after content.get. Body commit with CAS: dry_run first (previous_sha256 + next_actions), then commit w", "write_mode": ["replace", "write", "append", "prepend", "search_replace", "unified_diff"], "write_mode_note": "text is a full body unless write_mode=append|prepend. GET the document first; shrinking a long body needs allow_shrink=true. SDK Studio sets allow_shrink for operator save — AI must GET first."}, {"action": "knowledge.chunk.patch", "ai_tips": "replacements [{find, replace}] on the assembled document — no GET when the phrase is known. Or pass text to replace only this chunk's segment (legacy replace).", "aliases": ["knowledge.chunk.text.patch", "knowledge.kb.chunk.patch"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Using chunk.patch when source_doc_id is known — content.patch is the document SoT.", "anti_patterns": ["Using chunk.patch when source_doc_id is known — content.patch is the document SoT.", "Sending a truncated chunk window as full text without allow_shrink."], "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.chunk.patch", "mutation_risk": "low", "related_tools": ["knowledge.content.get", "knowledge.content.patch", "knowledge.content.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Chunk Patch"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "You have a chunk doc_id from content.get chunks[] and need a phrase fix without source_doc_id routi…", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "body", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.content.get", "knowledge.content.patch", "knowledge.content.list"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_chunk_patch", "semantic_input_mode": "inherit_workflow", "summary": "Patch one indexed chunk by chunk doc_id; re-ingests the parent document. search_replace / unified_diff apply to the full joined body (same editor as content.patch). REST: PATCH /knowledge/kb/chunks/{d", "title": "Knowledge Chunk Patch", "when_blocked": {"ambiguous_anchor": "Multiple find matches — set count or use a longer unique find", "chunk_not_found": "knowledge.content.get — verify chunks[].doc_id", "content_shrink_blocked": "Prefer replacements; allow_shrink only when intentional", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "invalid_patch": "Pass text, replacements, or unified_diff", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "patch_apply_failed": "unified_diff missed the parent document — GET content and retry", "patch_too_large": "Shorter unified_diff or search_replace on the parent body", "replacement_not_found": "Phrase missing from joined parent document", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "Use BODY_WRITE_MODE_ENUM values on write_mode param", "write_mode_unsupported": "Parent body: append|prepend|search_replace|unified_diff|replace — not merge"}, "when_to_use": "You have a chunk doc_id from content.get chunks[] and need a phrase fix without source_doc_id routing. Prefer knowledge.content.patch when you already have source_doc_id.", "write_mode": ["replace", "write", "append", "prepend", "search_replace", "unified_diff"], "write_mode_note": "Chunk id from content.get; editor applies to parent document text."}, {"action": "knowledge.content.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.content.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Content Delete"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Remove KB document by source_doc_id (irreversible).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": true, "risk_class": "destructive", "safe_action": "knowledge_content_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Deactivate or hard-delete a KB document by source_doc_id. Same as DELETE /knowledge/content/{id}.", "title": "Knowledge Content Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "document_not_found": "Row missing — knowledge.content.list or already deleted", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_doc_id_required": "Pass source_doc_id from knowledge.content.list", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove KB document by source_doc_id (irreversible).", "write_mode": null}, {"action": "knowledge.registry.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.registry.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Registry List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List content registry entries before upsert.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_registry_list", "semantic_input_mode": "inherit_workflow", "summary": "List content registry entries before upsert.", "title": "Knowledge Registry List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List content registry entries before upsert.", "write_mode": null}, {"action": "knowledge.registry.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.registry.upsert", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Registry Upsert"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Upsert registry metadata for FAQ/guide documents.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_registry_upsert", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Upsert registry metadata for FAQ/guide documents.", "title": "Knowledge Registry Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "entry_required": "Pass entry object or flat registry keys on knowledge.registry.upsert", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "registry payload shape — discovery.describe knowledge.registry.upsert", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Upsert registry metadata for FAQ/guide documents.", "write_mode": null}, {"action": "knowledge.import", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.import", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Import"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"bundle": {}, "project_id": 123, "user_id": 123}, "example_request": {"action": "knowledge.import", "params": {"bundle": {}, "project_id": 123, "user_id": 123}}, "execution_class": "cheap", "instruction_hint": "Import knowledge pack JSON into project scope.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "rollback": ["generation.realign_to_prod"], "safe_action": "knowledge_import", "semantic_input_mode": "inherit_workflow", "summary": "Import knowledge pack JSON into project scope.", "title": "Knowledge Import", "verification": ["knowledge.health", "knowledge.config.get"], "verify": [{"action": "knowledge.health", "predicate": "named resource is visible"}, {"action": "knowledge.config.get", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "import_failed": "See data.errors[] — partial apply may need knowledge.health", "invalid_parameters": "bundle JSON shape — pair with knowledge.export for round-trip", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Import knowledge pack JSON into project scope.", "write_mode": null}, {"action": "knowledge.gc.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.gc.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Gc Status"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "GC queue status before reconcile or bulk ingest cleanup.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_gc_status", "semantic_input_mode": "inherit_workflow", "summary": "GC queue status before reconcile or bulk ingest cleanup.", "title": "Knowledge Gc Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "GC queue status before reconcile or bulk ingest cleanup.", "write_mode": null}, {"action": "knowledge.gc.reconcile", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.gc.reconcile", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Gc Reconcile"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Enqueue principal/GetCourse GC reconcile (async heavy job).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": true, "risk_class": "destructive", "safe_action": "knowledge_gc_reconcile", "semantic_input_mode": "inherit_workflow", "summary": "Enqueue principal/GetCourse GC reconcile (async heavy job).", "title": "Knowledge Gc Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enqueue principal/GetCourse GC reconcile (async heavy job).", "write_mode": null}, {"action": "knowledge.playground", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Using rag.search alone for mentor answer QA (skips gene_pack / Plan).", "anti_patterns": ["Using rag.search alone for mentor answer QA (skips gene_pack / Plan).", "Do not run fabula 12/12 batch through knowledge.playground — use bots.simulate."], "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "heavy_llm", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "execution_class": "heavy", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.playground", "recovery_blocks": {"orchestrator_binding_stale": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "orchestrator_binding_stale"}}, "related_tools": ["bots.simulate", "knowledge.config.get", "knowledge.prompt.get"], "semantic_input_mode": "per_step_nl", "source": "handler", "title": "Knowledge Playground"}, "effect": {"audit_batch_allowed": true, "conditional_mutate": "action=capabilities | skill_preview | plan_affinity_preview = read-only probes (no LLM); plan_suggest without use_llm is cheap. Default simulate holds ai_stream up to ~180s — one heavy_llm per sync MCP batch; prefer options.async=true + discovery.job_status on busy hosts.", "effect_depends_on_params": true, "execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "per_step_nl"}, "effect_kind": "read", "example_params": {"principal_user_id": 1, "text": "что такое макротрек и дай ссылку на урок"}, "example_request": {"action": "knowledge.playground", "params": {"principal_user_id": 1, "text": "что такое макротрек и дай ссылку на урок"}}, "examples": [{"name": "Capabilities preflight (no LLM)", "request": {"params": {"action": "capabilities", "project_id": 1}, "tool": "knowledge.playground"}, "response": {"data": {"mode": "capabilities"}, "success": true}}, {"name": "Mentor turn with principal (entitlement trace)", "request": {"params": {"principal_user_id": 12345, "project_id": 1444, "text": "Где урок про …?"}, "tool": "knowledge.playground"}, "response": {"data": {"context": {"product_ids": ["sku-1"]}, "synthesis_path": "registry_catalog_link"}, "success": true}}, {"name": "1444 free fabula named nav (playground trace)", "request": {"params": {"bot_uuid": "a1f4c56a-5d66-40e0-8de8-68cba1d520a6", "external_user_id": "fabula-baseline-a11", "principal_user_id": 1, "project_id": 1444, "text": "Где скачать Фабулу Любви к себе?"}, "tool": "knowledge.playground"}, "response": {"data": {"reply": "…lesson/view?id=345047850#a11…", "synthesis_path": "registry_named_exact"}, "success": true}}], "execution_class": "heavy", "instruction_hint": "Full mentor simulate with RAG/safety/gene-lock trace — one heavy_llm per sync execute. Preflight: a…", "knowledge_atoms": ["KNOWLEDGE_PLAYGROUND_HEAVY", "KNOWLEDGE_PLAYGROUND_VS_BOTS"], "mutation_kind": "none", "next_actions": [{"action": "discovery.job_status", "note": "Poll until completed or failed; do not re-run simulate to check status.", "params": {"job_id": "<job_id from async execute receipt>"}}], "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "knowledge.playground is heavy_llm — one per sync execute. Entitlement errors: knowledge.doctor.run before bulk ingest. Corrections: knowledge.correction.propose then acceptance gates.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["bots.simulate", "knowledge.config.get", "knowledge.prompt.get"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_playground", "semantic_input_mode": "per_step_nl", "summary": "Full bot simulate with RAG/safety/gene-lock trace (REST playground). Heavy LLM: one per sync agentstack.execute. Prefer over raw rag.search for mentor fidelity. Same budget as bots.simulate. instructi", "title": "Knowledge Playground", "when_blocked": {"agent_not_found": "default_playground_bot_uuid + bots.set_brain agent binding", "bot_not_found": "bots.get — playground bot_id missing on project slice", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "corpus_empty": "Ingest on Knowledge → Content; run knowledge.eval.retrieval smoke first", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "invalid_parameters": "text required unless action=capabilities|skill_preview", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "knowledge_collections_unavailable": "Retry once; verify collection_id exists", "knowledge_entitlement_denied": "Run knowledge.doctor.run; check project tier", "mcp_async_worker_unavailable": "process_role=api without worker — retry sync (no options.async)", "orchestrator_binding_stale": "bots.set_brain refresh agent_uuid after fleet edits", "orchestrator_failed": "Worker/API traceback — read data.detail and data.exc_type on simulate", "registry_miss": "data.synthesis_path registry_catalog_link|registry_nav — knowledge.registry.list + knowledge.retrieve.probe", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wrong_tier_or_product": "knowledge.principal.simulate — inspect context.product_ids; knowledge.access.grant or GetCourse reconcile if mismatch"}, "when_to_use": "Full mentor simulate with RAG/safety/gene-lock trace — one heavy_llm per sync execute. Preflight: action=capabilities (no text). Ladder: knowledge.principal.simulate → text + principal_user_id; read s", "write_mode": null}, {"action": "knowledge.principal.simulate", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.principal.simulate", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Principal Simulate"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read effective tier and context.product_ids before knowledge.playground — no LLM. Optional product_…", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_principal_simulate", "semantic_input_mode": "inherit_workflow", "summary": "Read effective tier and context.product_ids before knowledge.playground — no LLM. Optional product_id simulates paid-SKU gate downgrade.", "title": "Knowledge Principal Simulate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read effective tier and context.product_ids before knowledge.playground — no LLM. Optional product_id simulates paid-SKU gate downgrade.", "write_mode": null}, {"action": "knowledge.project_ai_keys.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.project_ai_keys.patch", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Project Ai Keys Patch"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Rotate project-scoped AI provider keys (protected leaf).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_project_ai_keys_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch tenant project AI keys in project.protected (KeySelector). Same storage as PUT /api/projects/{id}/ai-keys — no secret values in GET.", "title": "Knowledge Project Ai Keys Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rotate project-scoped AI provider keys (protected leaf).", "write_mode": null}, {"action": "knowledge.project_ai_keys.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.project_ai_keys.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Project Ai Keys Status"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read AI key binding status without exposing secrets.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_project_ai_keys_status", "semantic_input_mode": "inherit_workflow", "summary": "AI key presence + ai_settings flags (no secret values).", "title": "Knowledge Project Ai Keys Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read AI key binding status without exposing secrets.", "write_mode": null}, {"action": "knowledge.project_secrets.apply", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.project_secrets.apply", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Project Secrets Apply"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Apply encrypted project secrets bundle (ops migration). Sole helper bot on 1444: pass telegram2 + t…", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": true, "risk_class": "low_write", "safe_action": "knowledge_project_secrets_apply", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Apply Unity tenant secrets: OpenAI → project.protected; GetCourse/MAX/Telegram → Integration Hub protected (telegram → wire_unity_telegram). Pass openai/getcourse/max/telegram[/telegram2] and optional", "title": "Knowledge Project Secrets Apply", "when_blocked": {"apply_partial_failure": "Inspect data report steps (openai, getcourse, max, telegram, knowledge_config, product_id_map); knowledge_config soft_fail does not roll back Hub/protected keys", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_secrets_provided": "Pass at least one of openai, getcourse, max, telegram, telegram2, product_id_map_json", "preflight_blocked": "preflight.check action=knowledge.project_secrets.apply — bind context.project_id; read blockers[] (RBAC, FAP, supply, service_cap_denied)", "project_id_required": "Bind context.project_id before knowledge.project_secrets.apply", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps via apikeys.create (preset user_full or full_project) to include bots_run — required for bots.*, knowledge.project_secrets.apply, mentor.*, safety.*. agents_run (agent_runner preset) is not bots_run.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply encrypted project secrets bundle (ops migration). Sole helper bot on 1444: pass telegram2 + telegram2_bot_uuid + telegram2_connection_slug (not telegram alone on legacy primary UUID).", "write_mode": null}, {"action": "knowledge.journal.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.journal.get", "related_tools": ["knowledge.journal.list", "knowledge.correction.propose", "knowledge.playground"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Journal Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Diagnose by correlation_id", "request": {"params": {"correlation_id": "corr-abc", "project_id": 1}, "tool": "knowledge.journal.get"}, "response": {"data": {"turn_id": "…"}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Fetch one mentor journal turn by correlation_id or turn_id for diagnose/correction.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.journal.list", "knowledge.correction.propose", "knowledge.playground"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_journal_get", "semantic_input_mode": "inherit_workflow", "summary": "Fetch one mentor journal turn by correlation_id or turn_id for diagnose/correction.", "title": "Knowledge Journal Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "correlation_id_or_turn_id_required": "Pass correlation_id or turn_id from journal.list", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before journal reads", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "turn_not_found": "knowledge.journal.list — pick correlation_id from recent turns", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fetch one mentor journal turn by correlation_id or turn_id for diagnose/correction.", "write_mode": null}, {"action": "knowledge.correction.propose", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.correction.propose", "related_tools": ["knowledge.journal.get", "knowledge.config.patch", "knowledge.acceptance.case.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Correction Propose"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Draft correction steps from a journal turn — NO auto-write.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "knowledge.playground is heavy_llm — one per sync execute. Entitlement errors: knowledge.doctor.run before bulk ingest. Corrections: knowledge.correction.propose then acceptance gates.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.journal.get", "knowledge.config.patch", "knowledge.acceptance.case.upsert"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_correction_propose", "semantic_input_mode": "inherit_workflow", "summary": "Draft correction steps from a journal turn — NO auto-write.", "title": "Knowledge Correction Propose", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Draft correction steps from a journal turn — NO auto-write.", "write_mode": null}, {"action": "knowledge.acceptance.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.acceptance.list", "related_tools": ["knowledge.acceptance.run", "knowledge.acceptance.case.run", "knowledge.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Acceptance List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List built-in acceptance fixture suites before knowledge.acceptance.run.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.acceptance.run", "knowledge.acceptance.case.run", "knowledge.health"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_acceptance_list", "semantic_input_mode": "inherit_workflow", "summary": "List built-in acceptance fixture suites before knowledge.acceptance.run.", "title": "Knowledge Acceptance List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List built-in acceptance fixture suites before knowledge.acceptance.run.", "write_mode": null}, {"action": "knowledge.acceptance.run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.acceptance.run", "related_tools": ["knowledge.acceptance.list", "knowledge.acceptance.case.run", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Acceptance Run"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "instruction_hint": "Run acceptance suite (rule-based; eval_mode=retrieval avoids LLM).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.acceptance.list", "knowledge.acceptance.case.run", "generation.promote"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_acceptance_run", "semantic_input_mode": "inherit_workflow", "summary": "Run built-in or tenant acceptance suite; gate on data.eval_passed.", "title": "Knowledge Acceptance Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run acceptance suite (rule-based; eval_mode=retrieval avoids LLM).", "write_mode": null}, {"action": "knowledge.acceptance.case.run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.acceptance.case.run", "related_tools": ["knowledge.acceptance.run", "knowledge.acceptance.list", "generation.gates"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Acceptance Case Run"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "instruction_hint": "Run one acceptance case by id from a suite.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.acceptance.run", "knowledge.acceptance.list", "generation.gates"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_acceptance_case_run", "semantic_input_mode": "inherit_workflow", "summary": "Run one acceptance case; eval_passed mirrors harness ok.", "title": "Knowledge Acceptance Case Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run one acceptance case by id from a suite.", "write_mode": null}, {"action": "knowledge.acceptance.case.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.acceptance.case.upsert", "mutation_risk": "low", "related_tools": ["knowledge.acceptance.case.run", "knowledge.config.patch", "generation.diff_vs_prod"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Acceptance Case Upsert"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Append regression case to config.knowledge.acceptance_cases (merge, not replace).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.acceptance.case.run", "knowledge.config.patch", "generation.diff_vs_prod"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_acceptance_case_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Append regression case to config.knowledge.acceptance_cases (merge, not replace).", "title": "Knowledge Acceptance Case Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm tier/buffs before ingest or playground", "invalid_parameters": "discovery.describe for required params; bind context.project_id from auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append regression case to config.knowledge.acceptance_cases (merge, not replace).", "write_mode": null}, {"action": "knowledge.doctor.run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.doctor.run", "related_tools": ["knowledge.health", "knowledge.kb.ingest", "knowledge.config.get", "generation.diff_vs_prod", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Doctor Run"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "examples": [{"name": "Read-only preflight", "request": {"params": {"project_id": 1, "skip_retrieval": true}, "tool": "knowledge.doctor.run"}, "response": {"data": {"checks": {}, "ok": true}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Read-only mentor doctor for any project (gene pack + retrieval probe).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "knowledge.playground is heavy_llm — one per sync execute. Entitlement errors: knowledge.doctor.run before bulk ingest. Corrections: knowledge.correction.propose then acceptance gates.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.health", "knowledge.kb.ingest", "knowledge.config.get", "generation.diff_vs_prod", "preflight.check"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_doctor_run", "semantic_input_mode": "inherit_workflow", "summary": "Read-only mentor doctor for any project (gene pack + retrieval probe).", "title": "Knowledge Doctor Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "doctor_failed": "data.ok false — read checks{}; canonical_mentor_cards → knowledge.kb.ingest", "feature_not_available": "knowledge.health — confirm tier/buffs before doctor", "invalid_parameters": "project_id required (params or MCP context)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read-only mentor doctor for any project (gene pack + retrieval probe).", "write_mode": null}, {"action": "knowledge.retrieve.probe", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.retrieve.probe", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Retrieve Probe"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "examples": [{"name": "Top-k hybrid (no LLM)", "request": {"params": {"project_id": 1, "query": "refund policy", "top_k": 3}, "tool": "knowledge.retrieve.probe"}, "response": {"data": {"doc_ids": []}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Hybrid retrieval probe (no LLM) — top doc_ids for a query.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "knowledge_retrieve_probe", "semantic_input_mode": "inherit_workflow", "summary": "Hybrid retrieval probe (no LLM) — top doc_ids for a query.", "title": "Knowledge Retrieve Probe", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "knowledge.doctor.run — confirm collections entitlement before probe", "invalid_parameters": "Fix query shape or bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "query_required": "Pass non-empty query string", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hybrid retrieval probe (no LLM) — top doc_ids for a query.", "write_mode": null}, {"action": "knowledge.phenotype.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.phenotype.upsert", "mutation_risk": "low", "related_tools": ["knowledge.config.get", "knowledge.retrieve.probe", "knowledge.gene_pack.pinned_shape.upsert"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Phenotype Upsert"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "generation_atoms": {"GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts."}, "instruction_hint": "Partial gene_pack phenotype merge by name + compile_warnings (prefer over raw config.patch).", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT", "KNOWLEDGE_TENANT_EDIT_LADDER", "GENERATION_SAFE_CYCLE_LADDER"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.config.get", "knowledge.retrieve.probe", "knowledge.gene_pack.pinned_shape.upsert"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_phenotype_upsert", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Single FAQ route / gene_pack row — merge by name; prefer over full gene_pack patch. Then knowledge.retrieve.probe; promote via generation.* when auto_generation_mode on.", "title": "Knowledge Phenotype Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "generation_fork_required": "auto_generation_mode on — omit env_uuid for auto-fork on patch or pass sandbox anchor; then generation.diff_vs_prod → generation.gates → generation.promote", "invalid_parameters": "discovery.describe; bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "phenotype_name_required": "phenotype.name non-empty string required", "phenotype_required": "Pass phenotype object", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Partial gene_pack phenotype merge by name + compile_warnings (prefer over raw config.patch).", "write_mode": null}, {"action": "knowledge.gene_pack.pinned_shape.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.gene_pack.pinned_shape.upsert", "mutation_risk": "low", "related_tools": ["knowledge.phenotype.upsert", "knowledge.config.get", "knowledge.retrieve.probe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Knowledge Gene Pack Pinned Shape Upsert"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "generation_atoms": {"GENERATION_SAFE_CYCLE_LADDER": "auto_generation_mode on: most MCP mutates auto-fork sandbox → generation.diff_vs_prod → generation.gates → generation.promote (auto_promote_strategy) — each in its own sync execute (GENERATION_SYNC_BATCH_BUDGET). Exception: bots.order_manager_bootstrap apply never auto-forks — generation.env_snapshot then dry_run=false with env_uuid when sandbox_gate.apply_ready. Knowledge config: knowledge.config.patch / knowledge.prompt.patch (not projects.patch_data on config.knowledge.*). Pre-mutate: preflight.check + knowledge.health. No prod dna_set_* / leaf writes without sandbox anchor — not deploy scripts."}, "instruction_hint": "Merge one pinned_shapes binding (phenotype → glossary_stem) + compile_warnings.", "knowledge_atoms": ["KNOWLEDGE_ENTITLEMENT", "KNOWLEDGE_TENANT_EDIT_LADDER", "GENERATION_SAFE_CYCLE_LADDER"], "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_text_editor", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.phenotype.upsert", "knowledge.config.get", "knowledge.retrieve.probe"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "knowledge_gene_pack_pinned_shape_upsert", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Merge one pinned_shapes binding (phenotype → glossary_stem) + compile_warnings.", "title": "Knowledge Gene Pack Pinned Shape Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Tier or collections entitlement — knowledge.health or buffs.get_effective_limits", "generation_fork_required": "auto_generation_mode on — omit env_uuid for auto-fork on patch or pass sandbox anchor; then generation.diff_vs_prod → generation.gates → generation.promote", "invalid_parameters": "discovery.describe; bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "phenotype_name_required": "phenotype.name non-empty string required", "phenotype_required": "Pass phenotype object", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Merge one pinned_shapes binding (phenotype → glossary_stem) + compile_warnings.", "write_mode": null}], "logic": [{"action": "logic.create", "aliases": ["function.compile", "function.create", "functions.compile", "functions.create", "logic.write", "rules.create", "rules.create_rules"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not logic.create a second rule — logic.get the id from the create receipt.", "anti_patterns": ["Do not logic.create a second rule — logic.get the id from the create receipt.", "Do not enable on production traffic before logic.dry_run.", "Integration Hub recipes may already attach rules — do not duplicate inbound intake."], "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.create", "mutation_risk": "low", "related_tools": ["logic.attach_template", "logic.list", "logic.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Logic Create"}, "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"insufficient_permissions": "logic_write cap + project membership on tenant PID", "invalid_parameters": "logic.get_commands + logic.signals_catalog before triggers/space", "invalid_structure": "logic.get_processors for processor ids — fix graph before retry", "processor_not_found": "logic.get_processors — specified processor not available"}, "example_params": {"description": "Checks if user is eligible for daily reward and grants it", "enabled": true, "name": "Daily Reward Check", "priority": 5, "schedulers": [{"cron": "0 2 * * *", "timezone": "UTC"}], "space": [{"action": "add", "parameters": {"field1": "user.daily_streak", "field2": 1, "result_field": "user.daily_streak"}, "processor": "field_operations_processor"}], "triggers": [{"command": "check.daily_reward", "type": "command", "when": {}}]}, "example_request": {"action": "logic.create", "params": {"description": "Checks if user is eligible for daily reward and grants it", "enabled": true, "name": "Daily Reward Check", "priority": 5, "schedulers": [{"cron": "0 2 * * *", "timezone": "UTC"}], "space": [{"action": "add", "parameters": {"field1": "user.daily_streak", "field2": 1, "result_field": "user.daily_streak"}, "processor": "field_operations_processor"}], "triggers": [{"command": "check.daily_reward", "type": "command", "when": {}}]}}, "examples": [{"description": "Create a rule that executes when a specific command is called", "name": "Create rule with command trigger", "request": {"params": {"description": "Check and grant daily rewards to users", "enabled": true, "name": "Daily Reward Check", "priority": 5, "space": [{"action": "add", "parameters": {"field1": "user.daily_streak", "field2": 1, "result_field": "user.daily_streak"}, "processor": "field_operations_processor"}, {"action": "set", "parameters": {"field": "user.last_reward_date", "value": "{{now}}"}, "processor": "field_operations_processor"}], "triggers": [{"command": "check.daily_reward", "type": "command", "when": {}}]}, "tool": "logic.create"}, "response": {"data": {"created_at": "2025-01-20T10:00:00Z", "description": "Check and grant daily rewards to users", "enabled": true, "id": "550e8400-e29b-41d4-a716-446655440000", "name": "Daily Reward Check", "priority": 5, "space": [], "triggers": [{"command": "check.daily_reward", "type": "command"}]}, "success": true}}, {"description": "Create a rule that runs on a schedule using cron expression", "name": "Create rule with scheduler", "request": {"params": {"description": "Run daily cleanup task at 2 AM UTC", "enabled": true, "name": "Daily Cleanup", "schedulers": [{"cron": "0 2 * * *", "timezone": "UTC"}], "space": [{"action": "delete", "parameters": {"entity": "temp_data", "filters": {"created_at": {"$lt": "now-7d"}}}, "processor": "dna_operations_processor"}]}, "tool": "logic.create"}, "response": {"data": {"created_at": "2025-01-20T10:00:00Z", "enabled": true, "id": "550e8400-e29b-41d4-a716-446655440001", "name": "Daily Cleanup"}, "success": true}}, {"description": "Create a rule with multiple processor blocks executing sequentially", "name": "Create complex rule with multiple processors", "request": {"params": {"description": "Handle new user registration with multiple steps", "enabled": true, "name": "User Registration Handler", "priority": 7, "space": [{"action": "set", "parameters": {"field": "user.registration_date", "value": "{{now}}"}, "processor": "field_operations_processor"}, {"action": "set", "parameters": {"field": "user.status", "value": "active"}, "processor": "field_operations_processor"}, {"action": "send", "parameters": {"recipient": "{{user.email}}", "type": "welcome_email"}, "processor": "notification_processor"}], "triggers": [{"command": "user.register", "type": "command", "when": {}}]}, "tool": "logic.create"}, "response": {"data": {"enabled": true, "id": "550e8400-e29b-41d4-a716-446655440002", "name": "User Registration Handler"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "When X then Y automation — prefer over custom event handlers. Save logic_id; logic.dry_run before e…", "kind": "mcp_domain", "logic_atoms": {"LOGIC_DRY_RUN_FIRST": "logic.create / logic.attach_template mutations: logic.dry_run with logic_id before enable or production traffic. Disabled rules still dry-run. A space graph with processors must execute; blocks_executed=0 is no_blocks_executed, not success.", "LOGIC_ID_FROM_RECEIPT": "logic.dry_run needs logic_id from logic.create or logic.attach_template receipt — not a rule spec or template_id alone.", "LOGIC_NO_SECOND_CREATE": "Do not logic.create a second rule — logic.get the id from the first create receipt."}, "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.attach_template", "logic.list", "logic.dry_run"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "rollback": ["logic.delete", "generation.realign_to_prod"], "safe_action": "logic_create", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create new Logic Engine rule for project.", "title": "Logic Create", "tool_chains": ["scheduled_rewards", "game_setup", "game_setup"], "verification": ["logic.get", "logic.dry_run"], "verify": [{"action": "logic.get", "predicate": "named resource is visible"}, {"action": "logic.dry_run", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "logic_write cap + project membership on tenant PID", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic.get_commands + logic.signals_catalog before triggers/space", "invalid_structure": "logic.get_processors for processor ids — fix graph before retry", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "processor_not_found": "logic.get_processors — specified processor not available", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "When X then Y automation — prefer over custom event handlers. Save logic_id; logic.dry_run before enable.", "workflow_ladder": ["context.project_id bound — logic.list or prepare logic.create / logic.attach_template", "logic.create or logic.attach_template — save logic_id from the response receipt", "logic.dry_run with logic_id + command_data/mocks — not template_id or inline spec", "logic.update to enable only after dry_run trace is clean", "logic.list_versions → logic.diff_versions before logic.restore_version"], "write_mode": null}, {"action": "logic.update", "ai_tips": "Update an existing logic rule. Pass write_mode for triggers/space/schedulers; prefer path_updates for one node. One sentence in description: replacements + text_field=description (no GET).", "aliases": ["rules.activate_rules", "rules.update_rules"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Sending one trigger without write_mode=merge and expecting siblings to remain (omit is now merge, but be explicit).", "anti_patterns": ["Sending one trigger without write_mode=merge and expecting siblings to remain (omit is now merge, but be explicit).", "Putting bot commands or KB text into logic.space."], "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.update", "mutation_risk": "low", "related_tools": ["logic.get", "logic.create", "logic.delete", "logic.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Update"}, "collection_key": "uid", "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"content_shrink_blocked": "full replace on text_field is much shorter — allow_shrink or search_replace", "insufficient_permissions": "logic_write cap + project membership", "logic_collection_empty_blocked": "pass write_mode or non-empty collection — not wipe", "logic_not_found": "logic.list or logic.get with same project_id before update", "patch_apply_failed": "unified_diff did not apply on text_field — logic.get and retry", "replacement_not_found": "replacements.find is not in text_field (description|name)", "write_mode_invalid": "logic.get_commands — supported write_mode for triggers/space", "write_mode_unsupported": "append/prepend are not valid for logic collections"}, "examples": [{"description": "Disable a logic rule", "request": {"enabled": false, "logic_id": "uuid"}, "response": {"data": {"logic": {"enabled": false, "id": "uuid"}, "message": "Logic updated successfully", "success": true}, "success": true}}, {"description": "Patch a single space node via PathAtom", "request": {"logic_id": "uuid", "path_updates": {"space{node-1}.label": "Renamed"}}, "response": {"data": {"logic": {"id": "uuid", "name": "Updated Rule"}, "message": "Logic updated successfully", "success": true}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Update an existing logic rule. Pass write_mode for triggers/space/schedulers; prefer path_updates f…", "kind": "mcp_domain", "logic_atoms": {"LOGIC_COLLECTION_EMPTY_BLOCKED": "logic.update with empty triggers/space/schedulers is blocked (logic_collection_empty_blocked) — use write_mode intentionally.", "LOGIC_VERSION_CONFLICT": "logic.restore_version / logic.diff_versions: logic.list_versions first — stale version_id returns not_found; diff before restore."}, "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get", "logic.create", "logic.delete", "logic.dry_run"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "logic_update", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Update existing Logic Engine rule.", "title": "Logic Update", "when_blocked": {"content_shrink_blocked": "full replace on text_field is much shorter — allow_shrink or search_replace", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "logic_write cap + project membership", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "logic_collection_empty_blocked": "pass write_mode or non-empty collection — not wipe", "logic_not_found": "logic.list or logic.get with same project_id before update", "patch_apply_failed": "unified_diff did not apply on text_field — logic.get and retry", "replacement_not_found": "replacements.find is not in text_field (description|name)", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_mode_invalid": "logic.get_commands — supported write_mode for triggers/space", "write_mode_unsupported": "append/prepend are not valid for logic collections"}, "when_to_use": "Update an existing logic rule. Pass write_mode for triggers/space/schedulers; prefer path_updates for one node. One sentence in description: replacements + text_field=description (no GET).", "write_mode": ["merge", "patch", "upsert", "replace", "write", "delete"], "write_mode_note": "triggers/space/schedulers are keyed lists: pass write_mode. Prefer path_updates for one node."}, {"action": "logic.delete", "aliases": ["rules.delete_rules"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.delete", "mutation_risk": "low", "related_tools": ["logic.get", "logic.create", "logic.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Delete"}, "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "errors": {"insufficient_permissions": "logic_write cap + project membership", "invalid_parameters": "logic_id + context.project_id required", "logic_not_found": "logic.list — logic_id must exist before delete", "not_found": "logic.list — logic_id must exist before delete"}, "example_params": {"dry_run": false, "logic_id": "example_string"}, "example_request": {"action": "logic.delete", "params": {"dry_run": false, "logic_id": "example_string"}}, "examples": [{"description": "Delete a logic rule", "request": {"logic_id": "uuid"}, "response": {"data": {"deleted": true, "logic_id": "uuid"}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Remove automation by id — irreversible.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get", "logic.create", "logic.list"], "required_cap": "logic_write", "requires_preflight": true, "risk_class": "destructive", "rollback": [], "safe_action": "logic_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete a Logic Engine rule.", "title": "Logic Delete", "verification": ["logic.list"], "verify": [{"action": "logic.list", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "logic_write cap + project membership", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id + context.project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "logic_not_found": "logic.list — logic_id must exist before delete", "not_found": "logic.list — logic_id must exist before delete", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove automation by id — irreversible.", "write_mode": null}, {"action": "logic.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.get", "related_tools": ["logic.execute", "logic.delete", "logic.get_commands"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Get"}, "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"internal_error": "retry once; logic.list if logic_id may be stale", "invalid_parameters": "logic_id + context.project_id required", "logic_not_found": "logic.list — logic_id from create/attach receipt", "not_found": "logic.list — logic_id from create/attach receipt", "project_not_found": "bind context.project_id before logic.get"}, "examples": [{"description": "Get logic rule details", "request": {"logic_id": "uuid"}, "response": {"data": {"enabled": true, "id": "uuid", "name": "Daily Reward"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Load one rule graph by logic_id — after logic.list pick or create/attach receipt.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.execute", "logic.delete", "logic.get_commands"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_get", "semantic_input_mode": "inherit_workflow", "summary": "Get detailed information about a Logic Engine rule.", "title": "Logic Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "retry once; logic.list if logic_id may be stale", "invalid_parameters": "logic_id + context.project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "logic_not_found": "logic.list — logic_id from create/attach receipt", "not_found": "logic.list — logic_id from create/attach receipt", "project_not_found": "bind context.project_id before logic.get", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load one rule graph by logic_id — after logic.list pick or create/attach receipt.", "write_mode": null}, {"action": "logic.list", "aliases": ["function.list", "functions.list", "rules.list", "rules.list_rules"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.list", "related_tools": ["logic.get", "logic.create", "logic.dry_run", "logic.execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic List"}, "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "context.project_id bound — optional filters only", "unauthorized": "logic_read cap + project membership"}, "examples": [{"description": "List all logic rules", "request": {}, "response": {"data": {"count": 1, "logic": [{"enabled": true, "id": "uuid", "name": "Rule 1"}]}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Enumerate rules in project scope — empty list is valid fork head.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get", "logic.create", "logic.dry_run", "logic.execute"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_list", "semantic_input_mode": "inherit_workflow", "summary": "Page Logic Engine rules for a project (default 100, max 1000).", "title": "Logic List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound — optional filters only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap + project membership", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enumerate rules in project scope — empty list is valid fork head.", "write_mode": null}, {"action": "logic.execute", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.execute", "mutation_risk": "low", "related_tools": ["logic.get", "logic.create", "logic.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Logic Execute"}, "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"execution_failed": "Rule execution failed — logic.get graph before retry", "invalid_parameters": "logic_id + command_data required", "logic_execution_failed": "logic.get_processors — fix graph before execute", "logic_not_found": "logic.list — logic_id from create/attach receipt", "not_found": "logic.get — rule must exist; logic.dry_run before production execute"}, "example_params": {"context": {}, "event_data": {}, "logic_id": "example_string"}, "example_request": {"action": "logic.execute", "params": {"context": {}, "event_data": {}, "logic_id": "example_string"}}, "examples": [{"description": "Execute a logic rule for testing", "request": {"event_data": {"test": "data"}, "logic_id": "uuid"}, "response": {"data": {"execution_id": "exec-1", "execution_time_ms": 12, "logic_id": "uuid", "message": "Logic executed successfully", "result": {}, "results": [], "success": true}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Run enabled rule on live traffic — logic.dry_run first; not a substitute for dry_run.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get", "logic.create", "logic.dry_run"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "logic_execute", "semantic_input_mode": "inherit_workflow", "summary": "Execute a Logic Engine rule immediately.", "title": "Logic Execute", "tool_chains": ["crud_with_logic"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_failed": "Rule execution failed — logic.get graph before retry", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id + command_data required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "logic_execution_failed": "logic.get_processors — fix graph before execute", "logic_not_found": "logic.list — logic_id from create/attach receipt", "not_found": "logic.get — rule must exist; logic.dry_run before production execute", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run enabled rule on live traffic — logic.dry_run first; not a substitute for dry_run.", "write_mode": null}, {"action": "logic.get_processors", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.get_processors", "related_tools": ["processors.list", "logic.create", "logic.update"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Get Processors"}, "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "context.project_id bound", "unauthorized": "logic_read cap before planning processors"}, "examples": [{"description": "Get available processors for logic", "request": {}, "response": {"data": {"processors": [{"category": "data_processing", "description": "Mathematical and field operations", "name": "field_operations_processor"}], "total": 10}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Processor catalog for space graph — before logic.create wiring.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["processors.list", "logic.create", "logic.update"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_get_processors", "semantic_input_mode": "inherit_workflow", "summary": "Get list of available processors (same as processors.list but in logic context).", "title": "Logic Get Processors", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap before planning processors", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Processor catalog for space graph — before logic.create wiring.", "write_mode": null}, {"action": "logic.get_commands", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.get_commands", "related_tools": ["logic.signals_catalog", "logic.create", "logic.update"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Get Commands"}, "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "context.project_id bound", "unauthorized": "logic_read cap — catalog of block commands"}, "examples": [{"description": "Get available commands for triggers", "request": {}, "response": {"data": {"commands": ["check.daily_reward"], "count": 1}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Block command catalog — pair with logic.signals_catalog for triggers.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.signals_catalog", "logic.create", "logic.update"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_get_commands", "semantic_input_mode": "inherit_workflow", "summary": "Get list of available commands for triggers.", "title": "Logic Get Commands", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap — catalog of block commands", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Block command catalog — pair with logic.signals_catalog for triggers.", "write_mode": null}, {"action": "logic.flush_batch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.flush_batch", "mutation_risk": "low", "related_tools": ["logic.create", "logic.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Flush Batch"}, "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"internal_error": "retry once; logic.list if batch state unknown", "invalid_parameters": "batch scope + project_id required", "not_found": "no pending batch — logic.list or prior flush receipt", "project_not_found": "bind context.project_id before logic.flush_batch"}, "examples": [{"input": {"_project_id": 123}, "output": {"message": "Batch flushed for project 123", "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Flush coalesced logic batch writes — after mutations in same session.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.create", "logic.list"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "logic_flush_batch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Force flush logic batch for a project (saves all accumulated rules immediately)", "title": "Logic Flush Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "retry once; logic.list if batch state unknown", "invalid_parameters": "batch scope + project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "no pending batch — logic.list or prior flush receipt", "project_not_found": "bind context.project_id before logic.flush_batch", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Flush coalesced logic batch writes — after mutations in same session.", "write_mode": null}, {"action": "logic.dry_run", "aliases": ["rules.test_rules"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not pass a rule spec — logic.dry_run needs logic_id from an existing rule.", "anti_patterns": ["Do not pass a rule spec — logic.dry_run needs logic_id from an existing rule.", "Do not treat dry_run success as go-live — review trace before logic.update enable.", "Do not treat blocks_executed=0 as success when space lists a processor."], "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "effect_override": {"conditional_mutate": "Simulates rule; no durable automation writes.", "kind": "read", "read_only_hint": true}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.dry_run", "related_tools": ["logic.get", "logic.create", "logic.attach_template", "logic.update"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Dry Run"}, "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Simulates rule; no durable automation writes.", "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "effect_override": {"conditional_mutate": "Simulates rule; no durable automation writes.", "kind": "read", "read_only_hint": true}, "errors": {"invalid_parameters": "logic_id required — not template_id or inline rule spec", "logic_execution_failed": "logic.get graph — fix processor ids via logic.get_processors", "no_blocks_executed": "space has processors but none ran — logic.get the graph; dry_run is not a no-op", "not_found": "logic.list or logic.get — logic_id from create/attach receipt"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Simulate an existing rule without side effects. Requires logic_id from create/attach.", "kind": "mcp_domain", "language": "typescript", "logic_atoms": {"LOGIC_DRY_RUN_FIRST": "logic.create / logic.attach_template mutations: logic.dry_run with logic_id before enable or production traffic. Disabled rules still dry-run. A space graph with processors must execute; blocks_executed=0 is no_blocks_executed, not success.", "LOGIC_ID_FROM_RECEIPT": "logic.dry_run needs logic_id from logic.create or logic.attach_template receipt — not a rule spec or template_id alone."}, "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get", "logic.create", "logic.attach_template", "logic.update"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_dry_run", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Simulate a logic rule execution without side effects (F2.5).", "title": "Logic Dry Run", "when_blocked": {"SS1401": "dna.write path not in write_paths — fix export meta or script.put", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Re-upload via script.put", "bytecode_stale": "compiler_version on the stored artifact differs — script.recompile_version or script.put before dry_run", "cap_not_implemented": "P1 VM — dna.*, events.emit (host allowlist), wallet via stackscript.wallet.replay; not http/notify/secrets — script.docs topic=host", "compile_failed": "Ephemeral sources did not compile — see diagnostics", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "db_unavailable": "Retry dry_run after retry_after_ms — same as script.run", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field on input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_write_path_denied": "Same as SS1401", "entry_path_required": "Multi-file files[] needs entry", "expect_value_mismatch": "VM value differed from expect_value — fix script or input", "export_not_found": "Use export_names from script.put receipt", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass input object or positional array — export requires parameters", "input_requires_integer_slots": "input values must be numeric (coerce strings)", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id required — not template_id or inline rule spec", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "logic_execution_failed": "logic.get graph — fix processor ids via logic.get_processors", "no_blocks_executed": "space has processors but none ran — logic.get the graph; dry_run is not a no-op", "no_published_version": "script.publish or put with publish=live", "not_found": "logic.list or logic.get — logic_id from create/attach receipt", "payload_too_large": "files[] exceeds the same byte cap as script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "run_timeout": "VM exceeded run timeout — simplify export or split work", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "script_dry_run_failed": "VM or export error — see error field", "script_id_or_files_required": "Pass script_id or ephemeral files[] with path/content and optional entry", "script_not_found": "script.put first", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_pathological": "Source line count, line length, or comment-padding probe (SS1098) — max 25k lines/file, 8KiB/line; split or trim before script.dry_run", "stackscript_fuel_quota_exceeded": "Upgrade plan or reduce fuel", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "version_not_found": "Check script.versions", "vm_division_by_zero": "Guard divisor in script body before divide/mod", "vm_fuel_exhausted": "Export exceeded per-run fuel limit — simplify body or raise cap", "vm_int_overflow": "int53 overflow — narrow arithmetic in export body", "wallet_user_required": "MCP session user_id required — omit params.user_id", "workflow_scope_leak": "params.user_id must match session user_id"}, "when_to_use": "Simulate an existing rule without side effects. Requires logic_id from create/attach.", "workflow_ladder": ["context.project_id bound — logic.list or prepare logic.create / logic.attach_template", "logic.create or logic.attach_template — save logic_id from the response receipt", "logic.dry_run with logic_id + command_data/mocks — not template_id or inline spec", "logic.update to enable only after dry_run trace is clean", "logic.list_versions → logic.diff_versions before logic.restore_version"], "write_mode": null}, {"action": "logic.list_versions", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.list_versions", "related_tools": ["logic.get", "logic.diff_versions", "logic.restore_version"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic List Versions"}, "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "logic_id required — not template_id", "not_found": "logic.list or logic.get — logic_id from create/attach receipt"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Version history before logic.restore_version or logic.diff_versions.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get", "logic.diff_versions", "logic.restore_version"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_list_versions", "semantic_input_mode": "inherit_workflow", "summary": "List historical snapshots stored on a rule (F2.9).", "title": "Logic List Versions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id required — not template_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "logic.list or logic.get — logic_id from create/attach receipt", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Version history before logic.restore_version or logic.diff_versions.", "write_mode": null}, {"action": "logic.diff_versions", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.diff_versions", "related_tools": ["logic.list_versions", "logic.restore_version"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Diff Versions"}, "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "logic_id and from_version/to_version required", "not_found": "logic.list_versions — pick two version ids from history"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Compare two logic versions — logic.list_versions for ids.", "kind": "mcp_domain", "logic_atoms": {"LOGIC_VERSION_CONFLICT": "logic.restore_version / logic.diff_versions: logic.list_versions first — stale version_id returns not_found; diff before restore."}, "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.list_versions", "logic.restore_version"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_diff_versions", "semantic_input_mode": "inherit_workflow", "summary": "Diff two rule versions. Returns delta only. A long old or new value is an envelope preview, not the leaf. Roll back with logic.restore_version.", "title": "Logic Diff Versions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id and from_version/to_version required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "logic.list_versions — pick two version ids from history", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Compare two logic versions — logic.list_versions for ids.", "write_mode": null}, {"action": "logic.restore_version", "aliases": ["logic.revert"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.restore_version", "mutation_risk": "low", "related_tools": ["logic.diff_versions", "logic.dry_run", "logic.update"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Restore Version"}, "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"invalid_parameters": "logic_id + version_id required", "not_found": "logic.list_versions — version_id must exist on logic_id", "version_conflict": "logic.diff_versions first — CAS revision mismatch on restore"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Rollback rule body — logic.diff_versions first; expect version conflict CAS.", "kind": "mcp_domain", "logic_atoms": {"LOGIC_VERSION_CONFLICT": "logic.restore_version / logic.diff_versions: logic.list_versions first — stale version_id returns not_found; diff before restore."}, "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.diff_versions", "logic.dry_run", "logic.update"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "logic_restore_version", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Roll a rule back to a prior snapshot (F2.9).", "title": "Logic Restore Version", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id + version_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "logic.list_versions — version_id must exist on logic_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "version_conflict": "logic.diff_versions first — CAS revision mismatch on restore"}, "when_to_use": "Rollback rule body — logic.diff_versions first; expect version conflict CAS.", "write_mode": null}, {"action": "logic.export_json", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.export_json", "related_tools": ["logic.get", "logic.import_json"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Export Json"}, "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "logic_id required", "not_found": "logic.list or logic.get — export needs logic_id"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Portable rule export — logic.get for logic_id before export.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get", "logic.import_json"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_export_json", "semantic_input_mode": "inherit_workflow", "summary": "Export a logic rule as JSON for backup / cross-project copy.", "title": "Logic Export Json", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "logic_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "logic.list or logic.get — export needs logic_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Portable rule export — logic.get for logic_id before export.", "write_mode": null}, {"action": "logic.import_json", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.import_json", "mutation_risk": "low", "related_tools": ["logic.dry_run", "logic.list", "logic.export_json"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Import Json"}, "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"invalid_parameters": "rule JSON body + logic_id or create path — logic.dry_run after import", "invalid_structure": "logic.get_commands — processor ids must exist in project"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Import rule JSON — logic.dry_run after import before enable.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.dry_run", "logic.list", "logic.export_json"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "logic_import_json", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Import a logic rule from JSON (creates a new rule).", "title": "Logic Import Json", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "rule JSON body + logic_id or create path — logic.dry_run after import", "invalid_structure": "logic.get_commands — processor ids must exist in project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Import rule JSON — logic.dry_run after import before enable.", "write_mode": null}, {"action": "logic.install_blueprint", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.install_blueprint", "mutation_risk": "low", "related_tools": ["logic.attach_template", "logic.dry_run", "logic.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Install Blueprint"}, "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"invalid_parameters": "blueprint_id + project_id required", "not_found": "catalog blueprint id — prefer logic.attach_template when id known"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Catalog blueprint install — prefer logic.attach_template when id known.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.attach_template", "logic.dry_run", "logic.list"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "logic_install_blueprint", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Install a catalog blueprint into the project (alias of attach_template with field_values).", "title": "Logic Install Blueprint", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "blueprint_id + project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "catalog blueprint id — prefer logic.attach_template when id known", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Catalog blueprint install — prefer logic.attach_template when id known.", "write_mode": null}, {"action": "logic.attach_template", "aliases": ["logic.templates_catalog"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not hand-copy template blocks when attach_template exists for the catalog id.", "anti_patterns": ["Do not hand-copy template blocks when attach_template exists for the catalog id.", "Do not call logic.dry_run with template_id — use logic_id from attach receipt."], "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.attach_template", "mutation_risk": "low", "related_tools": ["logic.dry_run", "logic.list", "logic.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Attach Template"}, "domain_title": "Logic MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"internal_error": "logic.list — reuse logic_id or logic.create with template blocks", "invalid_parameters": "context.project_id bound — template_id required", "not_found": "template_id from built-in catalog — verify id before attach_template"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Install a catalog template into the project. Save logic_id; logic.dry_run before enable.", "kind": "mcp_domain", "logic_atoms": {"LOGIC_ATTACH_TEMPLATE_CATALOG": "logic.attach_template: template_id from the built-in catalog — wrong id returns not_found; prefer attach_template over hand-copying blocks.", "LOGIC_DRY_RUN_FIRST": "logic.create / logic.attach_template mutations: logic.dry_run with logic_id before enable or production traffic. Disabled rules still dry-run. A space graph with processors must execute; blocks_executed=0 is no_blocks_executed, not success.", "LOGIC_ID_FROM_RECEIPT": "logic.dry_run needs logic_id from logic.create or logic.attach_template receipt — not a rule spec or template_id alone."}, "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.dry_run", "logic.list", "logic.create"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "logic_attach_template", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Install a template from the built-in catalog into the current project.", "title": "Logic Attach Template", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "logic.list — reuse logic_id or logic.create with template blocks", "invalid_parameters": "context.project_id bound — template_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "template_id from built-in catalog — verify id before attach_template", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Install a catalog template into the project. Save logic_id; logic.dry_run before enable.", "workflow_ladder": ["context.project_id bound — logic.list or prepare logic.create / logic.attach_template", "logic.create or logic.attach_template — save logic_id from the response receipt", "logic.dry_run with logic_id + command_data/mocks — not template_id or inline spec", "logic.update to enable only after dry_run trace is clean", "logic.list_versions → logic.diff_versions before logic.restore_version"], "write_mode": null}, {"action": "logic.signals_catalog", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.signals_catalog", "related_tools": ["logic.get_commands", "logic.create", "logic.mcp_actions_catalog"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Signals Catalog"}, "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "context.project_id bound", "unauthorized": "logic_read cap before wiring triggers"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "List signal names for triggers — before logic.create trigger wiring.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get_commands", "logic.create", "logic.mcp_actions_catalog"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_signals_catalog", "semantic_input_mode": "inherit_workflow", "summary": "List signal channels the logic engine can subscribe to.", "title": "Logic Signals Catalog", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap before wiring triggers", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List signal names for triggers — before logic.create trigger wiring.", "write_mode": null}, {"action": "logic.mcp_actions_catalog", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.mcp_actions_catalog", "related_tools": ["logic.get_processors", "logic.get_commands", "logic.signals_catalog"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Logic Mcp Actions Catalog"}, "domain_title": "Logic MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "context.project_id bound", "unauthorized": "logic_read cap — processor action catalog"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "List processor actions available to logic blocks — read-only planning.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "owner_gene": "core.mcp.logic.gen1", "plane": "logic.create, then logic.dry_run. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule. logic.get the id from the create receipt.", "plane_chooser": "logic.create or logic.attach_template from catalog, then logic.dry_run before enabling on production traffic. Heavy deterministic game/economy math → script.put + script.run (StackScript), not logic.create processors. logic.dry_run needs logic_id from the create/attach receipt — not a rule spec or template_id alone. Empty logic.list is this user's logic fork, else the live head. Do not logic.create a second rule — logic.get the id from the first receipt. Version history: logic.list_versions → logic.diff_versions → logic.restore_version. Integration Hub recipes may attach rules — do not duplicate inbound intake with a second logic.create.", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle", "agentstack_text_editor"], "related_tools": ["logic.get_processors", "logic.get_commands", "logic.signals_catalog"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "logic_mcp_actions_catalog", "semantic_input_mode": "inherit_workflow", "summary": "List MCP actions addressable from logic rules.", "title": "Logic Mcp Actions Catalog", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "internal_error": "Retry once; logic.list or support trace_id if persistent.", "invalid_parameters": "context.project_id bound", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "logic_read cap — processor action catalog", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List processor actions available to logic blocks — read-only planning.", "write_mode": null}], "mentor": [{"action": "mentor.journal.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.journal.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Journal List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Mentor turn journal — prefer knowledge.journal.list.", "mutation_kind": "none", "plane": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "plane_chooser": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "mentor_journal_list", "semantic_input_mode": "inherit_workflow", "summary": "Mentor turn journal — prefer knowledge.journal.list.", "title": "Mentor Journal List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mentor turn journal — prefer knowledge.journal.list.", "write_mode": null}, {"action": "mentor.eval.run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.eval.run", "related_tools": ["knowledge.eval.run", "knowledge.eval.run_all"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Eval Run"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "instruction_hint": "Run single mentor eval — prefer knowledge.eval.run.", "mutation_kind": "entity", "plane": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "plane_chooser": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "related_tools": ["knowledge.eval.run", "knowledge.eval.run_all"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "mentor_eval_run", "semantic_input_mode": "inherit_workflow", "summary": "Run single mentor eval — prefer knowledge.eval.run.", "title": "Mentor Eval Run", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run single mentor eval — prefer knowledge.eval.run.", "write_mode": null}, {"action": "mentor.eval.retrieval", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.eval.retrieval", "related_tools": ["knowledge.eval.retrieval", "knowledge.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Eval Retrieval"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "instruction_hint": "Retrieval slice eval before knowledge.eval.run_all.", "mutation_kind": "none", "plane": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "plane_chooser": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "related_tools": ["knowledge.eval.retrieval", "knowledge.health"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "mentor_eval_retrieval", "semantic_input_mode": "inherit_workflow", "summary": "Retrieval slice eval before knowledge.eval.run_all.", "title": "Mentor Eval Retrieval", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Retrieval slice eval before knowledge.eval.run_all.", "write_mode": null}, {"action": "mentor.eval.run_all", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.eval.run_all", "related_tools": ["knowledge.eval.run_all", "knowledge.eval.retrieval", "generation.gates"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Eval Run All"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "instruction_hint": "Full eval harness — prefer knowledge.eval.run_all.", "mutation_kind": "none", "plane": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "plane_chooser": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "related_tools": ["knowledge.eval.run_all", "knowledge.eval.retrieval", "generation.gates"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "mentor_eval_run_all", "semantic_input_mode": "inherit_workflow", "summary": "Full eval harness — prefer knowledge.eval.run_all.", "title": "Mentor Eval Run All", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Full eval harness — prefer knowledge.eval.run_all.", "write_mode": null}, {"action": "mentor.export", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.export", "related_tools": ["knowledge.export", "knowledge.import"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Export"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Export mentor config — prefer knowledge.export.", "mutation_kind": "none", "plane": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "plane_chooser": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "related_tools": ["knowledge.export", "knowledge.import"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "mentor_export", "semantic_input_mode": "inherit_workflow", "summary": "Export mentor config — prefer knowledge.export.", "title": "Mentor Export", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export mentor config — prefer knowledge.export.", "write_mode": null}, {"action": "mentor.principal_link.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.principal_link.upsert", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Principal Link Upsert"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Upsert principal link row after bind_code.", "mutation_kind": "entity", "plane": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "plane_chooser": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "mentor_principal_link_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Upsert principal link row after bind_code.", "title": "Mentor Principal Link Upsert", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Upsert principal link row after bind_code.", "write_mode": null}, {"action": "mentor.principal_link.bind_code", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.principal_link.bind_code", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Principal Link Bind Code"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Bind principal/GetCourse link code to user.", "mutation_kind": "none", "plane": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "plane_chooser": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "mentor_principal_link_bind_code", "semantic_input_mode": "inherit_workflow", "summary": "Bind principal/GetCourse link code to user.", "title": "Mentor Principal Link Bind Code", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bind principal/GetCourse link code to user.", "write_mode": null}, {"action": "mentor.kb.ingest", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.kb.ingest", "related_tools": ["knowledge.kb.ingest", "knowledge.health", "knowledge.doctor.run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Mentor Kb Ingest"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Ingest KB for mentor — prefer knowledge.kb.ingest.", "mutation_kind": "none", "plane": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "plane_chooser": "Mentor tenant ops: mentor.journal.* — DNA via generation plane; not routine platform edits.", "related_tools": ["knowledge.kb.ingest", "knowledge.health", "knowledge.doctor.run"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "mentor_kb_ingest", "semantic_input_mode": "inherit_workflow", "summary": "Ingest KB for mentor — prefer knowledge.kb.ingest.", "title": "Mentor Kb Ingest", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ingest KB for mentor — prefer knowledge.kb.ingest.", "write_mode": null}], "messaging": [{"action": "messaging.send_test_email", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.send_test_email", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Send Test Email"}, "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: send test email via messaging plane (admin).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "messaging_send_test_email", "semantic_input_mode": "inherit_workflow", "summary": "Send ecosystem test email (admin).", "title": "Messaging Send Test Email", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "operation_failed": "messaging.test_connection then messaging.get_config", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: send test email via messaging plane (admin).", "write_mode": null}, {"action": "messaging.get_config", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.get_config", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Get Config"}, "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: read Mail Hub config without secrets.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_get_config", "semantic_input_mode": "inherit_workflow", "summary": "Get sanitized ecosystem messaging config (admin).", "title": "Messaging Get Config", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: read Mail Hub config without secrets.", "write_mode": null}, {"action": "messaging.test_connection", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.test_connection", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Test Connection"}, "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: verify Resend/SMTP credentials before send.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_test_connection", "semantic_input_mode": "inherit_workflow", "summary": "Probe configured email provider (admin).", "title": "Messaging Test Connection", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "email_channel_not_configured": "messaging.get_config then messaging.put_config", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: verify Resend/SMTP credentials before send.", "write_mode": null}, {"action": "messaging.send_email", "aliases": ["messaging.send"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Not notifications.deliver — tenant or bot-channel notices; this is ecosystem Mail Hub admin SMTP.", "anti_patterns": ["Not notifications.deliver — tenant or bot-channel notices; this is ecosystem Mail Hub admin SMTP.", "Not a signed-in user's reply. The bot /reply command and POST /api/mail/reply call send_from_mailbox.", "Do not use this to answer Gmail or Microsoft Mail. That is integrations.mailbox op=send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.send_email", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Send Email"}, "do_not_use_when": "Project-scoped user email — use notifications.deliver.", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: send transactional or custom email from ecosystem Mail Hub provider.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "recipe_id": "mcp_notify_channels_v1", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "messaging_send_email", "semantic_input_mode": "inherit_workflow", "summary": "Send email to any address (ecosystem admin). Use template_name + template_data for auth templates.", "title": "Messaging Send Email", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "email_channel_not_configured": "messaging.get_config then messaging.put_config", "forbidden": "auth.get_profile — ecosystem owner required", "invalid_parameters": "Fix template_name, recipient, or template_data", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Project-scoped user email — use notifications.deliver.", "when_to_use": "Ops: send transactional or custom email from ecosystem Mail Hub provider.", "write_mode": null}, {"action": "messaging.get_auth_email_readiness", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.get_auth_email_readiness", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Get Auth Email Readiness"}, "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: verify confirm-email and password-reset can send before go-live.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_get_auth_email_readiness", "semantic_input_mode": "inherit_workflow", "summary": "Probe auth email plane — provider secrets, email_confirmation + password_reset + email_otp templates.", "title": "Messaging Get Auth Email Readiness", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "domain_error": "messaging.test_connection — fix from_address / domain alignment", "email_channel_not_configured": "messaging.put_config — wire provider first", "forbidden": "auth.get_profile — ecosystem owner required", "from_domain_not_verified": "Verify From domain in Resend or change Mail Hub from_address", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_ready": "messaging.get_config then messaging.test_connection", "provider_key_missing": "messaging.put_config — set provider API key / secret", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "test_connection_failed": "messaging.test_connection — fix provider credentials", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: verify confirm-email and password-reset can send before go-live.", "write_mode": null}, {"action": "messaging.put_config", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "intermediate", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.put_config", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Put Config"}, "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: Mail Hub config write via MCP (same as PUT /admin/messaging/config).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_put_config", "semantic_input_mode": "inherit_workflow", "summary": "Update ecosystem messaging config and provider secrets (admin).", "title": "Messaging Put Config", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "Fix channels/templates payload — messaging.get_config for shape"}, "when_to_use": "Ops: Mail Hub config write via MCP (same as PUT /admin/messaging/config).", "write_mode": null}, {"action": "messaging.setup_info", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "Inbound POST /api/mail/inbound/{provider} is not this tool — wire the provider to that URL.", "503 on inbound means in_flight or notify_failed — safe to retry; dedupe prevents duplicate archive."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.setup_info", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Setup Info"}, "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: Resend webhook URLs and env var checklist.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_setup_info", "semantic_input_mode": "inherit_workflow", "summary": "Mail Hub setup checklist, webhook URLs, DNS hints (admin).", "title": "Messaging Setup Info", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: Resend webhook URLs and env var checklist.", "write_mode": null}, {"action": "messaging.ensure_auth_templates", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.ensure_auth_templates", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Ensure Auth Templates"}, "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: seed password-reset and confirm-email templates.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.setup_info", "messaging.get_config", "messaging.put_config", "messaging.test_connection", "messaging.get_auth_email_readiness", "messaging.ensure_auth_templates", "messaging.send_test_email", "messaging.send_email"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_ensure_auth_templates", "semantic_input_mode": "inherit_workflow", "summary": "Merge auth email templates into ecosystem notifications config (admin).", "title": "Messaging Ensure Auth Templates", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: seed password-reset and confirm-email templates.", "write_mode": null}, {"action": "messaging.get_delivery_health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.get_delivery_health", "related_tools": ["messaging.list_recent_deliveries", "messaging.list_suppressions", "messaging.get_config", "messaging.test_connection", "channels.delivery_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Get Delivery Health"}, "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: messaging delivery health snapshot.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.list_recent_deliveries", "messaging.list_suppressions", "messaging.get_config", "messaging.test_connection", "channels.delivery_status"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_get_delivery_health", "semantic_input_mode": "inherit_workflow", "summary": "Messaging ops status snapshot (admin).", "title": "Messaging Get Delivery Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: messaging delivery health snapshot.", "write_mode": null}, {"action": "messaging.list_recent_deliveries", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.list_recent_deliveries", "related_tools": ["messaging.get_delivery_health", "messaging.list_suppressions", "notifications.delivery_status", "channels.delivery_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging List Recent Deliveries"}, "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: recent delivery log rows for triage.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.get_delivery_health", "messaging.list_suppressions", "notifications.delivery_status", "channels.delivery_status"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_list_recent_deliveries", "semantic_input_mode": "inherit_workflow", "summary": "Recent messaging delivery log rows (admin).", "title": "Messaging List Recent Deliveries", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: recent delivery log rows for triage.", "write_mode": null}, {"action": "messaging.list_suppressions", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.list_suppressions", "related_tools": ["messaging.remove_suppression", "messaging.get_delivery_health", "messaging.list_recent_deliveries"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging List Suppressions"}, "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: list bounce/complaint suppressions.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.remove_suppression", "messaging.get_delivery_health", "messaging.list_recent_deliveries"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_list_suppressions", "semantic_input_mode": "inherit_workflow", "summary": "List ecosystem email suppression list (bounces/complaints).", "title": "Messaging List Suppressions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: list bounce/complaint suppressions.", "write_mode": null}, {"action": "messaging.remove_suppression", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send.", "anti_patterns": ["Ecosystem Mail Hub only. Not notifications.deliver and not messaging.mail.send."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.remove_suppression", "mutation_risk": "high", "related_tools": ["messaging.list_suppressions", "messaging.get_delivery_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Remove Suppression"}, "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: unblock email after deliverability fix.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_tools": ["messaging.list_suppressions", "messaging.get_delivery_health"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "low_write", "safe_action": "messaging_remove_suppression", "semantic_input_mode": "inherit_workflow", "summary": "Remove an email from the ecosystem suppression list (admin).", "title": "Messaging Remove Suppression", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — ecosystem owner required", "invalid_parameters": "Valid email address required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "messaging.list_suppressions — email not on list", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login or API key with ecosystem admin caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ops: unblock email after deliverability fix.", "write_mode": null}, {"action": "messaging.mailbox.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not pass another user's id. The session user is the only mailbox this reads.", "anti_patterns": ["Do not pass another user's id. The session user is the only mailbox this reads.", "Gmail and Microsoft Mail are integrations.mailbox, not this tool.", "Not notifications.deliver — tenant or bot-channel notices, not @agentstack.tech threads."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.get", "related_tools": ["messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.claim", "messaging.mailbox.settings.patch", "messaging.inbox.reply", "messaging.mail.send", "channels.route", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Get"}, "do_not_use_when": "Third-party mailbox — integrations.mailbox.oauth_begin.", "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.claim", "messaging.mailbox.settings.patch", "messaging.inbox.reply", "messaging.mail.send", "channels.route", "notifications.list_prefs"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_mailbox_get", "semantic_input_mode": "inherit_workflow", "summary": "Read the signed-in user's @agentstack.tech address, aliases, and notify toggles. Only the mailbox leaf is read. The rest of the profile stays in Postgres.", "title": "Messaging Mailbox Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — session required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Third-party mailbox — integrations.mailbox.oauth_begin.", "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "messaging.mailbox.settings.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Not notifications.deliver — tenant notices, not mailbox toggles.", "anti_patterns": ["Not notifications.deliver — tenant notices, not mailbox toggles.", "Use messaging.mailbox.agent.set for reply_agent_id, not this tool."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.settings.patch", "related_tools": ["messaging.mailbox.get", "channels.route"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Settings Patch"}, "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Same leaf as REST mailbox settings — not Mail Hub admin config.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "channels.route"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_mailbox_settings_patch", "semantic_input_mode": "inherit_workflow", "summary": "Patch notify toggles on the signed-in mailbox: forward_to_canonical, notify_in_app, notify_push, notify_bots.", "title": "Messaging Mailbox Settings Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "Retry; messaging.mailbox.get for current toggles", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Same leaf as REST mailbox settings — not Mail Hub admin config.", "write_mode": null}, {"action": "messaging.mailbox.agent.set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not call messaging.send_email for the reply. The agent uses messaging.inbox.reply.", "anti_patterns": ["Do not call messaging.send_email for the reply. The agent uses messaging.inbox.reply.", "An empty agent_id turns the gate off. It does not delete the mailbox.", "Do not wait for a reply from this call. The run starts when a new letter arrives."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.agent.set", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "channels.route", "messaging.inbox.reply", "messaging.mailbox.settings.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Agent Set"}, "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "channels.route", "messaging.inbox.reply", "messaging.mailbox.settings.patch"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_mailbox_agent_set", "semantic_input_mode": "inherit_workflow", "summary": "Save or clear the agent id on the signed-in mailbox. A later letter queues that agent. This call does not start a run.", "title": "Messaging Mailbox Agent Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "invalid_parameters": "agent_id / project_id shape", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "messaging.mailbox.get — retry or clear agent gate", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "messaging.mailbox.claim", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Reserved names such as postmaster are rejected. This does not send a letter.", "anti_patterns": ["Reserved names such as postmaster are rejected. This does not send a letter.", "Not notifications.deliver — tenant or bot-channel notices, not @agentstack.tech threads.", "messaging.send_email — ecosystem admin Mail Hub only."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.claim", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mail.send"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Claim"}, "do_not_use_when": "Send or reply — claim first, then mail.send or inbox.reply.", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mail.send"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_mailbox_claim", "semantic_input_mode": "inherit_workflow", "summary": "Claim local@agentstack.tech for the signed-in user.", "title": "Messaging Mailbox Claim", "when_blocked": {"address_taken": "messaging.mailbox.get — pick another local part or release existing claim", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "invalid_parameters": "local part 2–32 chars, letter start", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Send or reply — claim first, then mail.send or inbox.reply.", "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "messaging.project_mailbox.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Not the signed-in user's primary_address — use messaging.mailbox.get.", "anti_patterns": ["Not the signed-in user's primary_address — use messaging.mailbox.get.", "integrations.mailbox — Gmail/Microsoft OAuth, not @agentstack.tech project slice."], "capability_descriptor": {"complexity": "intermediate", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.messaging.gen1"], "id": "messaging.project_mailbox.get", "related_tools": ["messaging.project_mailbox.claim", "messaging.mailbox.get"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Messaging Project Mailbox Get"}, "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Before claim or when routing inbound mail to project recipients.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.project_mailbox.claim", "messaging.mailbox.get"], "required_cap": "project_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_project_mailbox_get", "semantic_input_mode": "inherit_workflow", "summary": "Read the project's shared @agentstack.tech address from the project 8DNA mailbox leaf. REST parity: GET /api/projects/{project_id}/mail/mailbox.", "title": "Messaging Project Mailbox Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "projects.get_users — project_read on workspace", "invalid_project": "Bind context.project_id or pass project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before claim or when routing inbound mail to project recipients.", "write_mode": null}, {"action": "messaging.project_mailbox.claim", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Not for user primary_address — use messaging.mailbox.claim.", "anti_patterns": ["Not for user primary_address — use messaging.mailbox.claim."], "capability_descriptor": {"complexity": "intermediate", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.messaging.gen1"], "id": "messaging.project_mailbox.claim", "related_tools": ["messaging.project_mailbox.get", "messaging.mailbox.claim", "messaging.inbox.list"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Messaging Project Mailbox Claim"}, "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Project admin sets a shared inbound address for the project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.project_mailbox.get", "messaging.mailbox.claim", "messaging.inbox.list"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_project_mailbox_claim", "semantic_input_mode": "inherit_workflow", "summary": "Claim local@agentstack.tech on the project slice (8DNA data.mailbox). REST parity: POST /api/projects/{project_id}/mail/mailbox. Requires project_admin; recipients receive fanout copies in their user ", "title": "Messaging Project Mailbox Claim", "when_blocked": {"address_taken": "messaging.project_mailbox.get — pick another local or another project", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project_admin on context.project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Project admin sets a shared inbound address for the project.", "write_mode": null}, {"action": "messaging.mailbox.alias.add", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not copy the primary address into aliases.", "anti_patterns": ["Do not copy the primary address into aliases."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.alias.add", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Alias Add"}, "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.get"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_mailbox_alias_add", "semantic_input_mode": "inherit_workflow", "summary": "Add one alias on the signed-in mailbox. Cap is 5.", "title": "Messaging Mailbox Alias Add", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "messaging.mailbox.get — alias cap or invalid local part", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "messaging.mailbox.alias.remove", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not remove the primary address. This does not delete the mailbox.", "anti_patterns": ["Do not remove the primary address. This does not delete the mailbox."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mailbox.alias.remove", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mailbox Alias Remove"}, "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.get"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_mailbox_alias_remove", "semantic_input_mode": "inherit_workflow", "summary": "Remove one alias from the signed-in mailbox.", "title": "Messaging Mailbox Alias Remove", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "messaging.mailbox.get — alias not on mailbox", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "Retry; cannot remove primary address", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "messaging.inbox.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not expect html_body. Open messaging.inbox.get for text.", "anti_patterns": ["Do not expect html_body. Open messaging.inbox.get for text.", "Not the Fabric bell dropdown — notifications.inbox_list for hosted notification cards."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.inbox.list", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.inbox.reply", "notifications.inbox_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Inbox List"}, "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["messaging.inbox.get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.inbox.reply", "notifications.inbox_list"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_inbox_list", "semantic_input_mode": "inherit_workflow", "summary": "List inbox cards for the signed-in user. Bodies are not included.", "title": "Messaging Inbox List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "invalid_parameters": "limit must be integer 1–20", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "messaging.inbox.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not expect html_body. The body is plain text.", "anti_patterns": ["Do not expect html_body. The body is plain text."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.inbox.get", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.inbox.reply"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Inbox Get"}, "domain_title": "Messaging MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.inbox.reply"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "messaging_inbox_get", "semantic_input_mode": "inherit_workflow", "summary": "Read one thread as text for the signed-in user. messages are the oldest 50.", "title": "Messaging Inbox Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "messaging.inbox.list — pick a valid thread_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "messaging.inbox.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Does not delete the thread or bodies in sqlite.", "anti_patterns": ["Does not delete the thread or bodies in sqlite."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.inbox.patch", "related_tools": ["messaging.inbox.list", "messaging.inbox.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Inbox Patch"}, "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Mark threads read without loading bodies.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.inbox.list", "messaging.inbox.get"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_inbox_patch", "semantic_input_mode": "inherit_workflow", "summary": "Mark one inbox thread read or unread for the signed-in user.", "title": "Messaging Inbox Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — signed-in user only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "messaging.inbox.list then messaging.inbox.get", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mark threads read without loading bodies.", "write_mode": null}, {"action": "messaging.inbox.reply", "aliases": ["messaging.reply"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Not messaging.send_email. That admin tool does not use the user's From address.", "anti_patterns": ["Not messaging.send_email. That admin tool does not use the user's From address.", "Do not assume the From address is @agentstack.tech when the latest letter came from a connected mailbox.", "Not notifications.deliver — tenant or bot-channel notices, not @agentstack.tech threads."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.inbox.reply", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.agent.set", "integrations.mailbox", "notifications.deliver", "channels.resolve_routing"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Inbox Reply"}, "do_not_use_when": "Project notice to prefs/bots — notifications.deliver.", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "messaging.inbox.list", "messaging.inbox.get", "messaging.mailbox.agent.set", "integrations.mailbox", "notifications.deliver", "channels.resolve_routing"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_inbox_reply", "semantic_input_mode": "inherit_workflow", "summary": "Reply to the latest noticed letter. A connected Gmail or Microsoft mailbox sends when that letter has a connection id. Otherwise the letter goes out from the signed-in @agentstack.tech address.", "title": "Messaging Inbox Reply", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing": "messaging.inbox.list — no thread to reply to", "not_found": "messaging.inbox.list then messaging.inbox.get — valid thread_id required", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "Retry; if persistent, messaging.mailbox.get and support channel", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Project notice to prefs/bots — notifications.deliver.", "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}, {"action": "messaging.mail.send", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not pass From. The server sets primary_address.", "anti_patterns": ["Do not pass From. The server sets primary_address.", "Do not use this for Gmail. That is integrations.mailbox op=send.", "Not notifications.deliver — tenant or bot-channel notices, not @agentstack.tech threads."], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.mail.send", "related_tools": ["messaging.mailbox.get", "messaging.mailbox.claim", "messaging.inbox.reply"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Messaging Mail Send"}, "do_not_use_when": "Tenant blast to bot channels — notifications.deliver.", "domain_title": "Messaging MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admi…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "owner_gene": "core.messaging.delivery.gen1", "plane": "Admin SMTP: messaging.send_email. Project notices: notifications.deliver. OS push: notifications.send_push.", "plane_chooser": "Admin Mail Hub: messaging.send_email / put_config / test_connection — ecosystem owner. User mailbox: messaging.mailbox.get / inbox.list — session user only. Tenant notices: notifications.deliver — not messaging.send_email. Gmail/Outlook: integrations.mailbox — not messaging.mailbox.", "related_tools": ["messaging.mailbox.get", "messaging.mailbox.claim", "messaging.inbox.reply"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "messaging_mail_send", "semantic_input_mode": "inherit_workflow", "summary": "Send one letter from the signed-in @agentstack.tech address.", "title": "Messaging Mail Send", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "User mailbox only — not messaging.send_email admin blast", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "store_failed": "messaging.mailbox.get — claim address before send", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Tenant blast to bot channels — notifications.deliver.", "when_to_use": "Signed-in user mailbox on @agentstack.tech. user_id comes from the session. This does not send admin Mail Hub mail.", "write_mode": null}], "notifications": [{"action": "notifications.subscribe_push", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.subscribe_push", "related_tools": ["notifications.send_push", "notifications.list_prefs", "web_push.get_health", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Subscribe Push"}, "domain_title": "Notifications MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "VAPID setup hint; client still calls PushManager.subscribe.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.send_push", "notifications.list_prefs", "web_push.get_health", "notifications.deliver"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "notifications_subscribe_push", "semantic_input_mode": "inherit_workflow", "summary": "Returns VAPID status; browser must still call PushManager.subscribe.", "title": "Notifications Subscribe Push", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — VAPID hint is per signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "VAPID setup hint; client still calls PushManager.subscribe.", "write_mode": null}, {"action": "notifications.send_push", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.send_push", "related_tools": ["notifications.subscribe_push", "notifications.list_prefs", "web_push.get_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Send Push"}, "domain_title": "Notifications MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Enqueue OS web push — prefer over deprecated notifications.send.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.subscribe_push", "notifications.list_prefs", "web_push.get_health"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "notifications_send_push", "semantic_input_mode": "inherit_workflow", "summary": "Enqueue OS web push for a user (self or admin).", "title": "Notifications Send Push", "when_blocked": {"channel_disabled": "notifications.subscribe_push — VAPID not configured or push prefs off", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "quota": "buffs.get_effective_limits — OS push caps; not notification deliver quota", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Enqueue OS web push — prefer over deprecated notifications.send.", "write_mode": null}, {"action": "notifications.deliver", "aliases": ["integrations.notify", "notifications.notify", "notifications.send", "notifications.send_bot", "notifications.send_channel", "notifications.send_message", "notifications.send_notification"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Not a reply on the user's @agentstack.tech thread — messaging.inbox.reply.", "anti_patterns": ["Not a reply on the user's @agentstack.tech thread — messaging.inbox.reply.", "Not outbound personal mail from the claimed address — messaging.mail.send.", "Not claiming an address — messaging.mailbox.claim."], "capability_descriptor": {"complexity": "intermediate", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "notifications.deliver", "related_tools": ["channels.resolve_routing", "notifications.list_prefs", "channels.deliver", "channels.list_identities", "channels.delivery_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Deliver"}, "do_not_use_when": "Standalone deliver does not emit dependency_error — that code is for batch DAG upstream failures only. Use channel_not_linked / channels.create_bind_link.", "domain_title": "Notifications MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"attachments": [], "category": "example_string", "channels": [], "correlation_key": "example_string", "dry_run": true, "message": "example_string", "project_id": 123, "source_agent_id": "example_string", "title": "example_string", "user_id": 123}, "example_request": {"action": "notifications.deliver", "params": {"attachments": [], "category": "example_string", "channels": [], "correlation_key": "example_string", "dry_run": true, "message": "example_string", "project_id": 123, "source_agent_id": "example_string", "title": "example_string", "user_id": 123}}, "examples": [{"name": "Eligibility dry_run (in_app)", "request": {"category": "security", "channels": ["in_app"], "dry_run": true, "message": "No send — dry_run only.", "title": "Reachability check"}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Explicit channel list + title/message. deferred status counts as success (quiet hours / digest). Te…", "kind": "mcp_domain", "mutation_kind": "entity", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.resolve_routing", "notifications.list_prefs", "channels.deliver", "channels.list_identities", "channels.delivery_status"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "external_side_effect", "rollback": [], "safe_action": "notifications_deliver", "semantic_input_mode": "inherit_workflow", "summary": "Send one notice on email, in-app, web push, webhook, or a bound bot channel (telegram, max, whatsapp, instagram, slack, discord, sms).", "title": "Notifications Deliver", "verification": ["notifications.delivery_status"], "verify": [{"action": "notifications.delivery_status", "predicate": "named resource is visible"}], "when_blocked": {"channel_disabled": "notifications.list_prefs — user turned channel off or Mail Hub email is disabled", "channel_not_linked": "channels.create_bind_link — user must complete Telegram bind or /login in bot; not a batch DAG dependency_error", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dependency_error": "Batch DAG: fix the first failed step_id or poll verification_action — not a Telegram binding bug. Standalone deliver: channels.list_identities + user /login in bot for external_user_id", "digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — deliver to another user_id only as project admin", "handle_required": "This key owns several handles. Pass source_agent_id or start the text with @handle.", "invalid_parameters": "title or message required; channels[] via normalize_deliver_channels — discovery.describe. handle_required when this key owns several handles and neither source_agent_id nor @handle is set. Quote-reply on the sent turn routes to the stamped mailbox. Leading @handle on text stamps author only; @OtherHandle in the body wakes that mailbox webhook. Cross-agent mailbox writes use bots.bus.deliver to_handle.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel_target": "bots.list + user /login in the bot — deliver skips channels without external_user_id", "no_eligible_channels": "notifications.list_prefs + notifications.update_prefs — transport/prefs intersection empty; dry_run:true to preview skip_reasons before send", "operation_failed": "channels.delivery_status with correlation_key — provider rejected; check bot token and channel id", "orchestration_step_violation": "preflight.check then notifications.deliver — or follow packet.next_action / inverse_resume; do not call deliver outside the current workflow step allow-list", "prefs_filter_failed": "notifications.list_prefs — corrupt prefs leaf; list_prefs re-seeds plane or fix JSON via update_prefs", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "quota": "buffs.get_effective_limits — project notice caps before retry; not rag_embed_quota or storage_quota", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "source_agent_id or @handle must be a mailbox bound to this API key", "source_not_enrolled": "channels.enroll_source after channels.list_identities — source not enrolled for user", "template_missing": "projects.config.notifications.templates — pass title/message or notifications.register_category with a matching template name", "unauthorized": "auth.get_profile — signed-in user or service key with notify caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Standalone deliver does not emit dependency_error — that code is for batch DAG upstream failures only. Use channel_not_linked / channels.create_bind_link.", "when_to_use": "Explicit channel list + title/message. deferred status counts as success (quiet hours / digest). Telegram: channels.list_identities — user must /login in bot. dependency_error in a batch means fix an", "write_mode": null}, {"action": "notifications.cancel_push", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.cancel_push", "related_tools": ["notifications.send_push", "web_push.get_health", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Cancel Push"}, "domain_title": "Notifications MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Cancel pending push by correlation_key prefix.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.send_push", "web_push.get_health", "notifications.deliver"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "notifications_cancel_push", "semantic_input_mode": "inherit_workflow", "summary": "Cancel pending push items by correlation key prefix.", "title": "Notifications Cancel Push", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "correlation_key required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — cancel push is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cancel pending push by correlation_key prefix.", "write_mode": null}, {"action": "notifications.list_prefs", "aliases": ["channels.list_prefs", "notifications.config", "notifications.configure"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.list_prefs", "related_tools": ["notifications.update_prefs", "notifications.register_category"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications List Prefs"}, "domain_title": "Notifications MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Read messenger + delivery matrix", "request": {}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Read messenger + category×channel matrix before update_prefs.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.update_prefs", "notifications.register_category"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "notifications_list_prefs", "semantic_input_mode": "inherit_workflow", "summary": "Messenger prefs plus category×channel matrix and enrolled bot sources.", "title": "Notifications List Prefs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — prefs snapshot requires signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read messenger + category×channel matrix before update_prefs.", "write_mode": null}, {"action": "notifications.update_prefs", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not send a full prefs object to flip one checkbox; that replaces the matrix.", "anti_patterns": ["Do not send a full prefs object to flip one checkbox; that replaces the matrix.", "Do not use this to enroll Telegram. Call channels.enroll_source first.", "Do not enable work_graph when the user only asked for mail."], "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.update_prefs", "mutation_risk": "low", "related_tools": ["notifications.list_prefs", "channels.enroll_source", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Update Prefs"}, "domain_title": "Notifications MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Patch notification prefs matrix for signed-in user.", "kind": "mcp_domain", "mutation_kind": "entity", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.list_prefs", "channels.enroll_source", "notifications.deliver"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "notifications_update_prefs", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch messenger prefs and/or category×channel notification matrix. One channel: patch {category, channel, enabled} calls set_category_channel and does not replace the rest of the matrix. work_graph + ", "title": "Notifications Update Prefs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "patch object required — {category, channel, enabled} for one cell", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — prefs patch requires signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "notifications.list_prefs — fix category/channel names or messenger keys"}, "when_to_use": "Patch notification prefs matrix for signed-in user.", "write_mode": null}, {"action": "notifications.register_category", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.register_category", "related_tools": ["notifications.list_prefs", "notifications.send_push", "notifications.update_prefs", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Register Category"}, "domain_title": "Notifications MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Register push category id before send_push campaigns.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.list_prefs", "notifications.send_push", "notifications.update_prefs", "notifications.deliver"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "notifications_register_category", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Register a logical push category in user messenger prefs (persisted).", "title": "Notifications Register Category", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "id and title required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — category registration is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "messenger_prefs_update rejected — compare notifications.list_prefs shape"}, "when_to_use": "Register push category id before send_push campaigns.", "write_mode": null}, {"action": "notifications.inbox_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Fabric bell inbox — not @agentstack.tech email threads.", "anti_patterns": ["Fabric bell inbox — not @agentstack.tech email threads.", "Use messaging.inbox.list and messaging.inbox.get for the Mail Hub."], "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.inbox_list", "related_tools": ["notifications.mark_read", "messaging.inbox.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Inbox List"}, "domain_title": "Notifications MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Hosted bell dropdown and settings inbox.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.mark_read", "messaging.inbox.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "notifications_inbox_list", "semantic_input_mode": "inherit_workflow", "summary": "List Fabric in-app inbox rows for a project (parity with GET /api/notifications/{project_id}).", "title": "Notifications Inbox List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id required in params or context", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — inbox list requires signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hosted bell dropdown and settings inbox.", "write_mode": null}, {"action": "notifications.delete_source", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.delete_source", "related_tools": ["channels.delete_source", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Delete Source"}, "domain_title": "Notifications MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Profile unenroll — parity with channels.delete_source.", "kind": "mcp_domain", "mutation_kind": "entity", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.delete_source", "notifications.list_prefs"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "notifications_delete_source", "semantic_input_mode": "inherit_workflow", "summary": "Remove a notification source by id (parity with DELETE notification-sources).", "title": "Notifications Delete Source", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "source_id required — notifications.list_prefs → prefs.delivery.sources", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — source delete is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Profile unenroll — parity with channels.delete_source.", "write_mode": null}, {"action": "notifications.delivery_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": true, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "notifications.delivery_status", "related_tools": ["channels.delivery_status", "notifications.deliver"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Delivery Status"}, "domain_title": "Notifications MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "After deliver or test ping — same leaf as REST GET /users/me/delivery-status.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.delivery_status", "notifications.deliver"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "notifications_delivery_status", "semantic_input_mode": "inherit_workflow", "summary": "Delivery receipts for a correlation_key (user DNA ring buffer).", "title": "Notifications Delivery Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "auth.get_profile — query another user_id only as admin", "invalid_parameters": "correlation_key required — pass key from notifications.deliver result", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "No receipts yet — deliver first or check correlation_key spelling", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After deliver or test ping — same leaf as REST GET /users/me/delivery-status.", "write_mode": null}, {"action": "notifications.job_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "notifications.job_status", "related_tools": ["notifications.delivery_status", "bots.bus.send", "discovery.job_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Job Status"}, "domain_title": "Notifications MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Poll outbound_job_id after deliver or bots.bus.send.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.delivery_status", "bots.bus.send", "discovery.job_status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "notifications_job_status", "semantic_input_mode": "inherit_workflow", "summary": "Status of one outbound or deliver work item by job_id.", "title": "Notifications Job Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "job_id required — use outbound_job_id from bots.bus.send/staff_reply or deliver result", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "job_found=false — wrong id or retention expired; use notifications.delivery_status for correlation_key proof", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll outbound_job_id after deliver or bots.bus.send.", "write_mode": null}, {"action": "notifications.send_with_fallback", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Not a reply on the user's @agentstack.tech thread — messaging.inbox.reply.", "anti_patterns": ["Not a reply on the user's @agentstack.tech thread — messaging.inbox.reply.", "Not outbound personal mail from the claimed address — messaging.mail.send.", "Not ecosystem admin SMTP blast — messaging.send_email."], "capability_descriptor": {"complexity": "intermediate", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "notifications.send_with_fallback", "related_tools": ["notifications.deliver", "channels.resolve_routing", "notifications.delivery_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Send With Fallback"}, "domain_title": "Notifications MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "OTP and critical alerts when primary channel may be offline.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.deliver", "channels.resolve_routing", "notifications.delivery_status"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "external_side_effect", "safe_action": "notifications_send_with_fallback", "semantic_input_mode": "inherit_workflow", "summary": "Deliver with category fallback chain (security/auth/billing) and in_app escalation when all channels fail. Prefs are read on the server; the profile is not returned.", "title": "Notifications Send With Fallback", "when_blocked": {"channel_disabled": "notifications.list_prefs — user turned channel off or Mail Hub email is disabled", "channel_not_linked": "channels.create_bind_link — user must complete Telegram bind or /login in bot; not a batch DAG dependency_error", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dependency_error": "Batch DAG: fix the first failed step_id or poll verification_action — not a Telegram binding bug. Standalone deliver: channels.list_identities + user /login in bot for external_user_id", "digest_enqueue_failed": "channels.digest_depth then channels.flush_digest — digest_mode batch queue failed to enqueue", "forbidden": "auth.get_profile — deliver to another user_id only as project admin", "handle_required": "This key owns several handles. Pass source_agent_id or start the text with @handle.", "invalid_parameters": "title or message required; channels[] via normalize_deliver_channels — discovery.describe. handle_required when this key owns several handles and neither source_agent_id nor @handle is set. Quote-reply on the sent turn routes to the stamped mailbox. Leading @handle on text stamps author only; @OtherHandle in the body wakes that mailbox webhook. Cross-agent mailbox writes use bots.bus.deliver to_handle.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "no_channel_target": "bots.list + user /login in the bot — deliver skips channels without external_user_id", "no_eligible_channels": "notifications.list_prefs + notifications.update_prefs — transport/prefs intersection empty; dry_run:true to preview skip_reasons before send", "operation_failed": "channels.delivery_status with correlation_key — provider rejected; check bot token and channel id", "orchestration_step_violation": "preflight.check then notifications.deliver — or follow packet.next_action / inverse_resume; do not call deliver outside the current workflow step allow-list", "prefs_filter_failed": "notifications.list_prefs — corrupt prefs leaf; list_prefs re-seeds plane or fix JSON via update_prefs", "quiet_hours_enqueue_failed": "channels.digest_depth — quiet-hours defer queue could not enqueue; retry later or channels.flush_digest after fixing work queue", "quota": "buffs.get_effective_limits — project notice caps before retry; not rag_embed_quota or storage_quota", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "source_agent_forbidden": "source_agent_id or @handle must be a mailbox bound to this API key", "source_not_enrolled": "channels.enroll_source after channels.list_identities — source not enrolled for user", "template_missing": "projects.config.notifications.templates — pass title/message or notifications.register_category with a matching template name", "unauthorized": "auth.get_profile — signed-in user or service key with notify caps", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "OTP and critical alerts when primary channel may be offline.", "write_mode": null}, {"action": "notifications.mark_read", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.mark_read", "related_tools": ["notifications.inbox_list", "messaging.inbox.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Notifications Mark Read"}, "domain_title": "Notifications MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Hosted bell mark-as-read.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.inbox_list", "messaging.inbox.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "notifications_mark_read", "semantic_input_mode": "inherit_workflow", "summary": "Mark one project inbox notification as read (parity with PATCH …/read).", "title": "Notifications Mark Read", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id and notification_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — mark read is user-scoped", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hosted bell mark-as-read.", "write_mode": null}], "operators": [{"action": "operators.destructive_consent.begin", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "operators", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.operators.gen1"], "id": "operators.destructive_consent.begin", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Operators Destructive Consent Begin"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Before projects.delete_project, storage.delete_file, or other destructive MCP.", "mutation_kind": "none", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "operators_destructive_consent_begin", "semantic_input_mode": "inherit_workflow", "summary": "Register a human gate for a destructive MCP step. Pair with bots.bus.ask (gate_id in message). After owner taps Yes, call operators.destructive_consent.grant then re-execute the destructive action wit", "title": "Operators Destructive Consent Begin", "when_to_use": "Before projects.delete_project, storage.delete_file, or other destructive MCP.", "write_mode": null}, {"action": "operators.destructive_consent.grant", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "operators", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.operators.gen1"], "id": "operators.destructive_consent.grant", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Operators Destructive Consent Grant"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "After owner answered Yes on bots.bus.ask for the same gate_id.", "mutation_kind": "entity", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "operators_destructive_consent_grant", "semantic_input_mode": "inherit_workflow", "summary": "Mark owner destructive consent granted after Telegram bus Yes.", "title": "Operators Destructive Consent Grant", "when_to_use": "After owner answered Yes on bots.bus.ask for the same gate_id.", "write_mode": null}], "organelle": [{"action": "organelle.execute", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "organelle", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.fabric.organelle_descriptors.gen1", "shared.organelles.gen1"], "id": "organelle.execute", "mutation_risk": "low", "related_tools": ["storage.list_files", "storage.delete_file", "organelle.storage.meta", "organelle.work_queue.meta"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Execute organelle operation"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Call a registered organelle op through the single dispatch bridge.", "mutation_kind": "none", "related_tools": ["storage.list_files", "storage.delete_file", "organelle.storage.meta", "organelle.work_queue.meta"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "organelle_execute", "semantic_input_mode": "inherit_workflow", "summary": "Invoke a registered organelle op via dispatch (ring_pool / cell_store today; storage & work_queue via related tools).", "title": "Execute organelle operation", "when_to_use": "Call a registered organelle op through the single dispatch bridge.", "write_mode": null}], "payments": [{"action": "payments.create", "aliases": ["payments.create_payment"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not use payments.create for wallet deposit — wallets.deposit moves internal balance.", "anti_patterns": ["Do not use payments.create for wallet deposit — wallets.deposit moves internal balance.", "Do not call payments.create intent=currency_pack on tenant PID without shop.checkout.create order_id.", "Hosted /s/ buyers: shop.checkout.create — not bare currency_pack metadata grants."], "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "execution_class": "cheap", "genetic_tags": ["core.mcp.payments.gen1", "core.commerce.soft_currency_grant.gen1"], "id": "payments.create", "mutation_risk": "low", "related_tools": ["payments.get", "payments.get_balance", "payments.list_transactions"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments Create"}, "commerce_atoms": {"CHECKOUT_TIER_GATE": "payments.create blocked by feature gate — buffs.get_effective_limits; payments.get_balance and payments.list_methods before retry.", "COMMERCE_BUFFS_LINK": "Tenant subscription checkout auto-grants via webhook/C24 — not buffs.apply_buff after payments.create.", "COMMERCE_SOFT_CURRENCY": "Hosted /s/{pid}/ game IAP: shop.products.list → shop.checkout.create (server price). Operator/direct: payments.create intent=currency_pack with metadata.order_id when bound. Not wallets.deposit or commerce.participant.grant_holding for buyers.", "WALLET_VS_CHECKOUT": "Wallet moves: wallets.deposit / wallets.transfer. Hosted IAP checkout: shop.checkout.create. AgentPay card/treasury: payments.create."}, "do_not_use_when": "Not buyer-facing IAP on /s/{pid}/ — use shop.checkout.create. Tenant subscription checkout auto-grants via webhook/C24 — not buffs.apply_buff after create. Hosted /s/ game IAP: shop.checkout.create only — not bare payments.create currency_pack. Internal bind after checkout may carry metadata.order_id + server grant_amount (PAY-01). Platform operator (PID=1): buffs.grant_subscription. Tenant manual (PID>1, write): buffs.grant_tenant_subscription. Tenant paid: webhook/C24 auto-grant. Inventory: commerce.participant.grant_holding.", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Creates AgentPay charge; idempotency_key enables safe replay — poll payments.get until wallet_credit=ok.", "execution_class": "cheap", "kind": "mutate", "mutates_when": "always", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"amount": 100.0, "buyer_project_id": 123, "checkout_session_id": "example_string", "currency": "USD", "description": "Payment for premium subscription", "destination_wallet": "example_string", "fail_url": "example_string", "idempotency_key": "example_string", "intent": "sale", "metadata": {}, "payment_method": "card", "recipient_project_id": 123, "scope": "user", "seller_user_id": 123, "success_url": "example_string"}, "example_request": {"action": "payments.create", "params": {"amount": 100.0, "buyer_project_id": 123, "checkout_session_id": "example_string", "currency": "USD", "description": "Payment for premium subscription", "destination_wallet": "example_string", "fail_url": "example_string", "idempotency_key": "example_string", "intent": "sale", "metadata": {}, "payment_method": "card", "recipient_project_id": 123, "scope": "user", "seller_user_id": 123, "success_url": "example_string"}}, "examples": [{"description": "Create a payment with minimal required information", "name": "Create a simple payment", "request": {"amount": 100.0, "currency": "USD", "description": "Payment for premium subscription", "payment_method": "card"}, "response": {"data": {"amount": 100.0, "created_at": "2025-01-20T10:00:00Z", "currency": "USD", "description": "Payment for premium subscription", "payment_id": "550e8400-e29b-41d4-a716-446655440000", "status": "pending"}, "success": true}}, {"description": "Create a payment with a specific payment method", "name": "Create payment with specific method", "request": {"amount": 250.5, "currency": "EUR", "description": "Monthly service fee", "payment_method": "card"}, "response": {"data": {"amount": 250.5, "created_at": "2025-01-20T10:00:00Z", "currency": "EUR", "description": "Monthly service fee", "payment_id": "550e8400-e29b-41d4-a716-446655440001", "status": "pending"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "AgentPay card/treasury — not hosted game IAP (shop.checkout.create). Poll payments.get until wallet…", "listable": false, "mutation_kind": "entity", "navigation": ["shop.products.list", "shop.checkout.create", "payments.get"], "onboarding_tier": "domain_playbook", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Fiat is AgentPay. On-chain AGNT is agentnet.balance, not a second checkout. An empty balance is valid. Do not open a second checkout.", "receipt_rule": "Poll payments.get until wallet_credit=ok; for currency_pack also soft_currency_grant.status=ok.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.get", "payments.get_balance", "payments.list_transactions"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "rollback": [], "safe_action": "payments_create", "semantic_input_mode": "inherit_workflow", "summary": "Create a new payment transaction.", "title": "Payments Create", "tool_chains": ["payment_to_subscription", "trial_to_paid_tier", "trial_to_premium"], "verification": ["payments.get"], "verify": [{"action": "payments.get", "predicate": "named resource is visible"}], "when_blocked": {"catalog_auth_required": "IAP catalog is owner-only — auth.get_profile then shop.products.list; or enable iap_public_catalog in commerce DNA for hosted buyers", "client_amount_forbidden": "Omit amount/amount_minor — server prices from SKU; shop.checkout.create or payments metadata from catalog", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "payments.get_balance then retry same idempotency_key; diagnose if repeats", "feature_gate_denied": "buffs.get_effective_limits — plan tier blocks checkout; upgrade_url or buffs grant", "forbidden_for_visitor": "Hosted visitor — provision auth or use shop.checkout.create for IAP; not wallets.deposit from anon cookie", "iap_order_required": "shop.checkout.create — order_id only on currency_pack from that checkout; intent sale with metadata.order_id is rejected (iap_order_required)", "idempotency_conflict": "Same idempotency_key with different amount, currency, or intent — use a new key", "insufficient_permissions": "project membership read + payments cap for scope=user buyer checkout; project write only for scope=project treasury charges", "invalid_amount": "payments.get_balance — amount must be positive major units", "invalid_currency": "payments.list_methods — currency code from supported methods", "invalid_order": "IAP order row missing price — shop.checkout.create again", "invalid_parameters": "payments.get_balance first — amount, currency, method_id required for AgentPay", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "order_already_fulfilled": "shop.orders.get — do not replay payments.create for fulfilled orders", "order_amount_mismatch": "currency_pack with metadata.order_id — amount must match shop.checkout.create server price (shared.commerce.iap_payment_bind)", "order_currency_mismatch": "currency must match IAP order snapshot from shop.checkout.create", "order_not_found": "shop.checkout.create first — metadata.order_id must be a live IAP order", "order_not_payable": "shop.orders.get — order status must be pending_payment or created", "order_project_mismatch": "recipient_project_id must match order project_id — context.project_id for tenant IAP", "order_sku_mismatch": "metadata.sku_id must match order sku_id from checkout", "order_user_mismatch": "Payer user_id must match order.user_id — auth.get_profile", "payment_create_in_progress": "Another create is in flight for this idempotency_key — poll payments.get or wait", "payment_order_mismatch": "payments.create metadata.order_id must match checkout order_id before shop.fulfill", "preferred_method_required": "payments.list_methods — pass preferred_method from catalog", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "apikeys.create with payments in service_caps — operator key lacks payments cap", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "treasury_lane_required": "Tenant treasury sale needs metadata.funding_lane=treasury — personal L0 uses AgentPay recipient", "unsupported_payment_method": "payments.list_methods — pick a method enabled for this PID", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Not buyer-facing IAP on /s/{pid}/ — use shop.checkout.create. Tenant subscription checkout auto-grants via webhook/C24 — not buffs.apply_buff after create. Hosted /s/ game IAP: shop.checkout.create only — not bare payments.create currency_pack. Internal bind after checkout may carry metadata.order_id + server grant_amount (PAY-01). Platform operator (PID=1): buffs.grant_subscription. Tenant manual (PID>1, write): buffs.grant_tenant_subscription. Tenant paid: webhook/C24 auto-grant. Inventory: commerce.participant.grant_holding.", "when_to_use": "AgentPay card/treasury — not hosted game IAP (shop.checkout.create). Poll payments.get until wallet_credit=ok. Tenant currency_pack only with metadata.order_id from shop checkout.", "write_mode": null}, {"action": "payments.list_methods", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "payments.list_methods", "related_tools": ["shop.checkout.create", "shop.products.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments List Methods", "visitor_callable": true}, "do_not_use_when": "AgentPay treasury checkout — hosted visitors use shop.checkout.create on /s/{pid}/.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Visitor-safe card/Pix probe before shop.checkout.create.", "listable": false, "mutation_kind": "none", "navigation": ["shop.products.list", "shop.checkout.create", "payments.get"], "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["shop.checkout.create", "shop.products.list"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "payments_list_methods", "semantic_input_mode": "inherit_workflow", "summary": "Region-aware checkout methods (card, Pix probe) for hosted IAP UI. Empty methods = no PSP for that currency.", "title": "Payments List Methods", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "AgentPay treasury checkout — hosted visitors use shop.checkout.create on /s/{pid}/.", "when_to_use": "Visitor-safe card/Pix probe before shop.checkout.create.", "write_mode": null}, {"action": "payments.get", "aliases": ["payments.get_status", "payments.status"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Hosted /s/ game IAP: poll shop.orders.get and checkout resume BFF — not payments.get.", "anti_patterns": ["Hosted /s/ game IAP: poll shop.orders.get and checkout resume BFF — not payments.get.", "Do not treat wallet_credit=ok alone as fulfilled IAP — wait for soft_currency_grant.status=ok (L1)."], "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.payments.gen1", "core.commerce.soft_currency_grant.gen1"], "id": "payments.get", "related_tools": ["payments.refund", "payments.list_transactions", "payments.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments Get"}, "commerce_atoms": {"CHECKOUT_TIER_GATE": "payments.create blocked by feature gate — buffs.get_effective_limits; payments.get_balance and payments.list_methods before retry.", "IAP_PAYMENT_RAILS": "Track A tenant IAP: shop.checkout.create (server price). Track B marketplace: commerce.sell.activate. Track C AgentPay subscriptions: payments.create + webhook. Track D stackscript fuel: payments.create intent stackscript_fuel_pack. See docs/operations/COMMERCE_PAYMENT_RAILS.md.", "SHOP_AGENT_CHECKLIST": "15-step shop/IAP agent checklist — enablement, server price, idempotency, effective_project_id on reads, simulate-only QA. Full text in shop_instruction_atoms.", "WALLET_VS_CHECKOUT": "Wallet moves: wallets.deposit / wallets.transfer. Hosted IAP checkout: shop.checkout.create. AgentPay card/treasury: payments.create."}, "do_not_use_when": "payments.list does not exist — use payments.get_balance or wallets.list", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve complete payment information using payment ID", "name": "Get payment by ID", "request": {"payment_id": "550e8400-e29b-41d4-a716-446655440000"}, "response": {"data": {"amount": 100.0, "created_at": "2025-01-20T10:00:00Z", "currency": "USD", "description": "Payment for premium subscription", "payment_id": "550e8400-e29b-41d4-a716-446655440000", "project_id": 1, "soft_currency_grant": {"amount": "500", "currency_code": "GOO", "status": "ok"}, "status": "completed", "updated_at": "2025-01-20T10:05:00Z", "user_id": 1, "wallet_credit": "ok"}, "success": true}}], "execution_class": "plain_read", "hosted_poll_tool": "shop.orders.get", "instruction_hint": "Operator L1 poll after AgentPay or shop-bound payment_id — wallet_credit=ok then soft_currency_gran…", "listable": false, "mutation_kind": "none", "navigation": ["payments.get_balance", "payments.get", "wallets.list"], "onboarding_tier": "domain_playbook", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Fiat is AgentPay. On-chain AGNT is agentnet.balance, not a second checkout. An empty balance is valid. Do not open a second checkout.", "receipt_rule": "Poll after payments.create. wallet_credit=ok = fiat capture (L0/L2). For GOO/IAP also require soft_currency_grant.status=ok (L1); shop checkout may show wallet_credit first — keep polling until grant ok. Provider redirect ≠ paid.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.refund", "payments.list_transactions", "payments.get_balance"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "payments_get", "semantic_input_mode": "inherit_workflow", "summary": "Payment row by payment_id — status, wallet_credit, soft_currency_grant (IAP L1), amount/currency. Hosted /s/ game buyers: shop.orders.get + checkout resume, not this tool.", "title": "Payments Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project membership with payments:read", "invalid_parameters": "payment_id UUID required — not order slug or asset id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "payment_id from payments.create receipt — payments.list_transactions audit", "payment_not_found": "payments.list_transactions — payment_id from payments.create receipt", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "payments.list does not exist — use payments.get_balance or wallets.list", "when_to_use": "Operator L1 poll after AgentPay or shop-bound payment_id — wallet_credit=ok then soft_currency_grant.status=ok for IAP packs. Hosted /s/ visitors: shop.orders.get + GET /api/commerce/iap/checkout/resu", "write_mode": null}, {"action": "payments.list_transactions", "aliases": ["wallets.list_transactions"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.list_transactions", "related_tools": ["payments.get", "payments.get_balance", "payments.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments List Transactions"}, "commerce_atoms": {"IAP_PAYMENT_RAILS": "Track A tenant IAP: shop.checkout.create (server price). Track B marketplace: commerce.sell.activate. Track C AgentPay subscriptions: payments.create + webhook. Track D stackscript fuel: payments.create intent stackscript_fuel_pack. See docs/operations/COMMERCE_PAYMENT_RAILS.md.", "PAYMENTS_LIST_PAGINATION": "payments.list_transactions: use limit/offset until ledger_scan_capped; then pass next_offset from the prior response. total_is_lower_bound when scan cap applies — do not assume exact total on large ledgers.", "PAYMENTS_NO_LIST": "payments.list does not exist — use payments.get_balance, payments.get, or wallets.list."}, "do_not_use_when": "payments.list does not exist — use payments.get_balance or wallets.list", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Get all payment transactions for the current project", "name": "List transactions for current project", "request": {}, "response": {"data": {"count": 1, "project_id": 1, "transactions": [{"amount": 100.0, "created_at": "2025-01-20T10:00:00Z", "currency": "USD", "description": "Payment for premium subscription", "id": "550e8400-e29b-41d4-a716-446655440000", "method": "wallet", "status": "completed", "transaction_id": "550e8400-e29b-41d4-a716-446655440000", "type": "payment", "updated_at": "2025-01-20T10:00:00Z", "wallet_credit": "ok"}]}, "success": true}}, {"description": "Get all payment transactions for a specific project", "name": "List transactions for specific project", "request": {"project_id": 123}, "response": {"data": {"count": 0, "project_id": 123, "transactions": []}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Ledger audit for the session project — optional user_id/limit/offset. When ledger_scan_capped use n…", "listable": false, "mutation_kind": "none", "navigation": ["payments.get_balance", "payments.get", "wallets.list"], "onboarding_tier": "domain_playbook", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "receipt_rule": "status=completed is not paid until wallet_credit=ok on each row (use id as payment_id).", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.get", "payments.get_balance", "payments.create"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "payments_list_transactions", "semantic_input_mode": "inherit_workflow", "summary": "List all payment transactions for a project.", "title": "Payments List Transactions", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project membership with payments:read", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "context.project_id bound — projects.list for a valid PID", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "payments.list does not exist — use payments.get_balance or wallets.list", "when_to_use": "Ledger audit for the session project — optional user_id/limit/offset. When ledger_scan_capped use next_offset (not blind offset++); total_is_lower_bound when scan cap applies. status=completed is not", "write_mode": null}, {"action": "payments.get_balance", "aliases": ["wallets.get_balance"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.get_balance", "related_tools": ["payments.create", "wallets.list", "wallets.transfer"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Payments Get Balance"}, "commerce_atoms": {"IAP_PAYMENT_RAILS": "Track A tenant IAP: shop.checkout.create (server price). Track B marketplace: commerce.sell.activate. Track C AgentPay subscriptions: payments.create + webhook. Track D stackscript fuel: payments.create intent stackscript_fuel_pack. See docs/operations/COMMERCE_PAYMENT_RAILS.md.", "PAYMENTS_NO_LIST": "payments.list does not exist — use payments.get_balance, payments.get, or wallets.list.", "SHOP_AGENT_CHECKLIST": "15-step shop/IAP agent checklist — enablement, server price, idempotency, effective_project_id on reads, simulate-only QA. Full text in shop_instruction_atoms.", "WALLET_VS_CHECKOUT": "Wallet moves: wallets.deposit / wallets.transfer. Hosted IAP checkout: shop.checkout.create. AgentPay card/treasury: payments.create."}, "do_not_use_when": "payments.list does not exist — use payments.get_balance or wallets.list", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"project_id": 123}, "example_request": {"action": "payments.get_balance", "params": {"project_id": 123}}, "examples": [{"description": "Retrieve current wallet balance for the current project", "name": "Get balance for current project", "request": {}, "response": {"data": {"balance": 1000.0, "currency": "USD", "project_id": 1, "wallet_id": "wal_1"}, "success": true}}, {"description": "Retrieve current wallet balance for a specific project", "name": "Get balance for specific project", "request": {"project_id": 123}, "response": {"data": {"balance": 500.5, "currency": "EUR", "project_id": 123, "wallet_id": "wal_1"}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Read a balance before pay or refund. Personal funds are project 1. Treasury is data.ecosystem.money…", "listable": false, "mutation_kind": "none", "navigation": ["payments.get_balance", "payments.get", "wallets.list"], "onboarding_tier": "domain_playbook", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Fiat is AgentPay. On-chain AGNT is agentnet.balance, not a second checkout. An empty balance is valid. Do not open a second checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.create", "wallets.list", "wallets.transfer"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "payments_get_balance", "semantic_input_mode": "inherit_workflow", "summary": "Get current wallet balance for a project.", "title": "Payments Get Balance", "tool_chains": ["economy_setup"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project membership with payments:read", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "context.project_id bound — projects.list for a valid PID", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "payments cap on API key — widen service_caps or use session auth", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_not_found": "wallets.list — create wallet via wallets.create before reading balance"}, "when_not_to_use": "payments.list does not exist — use payments.get_balance or wallets.list", "when_to_use": "Read a balance before pay or refund. Personal funds are project 1. Treasury is data.ecosystem.money. A tenant wallet is custom currency only.", "write_mode": null}, {"action": "payments.refund", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.refund", "mutation_risk": "low", "related_tools": ["payments.create", "payments.get", "payments.list_transactions"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments Refund"}, "do_not_use_when": "payments.list does not exist — use payments.get_balance or wallets.list", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"amount": 123.45, "idempotency_key": "example_string", "payment_id": "example_string", "reason": "example_string"}, "example_request": {"action": "payments.refund", "params": {"amount": 123.45, "idempotency_key": "example_string", "payment_id": "example_string", "reason": "example_string"}}, "execution_class": "cheap", "idempotency": "Optional idempotency_key replays cached refund; without key, 409 refund_in_progress or duplicate=true after waiter.", "instruction_hint": "Reverse capture after payments.get shows wallet_credit=ok — partial refund ≤ captured major units. …", "listable": false, "mutation_kind": "none", "navigation": ["payments.get_balance", "payments.get", "wallets.list"], "next_actions": ["payments.get"], "onboarding_tier": "domain_playbook", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.create", "payments.get", "payments.list_transactions"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "rollback": [], "safe_action": "payments_refund", "semantic_input_mode": "inherit_workflow", "summary": "Reverse only after payments.get shows wallet_credit=ok. Debit that lane before any card provider.", "title": "Payments Refund", "verification": ["payments.get", "shop.orders.get"], "verify": [{"action": "payments.get", "predicate": "named resource is visible"}, {"action": "shop.orders.get", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "payments write cap + project admin", "invalid_parameters": "payment_id + amount from payments.get status", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "payments.get with payment_id — reverse only after wallet_credit=ok", "payment_not_found": "payments.get with payment_id from checkout receipt", "project_scope_mismatch": "Financial reads honor execute context.project_id over JWT home project when both differ (membership required). Compare effective_project_id, scope_source, jwt_project_aligned on payments.get_balance / list_transactions — bind context.project_id before retry.", "refund_exceeds_capture": "payments.get — partial amount must be ≤ captured major units", "refund_in_progress": "Retry with same idempotency_key or poll payments.get", "refund_not_allowed": "payments.get status — refund only after capture succeeded", "refund_seller_debit_required": "commerce.refund.status — seller debit plane before refund", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "payments.list does not exist — use payments.get_balance or wallets.list", "when_to_use": "Reverse capture after payments.get shows wallet_credit=ok — partial refund ≤ captured major units. Debit the same lane as the credit (L0 project 1 or L2 treasury). Overlapping calls return refund_in_p", "write_mode": null}, {"action": "payments.admin.put_keys", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.admin.put_keys", "related_tools": ["payments.admin.keys_preflight", "payments.list_methods"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments Admin Put Keys"}, "do_not_use_when": "payments.list does not exist — use payments.get_balance or wallets.list", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Ecosystem owner: merge Stripe/Tochka secrets into AgentPay protected.keys.payments. Same body as PU…", "listable": false, "mutation_kind": "entity", "navigation": ["payments.get_balance", "payments.get", "wallets.list"], "onboarding_tier": "domain_playbook", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.admin.keys_preflight", "payments.list_methods"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "payments_admin_put_keys", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem-only: merge Stripe/Tochka secrets into AgentPay protected.keys.payments.", "title": "Payments Admin Put Keys", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Platform ecosystem owner only — auth.get_profile on hub project 1", "insufficient_permissions": "Ecosystem admin — not tenant BYOK project keys", "invalid_parameters": "Pass stripe.secret_key and/or tochka.terminal_id+password objects", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "payments.list does not exist — use payments.get_balance or wallets.list", "when_to_use": "Ecosystem owner: merge Stripe/Tochka secrets into AgentPay protected.keys.payments. Same body as PUT /api/payments/admin/payments/keys.", "write_mode": null}, {"action": "payments.admin.keys_preflight", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.admin.keys_preflight", "related_tools": ["payments.admin.put_keys", "payments.list_methods"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Payments Admin Keys Preflight"}, "do_not_use_when": "payments.list does not exist — use payments.get_balance or wallets.list", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Ecosystem owner: probe stored AgentPay PSP credentials (Stripe balance, Tochka configured) without …", "listable": false, "mutation_kind": "entity", "navigation": ["payments.get_balance", "payments.get", "wallets.list"], "onboarding_tier": "domain_playbook", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.admin.put_keys", "payments.list_methods"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "payments_admin_keys_preflight", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem-only: probe stored AgentPay PSP keys (Stripe Balance.retrieve, Tochka configured).", "title": "Payments Admin Keys Preflight", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "ecosystem_owner_required": "Platform ecosystem owner only — auth.get_profile on hub project 1", "insufficient_permissions": "Ecosystem admin — probes AgentPay slice only", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "payments.list does not exist — use payments.get_balance or wallets.list", "when_to_use": "Ecosystem owner: probe stored AgentPay PSP credentials (Stripe balance, Tochka configured) without creating a charge.", "write_mode": null}], "permissions": [{"action": "permissions.effective", "aliases": ["auth.get_effective_permissions", "capabilities.effective"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "permissions.effective", "related_tools": ["rbac.get_roles", "rbac.check_permission", "buffs.get_effective_limits", "data_access.test_mask", "data_access.check_field"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Permissions Effective"}, "domain_title": "Permissions MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "examples": [{"name": "Hosting deploy L2 probe (slim files)", "request": {"params": {"action": "hosting.deploy_files", "action_params": {"files": [{"bytes": 4096, "path": "docs/index.html"}], "publish": true}, "project_id": 1444}, "tool": "permissions.effective"}, "response": {"data": {"denied_reasons": [], "l2": {"allowed": true, "error_code": null}}, "success": true}}, {"name": "Caps surface without action probe", "request": {"params": {"project_id": 1444}, "tool": "permissions.effective"}, "response": {"data": {"effective_permissions": ["mcp_read", "project_admin"], "role": "owner"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.permissions.gen1"], "instruction_hint": "Before destructive mutation or agents.update path_updates — understand caps and writable paths.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.permissions", "owner_gene": "core.mcp.permissions.gen1", "plane": "Roles: rbac.get_roles.", "plane_chooser": "Field policy is data_access.set_policy, not a new permission table.", "related_tools": ["rbac.get_roles", "rbac.check_permission", "buffs.get_effective_limits", "data_access.test_mask", "data_access.check_field"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "permissions_effective", "semantic_input_mode": "inherit_workflow", "summary": "Effective permission surface: token caps ∩ RBAC role ∩ buff limits. Optional resource + path_prefixes for Field Access Policy write preflight.", "title": "Permissions Effective", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "Bind context.project_id (>0) before permissions.effective.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "l1_denied": "l1.allowed=false — widen key preset (apikeys.create) or OAuth scope; compare l1.missing with credential_plane.granted_service_caps.", "limits_blocked": "buffs limits blocked — see denied_reasons and limits object.", "permission_denied": "L2 blocked — rbac.check_permission(admin) for hosting.deploy_files; stale JWT permissions_bitmap (write without admin) vs owner role — redeploy core bitmap_session_reconcile or reconnect OAuth; if l1.allowed but execute fails, stale session bitmap (deploy rbac_allows DNA fallback).", "rbac_unavailable": "rbac.get_roles failed — retry after membership diagnose.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "Widen service_caps (apikeys.create presets) for action= probe missing tokens.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile session_ready — then permissions.effective with project_id.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before destructive mutation or agents.update path_updates — understand caps and writable paths.", "write_mode": null}], "platform": [{"action": "platform.fleet.get_operator_preset", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.platform.gen1"], "id": "platform.fleet.get_operator_preset", "related_tools": ["platform.fleet.set_operator_preset", "platform.fleet.apply_operator_preset"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Platform Fleet Get Operator Preset"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Admin Fleet tools tab — read platform preset before apply.", "mutation_kind": "none", "related_tools": ["platform.fleet.set_operator_preset", "platform.fleet.apply_operator_preset"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "platform_fleet_get_operator_preset", "semantic_input_mode": "inherit_workflow", "summary": "Load ecosystem operator MCP tool policy preset (ecosystem admin).", "title": "Platform Fleet Get Operator Preset", "when_to_use": "Admin Fleet tools tab — read platform preset before apply.", "write_mode": null}, {"action": "platform.fleet.set_operator_preset", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.platform.gen1"], "id": "platform.fleet.set_operator_preset", "related_tools": ["platform.fleet.get_operator_preset"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Platform Fleet Set Operator Preset"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Admin updates forbidden/approval lists for all orchestrators.", "mutation_kind": "entity", "related_tools": ["platform.fleet.get_operator_preset"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "platform_fleet_set_operator_preset", "semantic_input_mode": "inherit_workflow", "summary": "Save ecosystem operator MCP tool policy preset.", "title": "Platform Fleet Set Operator Preset", "when_to_use": "Admin updates forbidden/approval lists for all orchestrators.", "write_mode": null}, {"action": "platform.fleet.apply_operator_preset", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.platform.gen1"], "id": "platform.fleet.apply_operator_preset", "related_tools": ["platform.fleet.get_operator_preset"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Platform Fleet Apply Operator Preset"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Roll out native-tool * policy to existing orchestrators.", "mutation_kind": "entity", "related_tools": ["platform.fleet.get_operator_preset"], "required_cap": "agents_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "platform_fleet_apply_operator_preset", "semantic_input_mode": "inherit_workflow", "summary": "Apply ecosystem operator preset to project orchestrator agent policies.", "title": "Platform Fleet Apply Operator Preset", "when_to_use": "Roll out native-tool * policy to existing orchestrators.", "write_mode": null}], "preflight": [{"action": "preflight.check", "ai_tips": "Before generation.promote or bulk tenant mutation. Pass semantic_contract or goal_text to probe effect_policy_allowed. For hosting.deploy_files include action_params.publish (default true) so action_risk reflects production_publish without publish_asked. Read action_risk.dry_run_supported — when true, use preflight.simulate or dry_run on the target action instead of a live mutation. read_only_hint means effect probe is read-class. Tenant knowledge batches: simulate_batch_steps (e.g. knowledge.health → knowledge.config.patch) + execution_intent=direct to preview batch_anchor_would_block before agentstack.execute.", "aliases": ["ai_builder.preflight", "authorization.preflight"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "preflight.check", "recovery_blocks": {"work_next_hydrate_failed": {"next_actions": [{"action": "agents.work_next", "params": {"repair": true}}], "reason": "work_next_hydrate_failed"}, "workflow_receipt_context_missing": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_context_missing"}, "workflow_receipt_unbound": {"next_actions": [{"action": "agents.reconcile_binding", "params": {"repair": true}}], "reason": "workflow_receipt_unbound"}}, "related_tools": ["generation.supply_status", "rbac.check_permission", "discovery.describe", "discovery.search", "agents.work_next", "shop.enablement.status", "shop.checkout.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Preflight Check"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "examples": [{"name": "Hosting deploy risk probe (slim files, publish gate)", "request": {"params": {"action": "hosting.deploy_files", "action_params": {"dry_run": true, "files": [{"bytes": 1200, "path": "docs/index.html"}], "publish": true}, "project_id": 1444}, "tool": "preflight.check"}, "response": {"data": {"effect_policy_allowed": true, "fabric_l2": {"allowed": true}}, "success": true}}, {"name": "Slim semantic_contract effect probe", "request": {"params": {"action": "projects.patch_data", "project_id": 1, "semantic_contract": {"effect_constraints": ["read_only"], "fingerprint": "example-fp-read-only", "primary_intent": "analytics.view"}}, "tool": "preflight.check"}, "response": {"data": {"effect_policy_allowed": false, "semantic_contract": {"fingerprint": "example-fp-read-only"}}, "success": true}}, {"name": "Batch anchor preview (simulate_batch_steps)", "request": {"params": {"execution_intent": "direct", "project_id": 1, "simulate_batch_steps": [{"action": "projects.patch_data", "params": {"path": "config.x", "value": 1}}]}, "tool": "preflight.check"}, "response": {"data": {"batch_anchor_would_block": false}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Before generation.promote or bulk tenant mutation. Pass semantic_contract or goal_text to probe eff…", "mutation_kind": "path", "plane": "Before go-live: preflight.check, then checklist.get.", "plane_chooser": "Before go-live: preflight.check, then checklist.get.", "related_tools": ["generation.supply_status", "rbac.check_permission", "discovery.describe", "discovery.search", "agents.work_next", "shop.enablement.status", "shop.checkout.create"], "requires_preflight": false, "risk_class": "read", "safe_action": "preflight_check", "semantic_input_mode": "inherit_workflow", "summary": "Tenant mutation preflight — supply, limits, optional RBAC permission. instruction_slice follows the request locale.", "title": "Preflight Check", "when_blocked": {"auth_required": "Authenticate before preflight — Connect (G-A174), Device Code, or API key; auth.get_profile for session_ready.", "batch_anchor_would_block": "Mutating batch needs options.execution_intent=direct, goal, focus_node_id, or plan_execute_mode — use simulate_batch_actions + execution_intent on preflight.check.", "batch_semantic_anchor_conflict": "Step NL conflicts with batch semantic_contract — align goal_text or use execution_intent=direct.", "batch_semantic_anchor_required": "This step needs a batch semantic anchor — set execution_intent=direct or workflow anchor.", "batch_semantic_goal_mismatch": "Batch goal does not match routed semantic contract.", "budget_exceeded": "Project or user budget cap — buffs.get_effective_limits before retry.", "capability_denied": "Fabric L2 denied — see l2.deny and widen service caps or role.", "conflicting_semantic_anchor": "Conflicting anchors across batch steps — one goal per batch.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "effect_policy_blocked": "Probed action violates goal effect_constraints (read_only / plan_only / no_release).", "fap_denied": "Field access policy denied — adjust FAP or use a role with write access.", "invalid_parameters": "Bind context.project_id and an authenticated user before preflight.check.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "knowledge_collections_unavailable": "buffs.get_effective_limits — knowledge/RAG quota; upgrade plan or reduce collection size.", "permission_denied": "L2 RBAC — permissions.effective action=<tool> (slim action_params, no file bytes); rbac.check_permission(admin) for hosting.deploy_files. If DNA grants but preflight blocks: stale JWT permissions_bitmap — reconnect OAuth or ops bearer with membership hydrate; core needs bitmap_session_reconcile + hydrate_mcp_execute_principal (Wave 7+).", "preflight_batch_internal_error": "Batch preflight could not run — retry once with preflight.check on the same action. If it persists after a backend-only VPS ship, prod substrate may be skewed (hot-sync manifest missing import mates, e.g. shared/mcp/session_readiness.py): -RebuildBackend -DeployComponent backend or complete mcp.prod_matrix_hot_sync, then retry. Not an auth Connect issue until auth.get_profile fails.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "preflight_check_order": "Place preflight.check before mutating steps in agentstack.execute; or list targets in simulate_batch_steps on preflight.check so inline preflight is not duplicated.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_handoff_required": "Bearer or OAuth session_ready before mutation preflight", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_quota_unavailable": "storage.get_quota — project storage cap; delete blobs or upgrade plan.", "unauthorized": "Operator session required — same recovery as auth_required.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "work_next_hydrate_failed": "Work-graph hydrate failed during preflight — run agents.work_next with repair=true and detail=compact before probing mutating shop batches.", "workflow_receipt_context_missing": "Severity warning on preflight when mutation is still allowed. Ops/hosting batches: set options.execution_intent=direct on agentstack.execute — receipt diagnostics are ignored for gate open. Agent playbook: agents.reconcile_binding repair=true; agents.work_next handoff=true detail=compact before mutating.", "workflow_receipt_unbound": "Workflow receipt not bound to session — agents.reconcile_binding repair=true. Ops direct batches may ignore this warning when can_execute_mutation is true."}, "when_to_use": "Before generation.promote or bulk tenant mutation. Pass semantic_contract or goal_text to probe effect_policy_allowed. For hosting.deploy_files include action_params.publish (default true) so action_r", "write_mode": null}, {"action": "preflight.simulate", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "preflight.simulate", "related_tools": ["permissions.effective", "preflight.check", "rbac.check_permission"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Preflight Simulate"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Dry-run with goal_text + slim contract", "request": {"params": {"action": "generation.promote", "goal_text": "promote sandbox to prod", "project_id": 1, "semantic_contract": {"effect_constraints": ["plan_only"], "fingerprint": "example-fp-simulate"}}, "tool": "preflight.simulate"}, "response": {"data": {"effect_policy_allowed": false, "l2": {"allowed": true}}, "success": true}}, {"name": "Tenant IAP checkout dry-run", "request": {"params": {"action": "shop.checkout.create", "action_params": {"idempotency_key": "iap-sim-1", "project_id": 1444, "return_url": "https://agentstack.tech/s/1444/game", "sku_id": "coin_pack_s"}, "goal_text": "visitor IAP checkout", "project_id": 1444}, "tool": "preflight.simulate"}, "response": {"data": {"can_execute_mutation": false, "l2": {"allowed": true}}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Before wiring automation — test PAT/session permissions without executing the action. Pass action_p…", "mutation_kind": "none", "plane": "Before go-live: preflight.check, then checklist.get.", "plane_chooser": "Before go-live: preflight.check, then checklist.get.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_tools": ["permissions.effective", "preflight.check", "rbac.check_permission"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "read", "safe_action": "preflight_simulate", "semantic_input_mode": "inherit_workflow", "summary": "IAM-style dry-run: would this session be allowed to call MCP action X? Returns L1 caps, L2 RBAC, and optional FAP path probe.", "title": "Preflight Simulate", "when_blocked": {"batch_anchor_would_block": "Mutating batch needs options.execution_intent=direct, goal, focus_node_id, or plan_execute_mode — use simulate_batch_actions + execution_intent on preflight.check.", "batch_semantic_anchor_conflict": "Step NL conflicts with batch semantic_contract — align goal_text or use execution_intent=direct.", "batch_semantic_anchor_required": "This step needs a batch semantic anchor — set execution_intent=direct or workflow anchor.", "budget_exceeded": "Project or user budget cap — buffs.get_effective_limits before retry.", "capability_denied": "Fabric L2 denied — see l2.deny and widen service caps or role.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "effect_policy_blocked": "Probed action violates goal effect_constraints (read_only / plan_only / no_release).", "fap_denied": "Field access policy denied — adjust FAP or use a role with write access.", "invalid_parameters": "project_id and action= required for preflight.simulate.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "L2 RBAC — permissions.effective action=<tool> (slim action_params, no file bytes); rbac.check_permission(admin) for hosting.deploy_files. If DNA grants but preflight blocks: stale JWT permissions_bitmap — reconnect OAuth or ops bearer with membership hydrate; core needs bitmap_session_reconcile + hydrate_mcp_execute_principal (Wave 7+).", "preflight_blocked": "See l2.deny — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_handoff_required": "Set context.project_id or auth.switch_project when required_client_action=apply_bearer — session_ready false.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before wiring automation — test PAT/session permissions without executing the action. Pass action_params.publish for hosting.deploy_files so action_risk matches preflight.check. Prefer simulate when a", "write_mode": null}], "processors": [{"action": "processors.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "processors", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.processors.gen1"], "id": "processors.list", "related_tools": ["processors.get_metadata", "logic.create", "logic.get_processors"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Processors List"}, "domain_title": "Processors MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"insufficient_permissions": "RBAC denied — check project membership and operator role."}, "examples": [{"description": "Get complete list of all processors with their metadata for use in logic rules", "name": "List all available processors", "request": {"params": {}, "tool": "processors.list"}, "response": {"data": {"processors": [{"ai_instructions": "Use this processor to perform mathematical operations on data fields", "capabilities": ["add", "subtract", "multiply", "divide", "compare", "set"], "category": "data_processing", "description": "Mathematical and field operations processor", "examples": [{"action": "add", "field1": "user.balance", "field2": 100, "result_field": "user.balance"}], "input_schema": {"properties": {"action": {"enum": ["add", "subtract", "multiply", "divide", "compare", "set"], "type": "string"}, "field1": {"type": "string"}, "field2": {"type": "string"}, "result_field": {"type": "string"}}, "required": ["action"], "type": "object"}, "name": "field_operations_processor", "output_schema": {"properties": {"result": {"type": "any"}}, "type": "object"}}, {"capabilities": ["get", "create", "update", "delete"], "category": "dna_operations", "description": "DNA CRUD operations processor", "name": "dna_operations_processor"}], "total": 2}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.processors.gen1"], "instruction_hint": "Catalog processors before processors.execute.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.processors", "owner_gene": "core.mcp.processors.gen1", "plane": "App commands: commands.execute. Processor list: processors.list.", "plane_chooser": "App commands: commands.execute. Processor list: processors.list.", "related_tools": ["processors.get_metadata", "logic.create", "logic.get_processors"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "processors_list", "semantic_input_mode": "inherit_workflow", "summary": "List all available processors with their metadata.", "title": "Processors List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "RBAC denied — check project membership and operator role.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Catalog processors before processors.execute.", "write_mode": null}, {"action": "processors.get_metadata", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "processors", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.processors.gen1"], "id": "processors.get_metadata", "related_tools": ["processors.list", "processors.execute"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Processors Get Metadata"}, "domain_title": "Processors MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "processor_name is required — pass canonical name from processors.list.", "processor_not_found": "processors.list — copy exact processor name into processor_name."}, "examples": [{"description": "Get processor metadata", "request": {"processor_name": "field_operations_processor"}, "response": {"data": {"description": "Mathematical operations", "name": "field_operations_processor"}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.processors.gen1"], "instruction_hint": "Schema for one processor before wiring logic.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.processors", "owner_gene": "core.mcp.processors.gen1", "plane": "App commands: commands.execute. Processor list: processors.list.", "plane_chooser": "App commands: commands.execute. Processor list: processors.list.", "related_tools": ["processors.list", "processors.execute"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "processors_get_metadata", "semantic_input_mode": "inherit_workflow", "summary": "Get detailed metadata for a specific processor.", "title": "Processors Get Metadata", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "processor_name is required — pass canonical name from processors.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "processor_not_found": "processors.list — copy exact processor name into processor_name.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Schema for one processor before wiring logic.", "write_mode": null}, {"action": "processors.execute", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "processors", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.processors.gen1"], "id": "processors.execute", "mutation_risk": "low", "related_tools": ["processors.list", "processors.get_metadata", "logic.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Processors Execute"}, "domain_title": "Processors MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"execution_failed": "Inspect processor logs; logic.dry_run for rule-level replay.", "invalid_parameters": "processor_name and action required — match get_metadata input_schema.", "processor_not_found": "processors.list — verify processor_name before execute."}, "example_params": {"action": "add", "parameters": {"field1": "user.balance", "field2": 100, "result_field": "user.balance"}, "processor_name": "field_operations_processor"}, "example_request": {"action": "processors.execute", "params": {"action": "add", "parameters": {"field1": "user.balance", "field2": 100, "result_field": "user.balance"}, "processor_name": "field_operations_processor"}}, "examples": [{"description": "Execute processor to add two numbers", "name": "Execute field operations processor - add", "request": {"params": {"action": "add", "parameters": {"field1": 10, "field2": 5, "result_field": "sum"}, "processor_name": "field_operations_processor"}, "tool": "processors.execute"}, "response": {"data": {"result": 15, "success": true}, "success": true}}, {"description": "Compare two values using processor", "name": "Execute field operations processor - compare", "request": {"params": {"action": "compare", "parameters": {"field1": "user.balance", "field2": 100, "operator": ">="}, "processor_name": "field_operations_processor"}, "tool": "processors.execute"}, "response": {"data": {"result": true, "success": true}, "success": true}}, {"description": "Execute processor to get entity data", "name": "Execute DNA operations processor", "request": {"params": {"action": "get", "parameters": {"entity": "data_projects_8dna", "filters": {"project_id": 123}}, "processor_name": "dna_operations_processor"}, "tool": "processors.execute"}, "response": {"data": {"result": {"id": 123, "name": "My Project"}, "success": true}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.processors.gen1"], "instruction_hint": "Use this tool to test a processor before using it in logic rules", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.processors", "owner_gene": "core.mcp.processors.gen1", "plane": "App commands: commands.execute. Processor list: processors.list.", "plane_chooser": "App commands: commands.execute. Processor list: processors.list.", "related_tools": ["processors.list", "processors.get_metadata", "logic.create"], "required_cap": "logic_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "processors_execute", "semantic_input_mode": "inherit_workflow", "summary": "Execute a processor directly.", "title": "Processors Execute", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_failed": "Inspect processor logs; logic.dry_run for rule-level replay.", "invalid_parameters": "processor_name and action required — match get_metadata input_schema.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "processor_not_found": "processors.list — verify processor_name before execute.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Use this tool to test a processor before using it in logic rules", "write_mode": null}], "profile": [{"action": "profile.spotlight.move", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "profile", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.profile.gen1"], "id": "profile.spotlight.move", "related_tools": ["auth.get_profile"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Profile Spotlight Move"}, "domain_title": "Auth MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "After purchasing Spotlight/VIP or to retarget the personal project beam.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.auth", "owner_gene": "core.auth.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.get_profile"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "profile_spotlight_move", "semantic_input_mode": "inherit_workflow", "summary": "Point a personal Spotlight/VIP/premium beam at an owned standalone Free project. REST twin: POST /api/profile/spotlight. Not projects.patch_my_data.", "title": "Profile Spotlight Move", "when_to_use": "After purchasing Spotlight/VIP or to retarget the personal project beam.", "write_mode": null}], "projects": [{"action": "projects.get_projects", "aliases": ["projects.list", "projects.list_projects"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Treating not_modified / HTTP 304 as zero workspaces", "Using page count as ecs_index_total"], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_projects", "related_tools": ["projects.get_project", "auth.get_profile", "projects.membership.repair"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Projects"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve list of all projects the current user has access to", "name": "Get all accessible projects", "request": {"params": {}, "tool": "projects.get_projects"}, "response": {"data": {"count": 1, "projects": [{"config": {}, "created_at": "2025-01-20T10:00:00Z", "description": "Project description", "id": 123, "is_active": true, "name": "My Project", "updated_at": "2025-01-20T10:00:00Z", "user_id": 1}]}, "success": true}}, {"description": "Find projects by name using partial match", "name": "Search projects by name", "request": {"params": {"name": "My Project"}, "tool": "projects.get_projects"}, "response": {"data": {"count": 1, "projects": [{"description": "Project description", "id": 123, "is_active": true, "name": "My Project"}]}, "success": true}}, {"description": "Find projects by searching in both name and description fields", "name": "Search projects by name or description", "request": {"params": {"search": "test"}, "tool": "projects.get_projects"}, "response": {"data": {"count": 1, "projects": [{"description": "This is a test project", "id": 124, "is_active": true, "name": "Test Project"}]}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Default accessible_only=true and refresh=false — prefer ECS accessible_index (list_meta.read_model=…", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_project", "auth.get_profile", "projects.membership.repair"], "required_cap": "mcp_read", "requires_preflight": false, "returns_hint": "projection=summary keeps caller_role/access_tier; total_projects follows ecs_index_total when read_model=ecs_cards; count is page size only.", "risk_class": "read", "safe_action": "projects_get_projects", "semantic_input_mode": "inherit_workflow", "summary": "List workspaces for the signed-in user (summary or full projection, filters, pagination). See when_to_use and list_meta.read_model (ecs_cards, accessible_ids, membership_scan).", "title": "List Projects", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to list projects", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "projects_list_timeout": "List exceeded server budget — Retry-After; refresh=true or narrower limit", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_unavailable": "Lag shed / temporary overload — retry with smaller limit or refresh_cache", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "User not authenticated", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Default accessible_only=true and refresh=false — prefer ECS accessible_index (list_meta.read_model=ecs_cards, one DNA leaf). refresh=true or refresh_cache after invite/join lag. accessible_only=false", "write_mode": null}, {"action": "projects.get_project", "aliases": ["projects.get"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_project", "related_tools": ["projects.get_data", "projects.get_users", "projects.get_stats"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Project"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Get basic project information", "request": {"project_id": 123}, "response": {"data": {"id": 123, "is_active": true, "name": "My Project"}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Load project metadata + ids for scoped actions.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_data", "projects.get_users", "projects.get_stats"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_get_project", "semantic_input_mode": "inherit_workflow", "summary": "Get one project.", "title": "Projects Get Project", "tool_chains": ["rbac_manage_members"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to access project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project with specified ID not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Load project metadata + ids for scoped actions.", "write_mode": null}, {"action": "projects.create_project", "aliases": ["projects.create"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["params.project_id or params.id on create", "Using MCP batch context sentinels 999_999_999 as create targets"], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.create_project", "mutation_risk": "low", "related_tools": ["projects.add_user", "apikeys.create", "projects.get_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Create Project"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Create a new project with minimal required information", "name": "Create a simple project", "request": {"params": {"description": "Project description", "name": "My New Project"}, "tool": "projects.create_project"}, "response": {"data": {"message": "Project created successfully", "project": {"description": "Project description", "id": 123, "is_active": true, "name": "My New Project"}, "projects": [{"description": "Project description", "id": 123, "is_active": true, "name": "My New Project"}], "success": true}, "success": true}}, {"description": "Create a project with custom settings and configuration", "name": "Create project with settings", "request": {"params": {"description": "Project description", "name": "My New Project", "preset_id": "empty", "settings": {"language": "en", "theme": "dark", "timezone": "UTC"}}, "tool": "projects.create_project"}, "response": {"data": {"message": "Project created successfully", "project": {"description": "Project description", "id": 124, "name": "My New Project"}, "projects": [{"id": 124, "name": "My New Project"}], "success": true}, "success": true}}, {"description": "Replay with same idempotency_key returns the first project", "name": "Idempotent create", "request": {"params": {"idempotency_key": "create-my-workspace-v1", "name": "Stable Name"}, "tool": "projects.create_project"}, "response": {"data": {"project": {"id": 123, "name": "Stable Name"}, "project_id": 123, "success": true}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Server allocates project_id via blanks/pop_project_id — never pass params.project_id. Batch context…", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.add_user", "apikeys.create", "projects.get_project"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "projects_create_project", "semantic_input_mode": "inherit_workflow", "summary": "Create a new project.", "title": "Projects Create Project", "tool_chains": ["multi_tenant_onboarding"], "when_blocked": {"client_supplied_project_id_forbidden": "Remove project_id/id from params — only name, description, settings; allocator is pop_project_id / blanks pool", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "Project creation failed", "idempotency_conflict": "Reuse the same name/body as first call or issue a new idempotency_key", "insufficient_permissions": "Insufficient permissions to create project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "name_required": "Project name is required", "personal_project_cap": "buffs.get_effective_limits + archive or upgrade plan", "reserved_project_id_refused": "python -m scripts.heal_project_id_numbering --report --fix-cursor", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Server allocates project_id via blanks/pop_project_id — never pass params.project_id. Batch context sentinels (999_999_999 / 987_654_321) are read-scope only, not create targets. Tenant ids live in [1", "write_mode": null}, {"action": "projects.create_project_anonymous", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["params.project_id or params.id on create", "Using MCP batch context sentinels 999_999_999 as create targets"], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.create_project_anonymous", "mutation_risk": "low", "related_tools": ["projects.get_project", "apikeys.create", "auth.get_profile", "auth.email_otp.send", "auth.email_otp.login"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Create Project Anonymous"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Anonymous project with one-time credentials at top level and neutral bootstrap metadata.", "request": {"name": "AI Generated Project"}, "response": {"data": {"bootstrap": {"documentation": "/mcp/ai_prompt#anonymous-bootstrap", "one_time_credentials": true, "preferred_auth": {"field": "user_api_key", "header": "X-API-Key"}}, "project": {"id": 123, "name": "AI Generated Project"}, "project_api_key": "anon_ask_xxx...", "project_id": 123, "session_token": "xxx...", "user_api_key": "anon_ask_xxx...", "user_id": 456}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Greenfield without login — requires options.bootstrap_ack=true on execute. Save user_api_key once. …", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_project", "apikeys.create", "auth.get_profile", "auth.email_otp.send", "auth.email_otp.login"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "projects_create_project_anonymous", "semantic_input_mode": "inherit_workflow", "summary": "Anonymous bootstrap: one-time anon_ask_* key + project_id. Upgrade: auth.email_otp.send purpose=convert with same X-API-Key — no convert tool.", "title": "Projects Create Project Anonymous", "tool_chains": ["user_with_trial", "game_setup", "project_bootstrap"], "when_blocked": {"client_supplied_project_id_forbidden": "Anonymous create never accepts logical project_id — server assigns after provision", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "creation_failed": "Project creation failed", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "name_required": "Project name is required", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Greenfield without login — requires options.bootstrap_ack=true on execute. Save user_api_key once. Convert: purpose=convert OTP with same key, then auth.email_otp.login.", "write_mode": null}, {"action": "projects.get_data", "aliases": ["dna.data.get", "kv.get", "projects.get_settings", "storage.kv.get"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_data", "related_tools": ["projects.patch_data", "projects.get_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Data", "visitor_callable": true}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Start with an outline, then one path or a page. key_after and key_limit page object keys. item_offs…", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.patch_data", "projects.get_project"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_get_data", "semantic_input_mode": "inherit_workflow", "summary": "Read project.data without pulling a fat leaf. A path under the byte budget returns that value. A thicker node returns an outline, a key page, an item page, or a text window. detail=full asks for the b", "title": "Projects Get Data", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "fap_denied": "config.api_keys is restricted — use apikeys.list or admin manage_api_keys; never read key_hash via get_data", "hosted_shared_data_denied": "Hosted players must pass path under config.hosted_mcp.shared_data_prefixes — tenant operator: projects.patch_data config.hosted_mcp → generation.promote", "insufficient_permissions": "Not a project member or DNA read denied", "invalid_parameters": "project_id, path/pagination, or view params invalid", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Start with an outline, then one path or a page. key_after and key_limit page object keys. item_offset pages arrays. offset and max_chars window a string. detail=full raises the byte ceiling. paths kee", "write_mode": null}, {"action": "projects.get_my_data", "aliases": ["profile.data.get", "users.me.data", "users.me.get"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_my_data", "related_tools": ["projects.patch_my_data", "projects.get_data"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get My Data", "visitor_callable": true}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Private member state (hosted games: games.save via /s/{pid}/mcp). Start with outline, then one path…", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.patch_my_data", "projects.get_data"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_get_my_data", "semantic_input_mode": "inherit_workflow", "summary": "Read the signed-in member's project data (REST GET /projects/{id}/users/me/data). A path under the byte budget returns that leaf. A thicker node returns an outline or a page. Omit path for top-level n", "title": "Projects Get My Data", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Not a project member or DNA read denied", "invalid_parameters": "project_id, path/pagination, or view params invalid", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_required": "MCP OAuth or auth.get_profile required — user_id missing from session", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Private member state (hosted games: games.save via /s/{pid}/mcp). Start with outline, then one path. Shared lobby/config → projects.get_data.", "write_mode": null}, {"action": "projects.patch_my_data", "ai_tips": "Private member leaf: one path or patches[] (≤16, sequential). ops and expected_sha256 apply to one path. dry_run returns previous_sha256. Shared project.data → projects.patch_data.", "aliases": ["profile.data.set", "users.me.patch"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Patching shared project.data or site HTML — use projects.patch_data or hosting.", "anti_patterns": ["Patching shared project.data or site HTML — use projects.patch_data or hosting.", "Sending a truncated json_view window as value without allow_shrink or search_replace."], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.patch_my_data", "mutation_risk": "low", "related_tools": ["projects.get_my_data", "projects.patch_data"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Patch My Data", "visitor_callable": true}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Private member leaf (hosted games.save): one path or patches[] (≤16). Shared lobby → projects.patch…", "mutation_kind": "path", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_my_data", "projects.patch_data"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "projects_patch_my_data", "semantic_input_mode": "inherit_workflow", "summary": "Leaf write on the signed-in member's project data (REST PATCH /projects/{id}/users/me/data). write_mode replace sets the path; merge overlays an object. String leaves: value={replacements} or unified_", "title": "Projects Patch My Data", "when_blocked": {"ambiguous_anchor": "Narrow find, set count on the replacement pair, or use projects.get_my_data json_view", "anchor_not_found": "Confirm where/find against projects.get_my_data at the same path", "auth_required": "Hosted member write requires authenticated session — mint hosted cookie or auth.get_profile", "content_shrink_blocked": "projects.get_my_data json_view — search_replace, ops, or allow_shrink=true", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "empty_path": "path must be a non-empty dotted key", "hosted_shared_data_denied": "Shared match journal → projects.patch_data under configured shared_data_prefixes", "index_out_of_range": "List index or move target is out of range", "insufficient_permissions": "project_admin cap or member write — RBAC / buffs.get_effective_limits", "invalid_parameters": "project_id, path, or write_mode invalid", "jsonb_set_scalar_blocked": "Path targets a scalar leaf — cannot SET an object there; use a deeper dotted path or projects.get_data json_view to inspect shape before patch_data.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "leaf_path_invalid": "Bracket paths do not support ops batch", "not_a_member": "projects.join or invite flow before patch_my_data", "patch_apply_failed": "GET leaf text; retry unified_diff or strict_diff on ops", "patch_too_large": "Smaller unified_diff or search_replace ops", "plan_graph_coarse_ecosystem_patch_refused": "Coarse ecosystem/orchestrator merge with task_list forbidden — patch leaf ecosystem.orchestrator.task_list or use agents.plan_patch / plan_heal_leaf", "plan_graph_ops_refused": "Plan graph DNA leaves require agents.plan_patch — not projects.patch_data ops[]", "plan_ops_text_mode": "Text op needs replacements, find/replace, or unified_diff", "replacement_not_found": "Confirm find at path via projects.get_my_data", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "shallow_leaf_replace_blocked": "Deeper dotted path or merge — projects.get_my_data data.keys_lost", "stackscript_plane_routed": "Match runtime DNA → script.run on public_run export, not patch_my_data", "text_anchor_miss": "Fuzzy anchor did not match; narrow find", "text_revision_conflict": "projects.get_my_data for leaf_sha256, then retry ops with expected_sha256", "too_many_paths": "At most 16 leaves; ops and expected_sha256 apply to one path only", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "Read shape hint — narrow path or fix bracket-path refusal", "write_mode_invalid": "Use replace | merge | append | prepend per leaf shape", "write_mode_unsupported": "Dict leaves need merge fragment, not append — projects.get_my_data json_view"}, "when_to_use": "Private member leaf (hosted games.save): one path or patches[] (≤16). Shared lobby → projects.patch_data.", "write_mode": ["replace", "write", "set", "put", "merge", "patch", "delete", "search_replace", "fuzzy_replace", "unified_diff", "append", "prepend"], "write_mode_note": "Member-private leaf SET/merge/delete. Same string editor, ops batch, and dry_run as projects.patch_data (read ladder: projects.get_my_data)."}, {"action": "projects.patch_data", "ai_tips": "Write up to 16 nested leaves (patches[]), or bare path + value; ops batch (≤16) applies to exactly one dot path (not with multi-leaf patches). Default write_mode is replace at the path leaf — appending to a string leaf requires write_mode append or prepend (replace wipes the whole string). Partial dict overlays need write_mode merge (or deeper path). Omitted write_mode on dict leaves may infer merge when both sides are non-empty objects. Use expected_sha256 from dry_run for CAS; same MCP batch may use expected_sha256=from_batch_preview on commit after a dry_run step. patches[] plain replace SET (2+ dot paths, prod slice) uses one atomic txn; other batches are sequential with partial commit on fail-fast. Bracket", "aliases": ["dna.data.set", "projects.update_settings"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Putting bot_spec.commands or knowledge markdown into projects.update_project data.", "anti_patterns": ["Putting bot_spec.commands or knowledge markdown into projects.update_project data.", "Loading the whole project.data blob to change one key.", "Patching config.knowledge.* — use knowledge.config.patch or knowledge.phenotype.upsert."], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.patch_data", "mutation_risk": "low", "related_tools": ["projects.get_data", "projects.get_project", "script.put", "script.docs", "knowledge.config.patch", "knowledge.phenotype.upsert"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Projects Patch Data", "visitor_callable": true}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"path": "config.theme", "value": "dark", "write_mode": "replace"}, "example_request": {"action": "projects.patch_data", "params": {"path": "config.theme", "value": "dark", "write_mode": "replace"}}, "examples": [{"description": "Single leaf replace on project.data (bind context.project_id)", "name": "Replace config leaf", "request": {"path": "config.theme", "value": "dark", "write_mode": "replace"}}], "execution_class": "cheap", "instruction_hint": "Write up to 16 nested leaves (patches[]), or bare path + value; ops batch (≤16) applies to exactly …", "mutation_kind": "path", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_data", "projects.get_project", "script.put", "script.docs", "knowledge.config.patch", "knowledge.phenotype.upsert"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["generation.realign_to_prod"], "safe_action": "projects_patch_data", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Leaf SET on project.data (REST PATCH /projects/{id}/data). write_mode=replace sets the path; merge overlays an object; delete removes it. Or ops (≤16) on one path: merge, search_replace, insert_before", "title": "Projects Patch Data", "tool_chains": ["crud_with_logic"], "verification": ["projects.get_data"], "verify": [{"action": "projects.get_data", "predicate": "named resource is visible"}], "when_blocked": {"ambiguous_anchor": "Narrow find, set count on the replacement pair, or use projects.get_data json_view", "anchor_not_found": "Confirm where/find against projects.get_data at the same path", "auth_required": "Hosted journal write needs signed-in player — bootstrapHostedPlayerSession", "content_shrink_blocked": "projects.get_data json_view — search_replace, ops, or allow_shrink=true", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "empty_path": "path must be a non-empty dotted key", "generation_fork_required": "generation.fork or omit env_uuid when auto_generation_mode auto-forks", "hosted_shared_data_denied": "Path outside shared_data_prefixes — tenant sets config.hosted_mcp via promote; or use script.run public_run for runtime match leaves", "index_out_of_range": "List index or move target is out of range", "invalid_parameters": "path, ops shape, or write_mode invalid", "jsonb_set_scalar_blocked": "Path targets a scalar leaf — cannot SET an object there; use a deeper dotted path or projects.get_data json_view to inspect shape before patch_data.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "leaf_path_invalid": "ops need a dot path; bracket SET is ok without ops — projects.get_data json_view", "not_a_member": "Grant project write role for multiplayer journal or use script.run Lane B", "patch_apply_failed": "GET leaf text; retry unified_diff or strict_diff on ops", "patch_too_large": "Smaller unified_diff or search_replace ops", "plan_graph_coarse_ecosystem_patch_refused": "Use path ecosystem.orchestrator.task_list with merge/replace, or agents.plan_patch", "plan_graph_ops_refused": "Use agents.plan_patch for task_list / agents.plan.* leaves", "plan_ops_text_mode": "Text op needs replacements, find/replace, or unified_diff", "replacement_not_found": "Confirm find at path via projects.get_data", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "shallow_leaf_replace_blocked": "Partial dict at a shallow path would drop sibling keys — use write_mode=merge, a deeper dotted path, or ops[]; read data.keys_lost on the error envelope", "stackscript_plane_routed": "ecosystem.scripts.* is StackScript plane — script.put → script.test → script.dry_run → script.publish; not projects.patch_data", "text_anchor_miss": "Fuzzy anchor did not match; narrow find or use json_view", "text_revision_conflict": "projects.get_data or dry_run preview previous_sha256, then commit with expected_sha256", "too_many_paths": "ops apply to one path only — use patches[] for multi-leaf SET without ops", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "write_failed": "Read shape hint — narrow path or fix bracket-path refusal", "write_mode_invalid": "Unknown write_mode", "write_mode_unsupported": "merge requires an object at the path; append/prepend only on list or string leaves — for dict leaves (e.g. stream_relay room settings) use write_mode=merge with a fragment, not append; shallow paths use deeper dotted keys or ops[]"}, "when_to_use": "Write up to 16 nested leaves (patches[]), or bare path + value; ops batch (≤16) applies to exactly one dot path (not with multi-leaf patches). Default write_mode is replace at the path leaf — appendin", "write_mode": ["replace", "write", "set", "put", "merge", "patch", "delete", "search_replace", "fuzzy_replace", "unified_diff", "append", "prepend"], "write_mode_note": "Leaf path SET (REST PATCH /projects/{id}/data). write_mode=replace sets the path; merge overlays an object; delete removes it. String leaves: search_replace / unified_diff or ops batch on one path. patches[]: sequential leaves; 2+ plain replace SET may use one atomic txn. ops and dry_run apply to one path only."}, {"action": "projects.get_notify_policy", "aliases": ["projects.notify_policy"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1", "core.messaging.channel_plane.gen1"], "id": "projects.get_notify_policy", "related_tools": ["projects.put_notify_policy", "channels.resolve_routing"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Notify Policy"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Before put_notify_policy or generation.diff — inspect mandatory categories and bot allowlist.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.put_notify_policy", "channels.resolve_routing"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_get_notify_policy", "semantic_input_mode": "inherit_workflow", "summary": "Read project.data.notify_policy (channel plane tenant defaults).", "title": "Projects Get Notify Policy", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before put_notify_policy or generation.diff — inspect mandatory categories and bot allowlist.", "write_mode": null}, {"action": "projects.put_notify_policy", "ai_tips": "Tenant notify policy edits in safe generation cycle → diff → gates → promote.", "aliases": ["projects.configure_notifications"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1", "core.messaging.channel_plane.gen1"], "id": "projects.put_notify_policy", "mutation_risk": "low", "related_tools": ["projects.get_notify_policy", "generation.diff_vs_prod", "generation.promote"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Put Notify Policy"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Tenant notify policy edits in safe generation cycle → diff → gates → promote.", "mutation_kind": "path", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_notify_policy", "generation.diff_vs_prod", "generation.promote"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "projects_put_notify_policy", "semantic_input_mode": "inherit_workflow", "summary": "Merge patch into project.data.notify_policy. Paid tenants with auto_generation_mode require env_uuid (sandbox anchor).", "title": "Projects Put Notify Policy", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "generation_fork_required": "generation.fork or omit env_uuid when auto_generation_mode auto-forks", "invalid_parameters": "patch object is required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Tenant notify policy edits in safe generation cycle → diff → gates → promote.", "write_mode": null}, {"action": "projects.update_project", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Putting bot_spec.commands or knowledge markdown into data.", "anti_patterns": ["Putting bot_spec.commands or knowledge markdown into data.", "Using this instead of projects.patch_data for one nested key."], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.update_project", "mutation_risk": "low", "related_tools": ["projects.get_project", "projects.create_project", "projects.patch_data"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Update Project"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Update project name", "request": {"name": "Updated Name", "project_id": 123}, "response": {"data": {"id": 123, "name": "Updated Name"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Update project name/description/is_active. Nested JSON leaves → projects.patch_data.", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_project", "projects.create_project", "projects.patch_data"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "projects_update_project", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Update an existing project.", "title": "Projects Update Project", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to update project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update project name/description/is_active. Nested JSON leaves → projects.patch_data.", "write_mode": null}, {"action": "projects.delete_project", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.delete_project", "mutation_risk": "high", "related_tools": ["projects.get_project", "projects.create_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Delete Project"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "examples": [{"description": "Delete a project", "request": {"project_id": 123}, "response": {"data": {"deleted": true, "project_id": 123}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Irreversible workspace delete — confirm id twice.", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_project", "projects.create_project"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "projects_delete_project", "semantic_input_mode": "inherit_workflow", "summary": "Delete a project (PSDP).", "title": "Projects Delete Project", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to delete project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Irreversible workspace delete — confirm id twice.", "write_mode": null}, {"action": "projects.get_deletion_inventory", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_deletion_inventory", "related_tools": ["projects.delete_project", "projects.schedule_deletion"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Deletion Inventory"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "PSDP pre-delete inventory — project owner only. Call only for context.project_id you own (verify vi…", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.delete_project", "projects.schedule_deletion"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_get_deletion_inventory", "semantic_input_mode": "inherit_workflow", "summary": "Pre-delete inventory: blockers, warnings, and execution_token for safe delete.", "title": "Projects Get Deletion Inventory", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Project owner only — use a project_id you own (projects.get_projects) before PSDP inventory", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Authenticate via Connect or auth.get_profile first", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "PSDP pre-delete inventory — project owner only. Call only for context.project_id you own (verify via projects.get_projects caller_role=owner). Do not sweep every project_id from a list probe; use reci", "write_mode": null}, {"action": "projects.schedule_deletion", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.schedule_deletion", "related_tools": ["projects.get_deletion_inventory", "projects.execute_deletion"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Schedule Deletion"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "After get_deletion_inventory with execution_token — grace-period PSDP schedule.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_deletion_inventory", "projects.execute_deletion"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "projects_schedule_deletion", "semantic_input_mode": "inherit_workflow", "summary": "Schedule project deletion after inventory + execution token.", "title": "Projects Schedule Deletion", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After get_deletion_inventory with execution_token — grace-period PSDP schedule.", "write_mode": null}, {"action": "projects.execute_deletion", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.execute_deletion", "related_tools": ["projects.get_deletion_inventory", "projects.schedule_deletion"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Execute Deletion"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "After schedule_deletion or inventory token — hard delete when blockers are zero.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_deletion_inventory", "projects.schedule_deletion"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "projects_execute_deletion", "semantic_input_mode": "inherit_workflow", "summary": "Execute scheduled or immediate deletion with execution token.", "title": "Projects Execute Deletion", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After schedule_deletion or inventory token — hard delete when blockers are zero.", "write_mode": null}, {"action": "projects.get_stats", "aliases": ["analytics.get", "projects.get_activity"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_stats", "related_tools": ["projects.get_project", "projects.get_users"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Stats"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Signed-in member count and status", "request": {"project_id": 123}, "response": {"data": {"project_id": 123, "status": "active", "timestamp": "2026-10-08T12:00:00+00:00", "users_count": 5}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Member count and project status. API-call and storage counters are not on this card.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_project", "projects.get_users"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_get_stats", "semantic_input_mode": "inherit_workflow", "summary": "Get project statistics.", "title": "Projects Get Stats", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to view stats", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Member count and project status. API-call and storage counters are not on this card.", "write_mode": null}, {"action": "projects.get_users", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_users", "related_tools": ["projects.get_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Get Users"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Get project users", "request": {"project_id": 123}, "response": {"data": {"count": 1, "project_id": 123, "users": [{"created_at": "2025-01-20T10:00:00Z", "display_name": "Ada", "email": "user@example.com", "is_active": true, "last_login": null, "role": "admin", "user_id": 1, "username": "ada"}]}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Membership source of truth. If auth.get_profile mutation_allowed is true, do not call auth.switch_p…", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_project"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_get_users", "semantic_input_mode": "inherit_workflow", "summary": "Get list of users in a project.", "title": "Projects Get Users", "tool_chains": ["apply_custom_buff_to_user", "rbac_manage_members"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions to view users", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Membership source of truth. If auth.get_profile mutation_allowed is true, do not call auth.switch_project. projects.get_projects is not membership.", "write_mode": null}, {"action": "projects.join", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.join", "related_tools": ["agents.work_next", "agents.graph_health", "agents.plan_get", "projects.membership.repair", "buffs.get_effective_limits", "auth.switch_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Join"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Open hub join — recipe mcp_community_hub_v1 (graph_health, heal if spill) then agents.work_next home=project_self or mcp_work_loop_v1", "request": {"project_id": 123}, "response": {"data": {"project_id": 123, "role": "member", "status": "joined", "user_id": 42, "work_graph_path": "/user/projects/123/work-graph?home=project_self"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Self-join when config.membership.join_policy is open. Idempotent for members. Then agents.work_next…", "mutation_kind": "none", "next_recipes": ["mcp_community_hub_v1", "mcp_work_loop_v1"], "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["agents.work_next", "agents.graph_health", "agents.plan_get", "projects.membership.repair", "buffs.get_effective_limits", "auth.switch_project"], "required_cap": "mcp_write", "requires_preflight": false, "returns_hint": "data.status joined|already_member, role, project_id, user_id, work_graph_path — then recipe mcp_community_hub_v1 spine: auth.switch_project, agents.graph_health, agents.plan_heal_leaf when spill_incomplete, agents.work_next home=project_self.", "risk_class": "low_write", "safe_action": "projects_join", "semantic_input_mode": "inherit_workflow", "summary": "Join an open community project as the authenticated session user.", "title": "Projects Join", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "email_verification_required": "Verify email before joining", "invalid_parameters": "project_id required on projects.join", "join_not_allowed": "config.membership.join_policy is not open — use projects.add_user / invite flow", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "member_cap_reached": "Hub member cap reached — buffs.get_effective_limits on project entity", "project_not_found": "Confirm project_id via projects.get_projects", "rate_limited": "Too many join attempts — honor Retry-After then retry projects.join", "rbac_assign_failed": "Membership row rolled back — projects.membership.repair then auth.switch_project", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Session user required — auth.login or operator Connect", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Self-join when config.membership.join_policy is open. Idempotent for members. Then agents.work_next with home=project_self on the same project_id.", "write_mode": null}, {"action": "projects.leave", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.leave", "related_tools": ["projects.get_projects", "projects.join"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Leave"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Self-remove membership; billing owner must transfer ownership first", "request": {"project_id": 123}, "response": {"data": {"project_id": 123, "status": "left", "user_id": 42}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Self-remove membership. Billing owner cannot leave — transfer ownership first.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_projects", "projects.join"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "projects_leave", "semantic_input_mode": "inherit_workflow", "summary": "Leave a project as the authenticated session user (self-remove membership).", "title": "Projects Leave", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "owner_cannot_leave": "Transfer ownership before leaving", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "Session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Self-remove membership. Billing owner cannot leave — transfer ownership first.", "write_mode": null}, {"action": "projects.add_user", "aliases": ["projects.attach_to_user"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.add_user", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Add User"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"dry_run": false, "permissions": {}, "project_id": 123, "role": "member", "user_id": 123}, "example_request": {"action": "projects.add_user", "params": {"dry_run": false, "permissions": {}, "project_id": 123, "role": "member", "user_id": 123}}, "execution_class": "cheap", "instruction_hint": "Membership write. dry_run is rejected (dry_run_not_supported). Attach a user by user_id. Ecosystem …", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": ["projects.remove_user"], "safe_action": "projects_add_user", "semantic_input_mode": "inherit_workflow", "summary": "Add a user to a project (requires manage_users or owner on that project).", "title": "Projects Add User", "verification": ["projects.get_users", "rbac.check_permission"], "verify": [{"action": "projects.get_users", "predicate": "named resource is visible"}, {"action": "rbac.check_permission", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dry_run_not_supported": "This action has no dry_run. Omit the key; the call writes membership.", "insufficient_permissions": "Owner/manage_users required, or Launch+ project plan (user_management) when caller is not ecosystem. Personal Premium/VIP does not unlock team management. Operators: context.project_id=1.", "invalid_parameters": "user_id is required.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "member_cap_reached": "Project member cap or billing user limit reached — buffs.get_effective_limits", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "The key cannot manage members of this project.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_already_in_project": "User already in project"}, "when_to_use": "Membership write. dry_run is rejected (dry_run_not_supported). Attach a user by user_id. Ecosystem operators use context.project_id=1 and params.project_id for the tenant. Resolve id via social.users.", "write_mode": null}, {"action": "projects.update_user_role", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.update_user_role", "mutation_risk": "low", "related_tools": ["projects.get_users", "projects.add_user", "projects.remove_user"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Update User Role"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Change member/admin role — not owner transfer; requires manage_users or owner.", "mutation_kind": "entity", "next_actions": ["rbac.get_roles", "projects.get_users"], "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_users", "projects.add_user", "projects.remove_user"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "access_control", "safe_action": "projects_update_user_role", "semantic_input_mode": "inherit_workflow", "summary": "Update a user's role in a project (requires manage_users or owner; cannot assign owner via this tool).", "title": "Projects Update User Role", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Only owner or manage_users — projects.get_users then retry", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_in_project": "projects.add_user first, then projects.update_user_role"}, "when_to_use": "Change member/admin role — not owner transfer; requires manage_users or owner.", "write_mode": null}, {"action": "projects.remove_user", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.remove_user", "mutation_risk": "high", "related_tools": ["projects.get_users", "projects.add_user"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Remove User"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Remove inactive or departed members — requires manage_users or owner.", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_users", "projects.add_user"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "projects_remove_user", "semantic_input_mode": "inherit_workflow", "summary": "Remove a user from a project (requires manage_users or owner on that project).", "title": "Projects Remove User", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Only project owner or ecosystem can remove users", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_in_project": "User not found in project"}, "when_to_use": "Remove inactive or departed members — requires manage_users or owner.", "write_mode": null}, {"action": "projects.orchestrator.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.orchestrator.get", "related_tools": ["projects.orchestrator.patch", "agents.plan_get", "agents.work_next"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Orchestrator Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read orchestrator binding (agent_uuid, persona, memory) — not the plan graph. Use agents.plan_get f…", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Then mcp_orch_faq_desk, mcp_orch_support_desk, or mcp_orch_api_desk. One channel owner.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.orchestrator.patch", "agents.plan_get", "agents.work_next"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_orchestrator_get", "semantic_input_mode": "inherit_workflow", "summary": "Get project_orchestrator 8DNA leaf config.", "title": "Projects Orchestrator Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read orchestrator binding (agent_uuid, persona, memory) — not the plan graph. Use agents.plan_get for task_list. home scopes env_uuid fail-closed only.", "write_mode": null}, {"action": "projects.orchestrator.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.orchestrator.patch", "mutation_risk": "low", "related_tools": ["projects.orchestrator.get", "agents.plan_patch", "agents.reconcile_binding"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Orchestrator Patch"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Patch orchestrator config (persona, memory_profile, operator desk). Provision runs on prod only (no…", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Then mcp_orch_faq_desk, mcp_orch_support_desk, or mcp_orch_api_desk. One channel owner.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.orchestrator.get", "agents.plan_patch", "agents.reconcile_binding"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "projects_orchestrator_patch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Patch project_orchestrator leaf (dna_set_project_data_path).", "title": "Projects Orchestrator Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "project_id and patch object required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "orchestrator_provision_requires_prod": "First projects.orchestrator.patch on prod (omit env_uuid), then generation.fork and sandbox-only overlays — tenant business assistant recipe step 4.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Patch orchestrator config (persona, memory_profile, operator desk). Provision runs on prod only (not when env_uuid set on patch). Tenant business assistant recipe step 4: prod patch on head (omit env_", "write_mode": null}, {"action": "projects.orchestrator.export_pack", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.orchestrator.export_pack", "related_tools": ["projects.orchestrator.import_from_asset", "projects.orchestrator.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Orchestrator Export Pack"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Export marketplace orchestrator pack from project or personal plan leaf. Import back via projects.o…", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Then mcp_orch_faq_desk, mcp_orch_support_desk, or mcp_orch_api_desk. One channel owner.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.orchestrator.import_from_asset", "projects.orchestrator.get"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_orchestrator_export_pack", "semantic_input_mode": "inherit_workflow", "summary": "Export portable ProjectOrchestratorPack JSON.", "title": "Projects Orchestrator Export Pack", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "session_user_required": "session user_id required for personal home export", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export marketplace orchestrator pack from project or personal plan leaf. Import back via projects.orchestrator.import_from_asset on home=project only.", "write_mode": null}, {"action": "projects.orchestrator.import_from_asset", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.orchestrator.import_from_asset", "mutation_risk": "low", "related_tools": ["projects.orchestrator.export_pack", "projects.orchestrator.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Orchestrator Import From Asset"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Import orchestrator marketplace pack onto project plan slice. Personal home (self|project_self) is …", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Then mcp_orch_faq_desk, mcp_orch_support_desk, or mcp_orch_api_desk. One channel owner.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.orchestrator.export_pack", "projects.orchestrator.patch"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "projects_orchestrator_import_from_asset", "semantic_input_mode": "inherit_workflow", "summary": "Fulfill orchestrator pack from commerce asset or raw pack dict.", "title": "Projects Orchestrator Import From Asset", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "env_uuid_project_only": "env_uuid is only valid for home=project", "graph_home_unknown": "home must be project, self, or project_self", "import_pack_personal_home_unsupported": "Orchestrator pack import applies to project plan slice only — switch to home=project", "invalid_parameters": "project_id required; pack or asset required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Import orchestrator marketplace pack onto project plan slice. Personal home (self|project_self) is unsupported — use project home.", "write_mode": null}, {"action": "projects.limits.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.limits.get", "related_tools": ["buffs.get_effective_limits", "bots.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Limits Get"}, "effect": {"execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "heavy", "instruction_hint": "Before fleet/commerce mutations — merged project-plane limits (entity_kind=project). Response: data…", "mutation_kind": "none", "next_actions": ["buffs.list_active_buffs entity_kind=project", "buffs.grant_subscription plane=project for operator tier supply"], "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["buffs.get_effective_limits", "bots.list"], "required_cap": "mcp_read", "requires_preflight": false, "returns_hint": "effective_limits.limits + contributing_buffs; limits_source_ok=false when buff merge failed; bot gate uses fleet ecs_health.bots_index_count (falls back to list when index cold).", "risk_class": "read", "safe_action": "projects_limits_get", "semantic_input_mode": "inherit_workflow", "summary": "Project effective limits — buffs + bot create gate metadata.", "title": "Projects Limits Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Cannot read project limits for this workspace", "invalid_parameters": "project_id or workspace_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before fleet/commerce mutations — merged project-plane limits (entity_kind=project). Response: data.effective_limits.limits/features, not nested limits.data. Ecosystem pid=1 uses project plane, not pe", "write_mode": null}, {"action": "projects.readiness.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "budget_note": "Sync CPU-heavy — one per agentstack.execute (mcp_batch 120s). Pair with cheap spine (agents.work_next, agents.plan_get) in separate batches.", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.readiness.get", "related_tools": ["projects.get_project", "generation.supply_status", "knowledge.health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Readiness Get"}, "effect": {"execution_class": "heavy", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "heavy", "instruction_hint": "Before onboarding flows — without full projects.get payload. Single call: inline supply_status + kn…", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_project", "generation.supply_status", "knowledge.health"], "required_cap": "mcp_read", "requires_preflight": false, "returns_hint": "Direct supply gate + knowledge skim (no nested MCP); set include_asset_counts=true only for commerce cardinality.", "risk_class": "read", "safe_action": "projects_readiness_get", "semantic_input_mode": "inherit_workflow", "summary": "Lightweight project readiness — supply + knowledge health skim.", "title": "Projects Readiness Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Cannot read readiness for this workspace", "invalid_parameters": "project_id or workspace_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before onboarding flows — without full projects.get payload. Single call: inline supply_status + knowledge_health (skim); not nested generation.supply_status / knowledge.health executes. Set include_a", "write_mode": null}, {"action": "projects.cancel_deletion", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.safe_deletion.gen1"], "id": "projects.cancel_deletion", "mutation_risk": "low", "related_tools": ["projects.schedule_deletion", "projects.deletion_status", "projects.get_deletion_inventory"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Cancel Deletion"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "After schedule_deletion when the operator aborts the grace period.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.schedule_deletion", "projects.deletion_status", "projects.get_deletion_inventory"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "projects_cancel_deletion", "semantic_input_mode": "inherit_workflow", "summary": "Cancel a scheduled project deletion (PSDP cancel twin).", "title": "Projects Cancel Deletion", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After schedule_deletion when the operator aborts the grace period.", "write_mode": null}, {"action": "projects.deletion_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.safe_deletion.gen1"], "id": "projects.deletion_status", "related_tools": ["projects.cancel_deletion", "projects.get_deletion_inventory"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Deletion Status"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Poll grace-period deletion state without opening the SPA wizard.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.cancel_deletion", "projects.get_deletion_inventory"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_deletion_status", "semantic_input_mode": "inherit_workflow", "summary": "Read PSDP deletion status for a project.", "title": "Projects Deletion Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll grace-period deletion state without opening the SPA wizard.", "write_mode": null}, {"action": "projects.archive", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.safe_deletion.gen1"], "id": "projects.archive", "mutation_risk": "high", "related_tools": ["projects.get_deletion_inventory", "projects.delete_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Archive"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Retire a project without hard delete when archive is preferred.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_deletion_inventory", "projects.delete_project"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "projects_archive", "semantic_input_mode": "inherit_workflow", "summary": "Archive a project (ledger-safe archive twin of POST /archive).", "title": "Projects Archive", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Retire a project without hard delete when archive is preferred.", "write_mode": null}, {"action": "projects.catalog_summaries", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.catalog_summaries.gen1"], "id": "projects.catalog_summaries", "related_tools": ["projects.get_projects", "projects.readiness.get", "projects.get_stats"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Catalog Summaries"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Agent/operator hub parity with GET /projects/catalog-summaries — never N+1 projects.get.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_projects", "projects.readiness.get", "projects.get_stats"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_catalog_summaries", "semantic_input_mode": "inherit_workflow", "summary": "Batch light KPI rows for project catalog tiles (ids max 40).", "title": "Projects Catalog Summaries", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Agent/operator hub parity with GET /projects/catalog-summaries — never N+1 projects.get.", "write_mode": null}, {"action": "projects.import_by_key", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.import_by_key", "mutation_risk": "high", "related_tools": ["projects.get_projects", "apikeys.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Import By Key"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Operator workspace import — treat api_key as secret; prefer SPA import dialog for humans.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_projects", "apikeys.create"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "projects_import_by_key", "semantic_input_mode": "inherit_workflow", "summary": "Import accessible projects using a user API key (operator-sensitive).", "title": "Projects Import By Key", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator workspace import — treat api_key as secret; prefer SPA import dialog for humans.", "write_mode": null}, {"action": "projects.membership.repair", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.projects.member_ops.gen1"], "id": "projects.membership.repair", "mutation_risk": "low", "related_tools": ["projects.get_users", "projects.add_user", "projects.join"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Membership Repair"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "After projects.join rbac_assign_failed — heal accessible_ids before work_next", "request": {"project_id": 123}, "response": {"data": {"membership_verified": true, "owner_user_id": 1, "project_id": 123, "success": true}, "success": true}}], "execution_class": "cheap", "instruction_hint": "When get_users / list lag after invite — heal accessible_ids without a second membership store.", "mutation_kind": "none", "next_actions": ["auth.switch_project when mutation_allowed false", "projects.get_users refresh"], "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.get_users", "projects.add_user", "projects.join"], "required_cap": "project_admin", "requires_preflight": false, "returns_hint": "membership_verified true when owner/member rows and accessible_ids healed.", "risk_class": "low_write", "safe_action": "projects_membership_repair", "semantic_input_mode": "inherit_workflow", "summary": "Repair project membership / accessible_ids lag for the caller.", "title": "Projects Membership Repair", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin required on context.project_id", "invalid_parameters": "project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_implemented": "repair_project_membership endpoint missing on this build", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile / Connect first", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "When get_users / list lag after invite — heal accessible_ids without a second membership store.", "write_mode": null}, {"action": "projects.presets.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.presets.list", "related_tools": ["projects.create_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Projects Presets List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Before create_project when offering template gallery.", "mutation_kind": "none", "onboarding_tier": "bootstrap", "plane": "JSON config: projects.get_data / projects.patch_data. Not files and not site HTML.", "plane_chooser": "Metadata: projects.get_project / projects.update_project. Shared JSON leaves: projects.get_data → projects.patch_data (leaf path + write_mode) → generation.diff_vs_prod → generation.promote — not full data= blob. dna.data.set is an alias for projects.patch_data — never shallow SET/replace of nested objects; use write_mode=merge, deeper dotted paths, or protein patch_paths (repo.engineering.dna_protein_data_plane.gen1). StackScript index/blobs/runtime: script.put / script.run — not ecosystem.scripts via patch_data. Member-private: projects.get_my_data / projects.patch_my_data. Site bytes and files: hosting.* / storage.* — not projects.patch_data.", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_tenant_business_assistant", "agentstack_read_bootstrap", "agentstack_key2unity_site", "agentstack_project_orchestrator"], "related_tools": ["projects.create_project"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "projects_presets_list", "semantic_input_mode": "inherit_workflow", "summary": "List project create presets / templates.", "title": "Projects Presets List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before create_project when offering template gallery.", "write_mode": null}], "rag": [{"action": "rag.health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.health", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Health"}, "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "RAG persistence mode and collection stats for the current project scope.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_health", "semantic_input_mode": "inherit_workflow", "summary": "RAG persistence mode and collection stats for the current project scope.", "title": "Rag Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "RAG persistence mode and collection stats for the current project scope.", "write_mode": null}, {"action": "rag.ingest_job_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.ingest_job_status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Ingest Job Status"}, "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Poll async batch ingest job status (work_queue rag_ingest).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_ingest_job_status", "semantic_input_mode": "inherit_workflow", "summary": "Poll async batch ingest job status (work_queue rag_ingest).", "title": "Rag Ingest Job Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Poll async batch ingest job status (work_queue rag_ingest).", "write_mode": null}, {"action": "rag.ingest_job_cancel", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.ingest_job_cancel", "related_tools": ["rag.ingest_job_status", "rag.document_add_batch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Ingest Job Cancel"}, "domain_title": "Rag MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Abort a long-running ingest before it completes.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.ingest_job_status", "rag.document_add_batch"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "rag_ingest_job_cancel", "semantic_input_mode": "inherit_workflow", "summary": "Cancel a queued or in-flight rag_ingest job (idempotent).", "title": "Rag Ingest Job Cancel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Abort a long-running ingest before it completes.", "write_mode": null}, {"action": "rag.collection_create", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.collection_create", "mutation_risk": "low", "related_tools": ["rag.document_add", "rag.search", "rag.collection_list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Collection Create"}, "domain_title": "Rag MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"description": "Product documentation and FAQ", "embedding_provider": "openai", "home_project_id": 123, "idempotency_key": "example_string", "name": "product-docs"}, "example_request": {"action": "rag.collection_create", "params": {"description": "Product documentation and FAQ", "embedding_provider": "openai", "home_project_id": 123, "idempotency_key": "example_string", "name": "product-docs"}}, "examples": [{"description": "Create a support knowledge base", "params": {"description": "Customer support articles", "name": "support-kb"}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Before adding documents. Create one collection per topic before rag.document_add.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.document_add", "rag.search", "rag.collection_list"], "required_cap": "rag.write", "requires_preflight": false, "risk_class": "low_write", "rollback": ["rag.collection_delete"], "safe_action": "rag_collection_create", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a new RAG knowledge base collection for the current project.", "title": "Rag Collection Create", "tool_chains": ["project_bootstrap", "rag_knowledge_base", "rag_knowledge_base"], "verification": ["rag.collection_get"], "verify": [{"action": "rag.collection_get", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "Enable RAG on project plan before collection_create", "invalid_parameters": "name required; scope must be project or user", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "knowledge_collections_unavailable": "rag.collection_list — archive or upgrade tier", "rag_embed_quota": "buffs.get_effective_limits — pause create until quota resets", "rag_service_unavailable": "RAG engine not configured on this deployment", "rag_tier_limit": "Collection cap reached — archive or upgrade", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Before adding documents. Create one collection per topic before rag.document_add.", "write_mode": null}, {"action": "rag.collection_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.collection_get", "related_tools": ["rag.collection_list", "rag.collection_create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Collection Get"}, "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Verify collection exists after rag.collection_create before ingest.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.collection_list", "rag.collection_create"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_collection_get", "semantic_input_mode": "inherit_workflow", "summary": "Get one RAG collection by id (verify-after-write read model).", "title": "Rag Collection Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify collection exists after rag.collection_create before ingest.", "write_mode": null}, {"action": "rag.collection_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.collection_list", "related_tools": ["rag.collection_create", "rag.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Collection List"}, "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Discover collections before search or ingest.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.collection_create", "rag.search"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_collection_list", "semantic_input_mode": "inherit_workflow", "summary": "List all RAG collections for the current project.", "title": "Rag Collection List", "tool_chains": ["rag_knowledge_base"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover collections before search or ingest.", "write_mode": null}, {"action": "rag.collection_delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Do not delete collections with important data unless explicitly requested", "anti_patterns": ["Do not delete collections with important data unless explicitly requested"], "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.collection_delete", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Collection Delete"}, "domain_title": "Rag MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "example_params": {"collection_id": "example_string", "home_project_id": 123}, "example_request": {"action": "rag.collection_delete", "params": {"collection_id": "example_string", "home_project_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Drop collection and all docs — irreversible.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.write", "requires_preflight": true, "risk_class": "destructive", "rollback": [], "safe_action": "rag_collection_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Delete a RAG collection and all its documents. This is irreversible.", "title": "Rag Collection Delete", "verification": ["rag.collection_list", "knowledge.health"], "verify": [{"action": "rag.collection_list", "predicate": "named resource is visible"}, {"action": "knowledge.health", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drop collection and all docs — irreversible.", "write_mode": null}, {"action": "rag.document_add", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.document_add", "mutation_risk": "low", "related_tools": ["rag.search", "rag.collection_list", "rag.document_delete"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rag Document Add"}, "domain_title": "Rag MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"collection_id": "example_string", "content": "Our return policy allows refunds within 30 days...", "home_project_id": 123, "metadata": {"tags": ["refund", "support"], "type": "policy"}, "source_doc_id": "article-42"}, "example_request": {"action": "rag.document_add", "params": {"collection_id": "example_string", "content": "Our return policy allows refunds within 30 days...", "home_project_id": 123, "metadata": {"tags": ["refund", "support"], "type": "policy"}, "source_doc_id": "article-42"}}, "examples": [{"description": "Add a support article", "params": {"collection_id": "coll-uuid", "content": "How to reset your password...", "metadata": {"tags": ["password", "account"], "type": "support"}}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Index text into a collection — prefer over raw storage for semantic search.", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["rag.ingest_job_status"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.search", "rag.collection_list", "rag.document_delete"], "required_cap": "rag.write", "requires_preflight": false, "risk_class": "low_write", "rollback": ["rag.document_delete"], "safe_action": "rag_document_add", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Add a text document to a RAG collection.", "title": "Rag Document Add", "tool_chains": ["rag_knowledge_base"], "verification": ["rag.search", "rag.collection_list"], "verify": [{"action": "rag.search", "predicate": "named resource is visible"}, {"action": "rag.collection_list", "predicate": "named resource is visible"}], "when_blocked": {"collection_not_found": "rag.collection_create with stable collection_id first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "content and collection_id are required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "rag.collection_create then rag.collection_get before document_add", "permission_denied": "RBAC or collection access denied for this project", "rag_embed_quota": "buffs.get_effective_limits before retrying ingest", "rag_embed_rate_limit": "HTTP 429 — stop ingest loop; knowledge.doctor.run", "rag_service_unavailable": "RAG engine not configured on this deployment", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Index text into a collection — prefer over raw storage for semantic search.", "write_mode": null}, {"action": "rag.document_add_batch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.document_add_batch", "related_tools": ["rag.collection_get", "rag.ingest_job_status", "rag.search", "knowledge.kb.ingest"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Document Add Batch"}, "domain_title": "Rag MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Bulk mentor KB ingest after collection_create.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.collection_get", "rag.ingest_job_status", "rag.search", "knowledge.kb.ingest"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "rag_document_add_batch", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Add multiple documents to a RAG collection in one call.", "title": "Rag Document Add Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk mentor KB ingest after collection_create.", "write_mode": null}, {"action": "rag.document_list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.document_list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Document List"}, "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "List document chunks in a collection (default 50, max 1000, same as REST). vector_compressed is omi…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_document_list", "semantic_input_mode": "inherit_workflow", "summary": "List document chunks in a collection (default 50, max 1000, same as REST). vector_compressed is omitted. A long text is an envelope preview, not the chunk.", "title": "Rag Document List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List document chunks in a collection (default 50, max 1000, same as REST). vector_compressed is omitted. A long text is an envelope preview, not the chunk.", "write_mode": null}, {"action": "rag.document_delete", "aliases": ["knowledge.document.delete"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.document_delete", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Document Delete"}, "domain_title": "Rag MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Remove one document from a collection.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.write", "requires_preflight": true, "risk_class": "destructive", "safe_action": "rag_document_delete", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Remove a document (all its chunks) from a collection by source_doc_id.", "title": "Rag Document Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove one document from a collection.", "write_mode": null}, {"action": "rag.ingest_from_storage", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.ingest_from_storage", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Ingest From Storage"}, "domain_title": "Rag MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Ingest text extracted from a Storage file into a RAG collection.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "rag_ingest_from_storage", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Ingest text extracted from a Storage file into a RAG collection.", "title": "Rag Ingest From Storage", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ingest text extracted from a Storage file into a RAG collection.", "write_mode": null}, {"action": "rag.export", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.export", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Export"}, "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Export accessible collection chunks (default 5000), access-tier filtered. A long text is an envelop…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_export", "semantic_input_mode": "inherit_workflow", "summary": "Export accessible collection chunks (default 5000), access-tier filtered. A long text is an envelope preview, not the chunk.", "title": "Rag Export", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export accessible collection chunks (default 5000), access-tier filtered. A long text is an envelope preview, not the chunk.", "write_mode": null}, {"action": "rag.warm", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.warm", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Warm"}, "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Pre-load collection vectors into process L1 before search traffic.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_warm", "semantic_input_mode": "inherit_workflow", "summary": "Pre-load collection vectors into process L1 before search traffic.", "title": "Rag Warm", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pre-load collection vectors into process L1 before search traffic.", "write_mode": null}, {"action": "rag.search", "aliases": ["knowledge.search"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.search", "related_tools": ["rag.collection_list", "rag.document_add", "rag.memory_search"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rag Search"}, "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"collection_id": "knowledge_kb", "filters": {"type": "support"}, "home_project_id": 123, "hybrid": true, "mmr": false, "query": "how do I reset my password?", "top_k": 5}, "example_request": {"action": "rag.search", "params": {"collection_id": "knowledge_kb", "filters": {"type": "support"}, "home_project_id": 123, "hybrid": true, "mmr": false, "query": "how do I reset my password?", "top_k": 5}}, "examples": [{"description": "Search project knowledge_kb by stable id", "params": {"collection_id": "knowledge_kb", "hybrid": true, "query": "how do I get a refund?", "top_k": 3}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Hybrid semantic + BM25 search — ground agent answers in project docs.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.collection_list", "rag.document_add", "rag.memory_search"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_search", "semantic_input_mode": "inherit_workflow", "summary": "Semantic search over a RAG collection.", "title": "Rag Search", "tool_chains": ["rag_knowledge_base"], "when_blocked": {"collection_not_found": "rag.collection_create or knowledge.kb.ingest first", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "feature_not_available": "RAG not on plan — discovery.describe rag.search effect", "forbidden": "RBAC or collection access denied for this project", "invalid_parameters": "collection_id and query required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rag_tier_limit": "Upgrade tier or reduce top_k; buffs.get_effective_limits", "rag_unavailable": "RAG engine not configured on this deployment", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Hybrid semantic + BM25 search — ground agent answers in project docs.", "write_mode": null}, {"action": "rag.memory_add", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.memory_add", "mutation_risk": "low", "related_tools": ["rag.memory_search", "rag.memory_get", "rag.search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Memory Add"}, "do_not_use_when": "Project documents belong in knowledge.kb.ingest, not agent memory.", "domain_title": "Rag MCP domain", "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Store user message", "params": {"content": "How do I add payments?", "role": "user", "session_id": "sess-123"}}], "execution_class": "cheap", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Store conversation turn in scoped agent memory (TurboQuant).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.memory_search", "rag.memory_get", "rag.search"], "required_cap": "rag.write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "rag_memory_add", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Store a conversation turn in AI memory.", "title": "Rag Memory Add", "tool_chains": ["rag_knowledge_base"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "rag_tier_limit": "Memory quota — rag.memory_list then prune stale rows", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Project documents belong in knowledge.kb.ingest, not agent memory.", "when_to_use": "Store conversation turn in scoped agent memory (TurboQuant).", "write_mode": null}, {"action": "rag.memory_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.memory_get", "related_tools": ["rag.memory_add", "rag.memory_search"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Memory Get"}, "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Recent memory turns for the active session.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.memory_add", "rag.memory_search"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_memory_get", "semantic_input_mode": "inherit_workflow", "summary": "Get the most recent conversation turns from memory (chronological order).", "title": "Rag Memory Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Recent memory turns for the active session.", "write_mode": null}, {"action": "rag.memory_search", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "rag", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.memory_search", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rag Memory Search"}, "domain_title": "Rag MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Find past discussion about payments", "params": {"query": "payment integration", "session_id": "sess-123", "top_k": 3}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Semantic recall over past turns — combine with rag.search for KB.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "owner_gene": "core.mcp.rag.gen1", "plane": "Docs: rag.search or knowledge.health. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model. HTTP 429: stop retrying ingest.", "plane_chooser": "Search with rag.search. Stop ingest when the embedder returns HTTP 429. Project docs are knowledge/rag. Conversation memory is rag.memory_*. User personal data is a user leaf. Business state is the business read model.", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "requires_preflight": false, "risk_class": "read", "safe_action": "rag_memory_search", "semantic_input_mode": "inherit_workflow", "summary": "Semantically search past conversation turns.", "title": "Rag Memory Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Semantic recall over past turns — combine with rag.search for KB.", "write_mode": null}], "rbac": [{"action": "rbac.get_roles", "aliases": ["rbac.list_permissions"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "rbac.get_roles", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rbac Get Roles"}, "domain_title": "Rbac MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rbac.gen1"], "instruction_hint": "List project roles before assign_role or revoke_role.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rbac", "owner_gene": "core.mcp.rbac.gen1", "plane": "Roles: rbac.get_roles.", "plane_chooser": "Field policy is data_access.set_policy, not a new permission table.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "rbac_get_roles", "semantic_input_mode": "inherit_workflow", "summary": "Get list of roles for a project (system + custom). Returns id, name, permissions_bitmap, permissions, is_system.", "title": "Rbac Get Roles", "tool_chains": ["rbac_manage_members"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List project roles before assign_role or revoke_role.", "write_mode": null}, {"action": "rbac.assign_role", "aliases": ["auth.assign_role"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "rbac.assign_role", "related_tools": ["rbac.get_roles", "rbac.revoke_role", "projects.get_users"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rbac Assign Role"}, "domain_title": "Rbac MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.rbac.gen1"], "instruction_hint": "Grant role to member — cannot assign owner via this tool.", "kind": "mcp_domain", "mutation_kind": "none", "next_actions": ["rbac.get_roles", "projects.get_users"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.rbac", "owner_gene": "core.mcp.rbac.gen1", "plane": "Roles: rbac.get_roles.", "plane_chooser": "Field policy is data_access.set_policy, not a new permission table.", "related_tools": ["rbac.get_roles", "rbac.revoke_role", "projects.get_users"], "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "access_control", "safe_action": "rbac_assign_role", "semantic_input_mode": "inherit_workflow", "summary": "Assign a role to a user in a project. Requires manage_users or owner. Cannot assign owner via this tool.", "title": "Rbac Assign Role", "tool_chains": ["crud_with_logic", "content_access_control", "multi_tenant_onboarding"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Caller needs project_admin — auth.get_profile for caps", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "owner_assign_denied": "Owner role is immutable — use project transfer flows, not rbac.assign_role", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "user_not_in_project": "User not in project"}, "when_to_use": "Grant role to member — cannot assign owner via this tool.", "write_mode": null}, {"action": "rbac.revoke_role", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "rbac.revoke_role", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rbac Revoke Role"}, "domain_title": "Rbac MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.rbac.gen1"], "instruction_hint": "Revoke role; user falls back to viewer.", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["rbac.get_roles", "projects.get_users"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.rbac", "owner_gene": "core.mcp.rbac.gen1", "plane": "Roles: rbac.get_roles.", "plane_chooser": "Field policy is data_access.set_policy, not a new permission table.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "rbac_revoke_role", "semantic_input_mode": "inherit_workflow", "summary": "Revoke a role from a user in a project. User will get default viewer role. Requires manage_users or owner. Cannot revoke owner.", "title": "Rbac Revoke Role", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin required — rbac.get_roles to confirm target role", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke role; user falls back to viewer.", "write_mode": null}, {"action": "rbac.check_permission", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Field-level policy is data_access.set_policy — not rbac.check_permission on every leaf read.", "Do not scatter permission tables in app code — use FAP + rbac at boundaries."], "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "rbac.check_permission", "related_tools": ["rbac.get_roles", "rbac.assign_role", "data_access.set_policy"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rbac Check Permission"}, "domain_title": "Rbac MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "genetic_tags": ["core.mcp.rbac.gen1"], "instruction_hint": "Gate UI or server branch — prefer over scattering role checks.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rbac", "owner_gene": "core.mcp.rbac.gen1", "plane": "Roles: rbac.get_roles.", "plane_chooser": "Field policy is data_access.set_policy, not a new permission table.", "related_tools": ["rbac.get_roles", "rbac.assign_role", "data_access.set_policy"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "rbac_check_permission", "semantic_input_mode": "inherit_workflow", "summary": "Check if a user has a permission in a project. If user_id is omitted, checks current user.", "title": "Rbac Check Permission", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "permission_denied": "Membership or role insufficient — permissions.effective action=<tool> for L1+L2 stack.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile before rbac.check_permission.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Gate UI or server branch — prefer over scattering role checks.", "write_mode": null}], "rooms": [{"action": "rooms.quick_match", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "intermediate", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.quick_match", "related_tools": ["rooms.poll_events", "rooms.match_status", "stream.relay.ws_ticket", "rooms.leave", "script.run"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rooms Quick Match", "visitor_callable": true}, "do_not_use_when": "Not for Nahual-style DNA coop (`nhl.s*.open` without qm:) — use script.run only. Not for persisted relay rooms — use stream.relay.create_room first. Not on operator MCP without hosted session for /s/{pid}/ players.", "domain_title": "Rooms MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"batch_semantic_anchor_required": "Set options.execution_intent=direct or use /s/{pid}/mcp — not raw operator batch without anchor. → next: preflight.check", "hosted_app_required": "Player path: mint hosted session cookie, then rooms.* on /s/{pid}/mcp. → next: discovery.describe", "hosted_cookie_missing": "POST /api/hosted-apps/{pid}/session on /s/{pid}/ then call hosted MCP ingress. → next: discovery.describe", "invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "join_failed": "Runtime room join failed — rooms.leave then rooms.quick_match with new idempotency_key. → next: rooms.quick_match", "match_full": "No open seats — new quick_match or wait bot_fill / poll_events. → next: rooms.poll_events", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match", "match_provisioning": "Lobby room is still being created — retry quick_match or join_by_code in ~200ms (same idempotency_key). → next: rooms.quick_match", "not_seated": "quick_match returned a match without a seat — rooms.leave then quick_match with a new idempotency_key. → next: rooms.quick_match", "room_create_failed": "Could not allocate relay room — retry or lower concurrent matches. → next: rooms.quick_match", "room_table_full": "In-process room table full — rooms.leave stale matches, then rooms.quick_match. → next: rooms.leave", "service_cap_denied": "Hosted MCP needs session cookie (POST /api/hosted-apps/{pid}/session) — not API key alone on /s/{pid}/mcp. → next: auth.get_profile", "unauthorized": "MCP context missing user_id — auth.get_profile or hosted session. → next: auth.get_profile"}, "example_params": {"bot_fill_after_ms": 15000, "idempotency_key": "example_string", "invite": "example_string", "match_id": "example_string", "mode": "1v1", "project_id": 123, "region": "example_string", "script_id": "example_string", "skill": 123.45}, "example_request": {"action": "rooms.quick_match", "params": {"bot_fill_after_ms": 15000, "idempotency_key": "example_string", "invite": "example_string", "match_id": "example_string", "mode": "1v1", "project_id": 123, "region": "example_string", "script_id": "example_string", "skill": 123.45}}, "examples": [{"action": "rooms.quick_match", "params": {"bot_fill_after_ms": 15000, "idempotency_key": "click-abc", "mode": "1v1", "project_id": 2052, "script_id": "wt-match"}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.rooms.gen1", "core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "One-click find-or-create seat (idempotency_key). Then rooms.poll_events; optional stream.relay.ws_t…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rooms", "owner_gene": "core.mcp.rooms.gen1", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["rooms.poll_events", "rooms.match_status", "stream.relay.ws_ticket", "rooms.leave", "script.run"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "read", "safe_action": "rooms_quick_match", "semantic_input_mode": "inherit_workflow", "summary": "Atomic find-or-create match seat for hosted games (1v1/2v2/ffa4). Idempotent via idempotency_key. Bot-fill after bot_fill_after_ms or fill_with_bot.", "title": "Rooms Quick Match", "when_blocked": {"batch_semantic_anchor_required": "options.execution_intent=direct or use /s/{pid}/mcp hosted ingress", "hosted_app_required": "POST /api/hosted-apps/{pid}/session then /s/{pid}/mcp", "hosted_cookie_missing": "Same as hosted_app_required — mint cookie", "invalid_parameters": "project_id, script_id, authenticated user_id", "join_failed": "Retry idempotency_key or rooms.match_status", "match_full": "re-queue with new idempotency_key", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match", "match_provisioning": "Lobby still starting — retry in ~200ms with same idempotency_key", "not_seated": "rooms.leave then quick_match with new idempotency_key", "room_create_failed": "Check script_id + hosted_mcp config", "room_table_full": "Leave stale match or wait GC — rooms.leave", "service_cap_denied": "POST /api/hosted-apps/{pid}/session — hosted cookie + shell_read caps", "unauthorized": "auth.get_profile or hosted session"}, "when_not_to_use": "Not for Nahual-style DNA coop (`nhl.s*.open` without qm:) — use script.run only. Not for persisted relay rooms — use stream.relay.create_room first. Not on operator MCP without hosted session for /s/{pid}/ players.", "when_to_use": "One-click find-or-create seat (idempotency_key). Then rooms.poll_events; optional stream.relay.ws_ticket for THERMO realtime.", "write_mode": null}, {"action": "rooms.leave", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "simple", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.leave", "related_tools": ["rooms.quick_match"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rooms Leave", "visitor_callable": true}, "do_not_use_when": "Not for DNA-only coop — no QM seat to release.", "domain_title": "Rooms MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match"}, "example_params": {"match_id": "example_string", "project_id": 123, "room_id": "example_string"}, "example_request": {"action": "rooms.leave", "params": {"match_id": "example_string", "project_id": 123, "room_id": "example_string"}}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rooms.gen1", "core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Free a seat; empty matches close (TTL GC).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rooms", "owner_gene": "core.mcp.rooms.gen1", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["rooms.quick_match"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "read", "safe_action": "rooms_leave", "semantic_input_mode": "inherit_workflow", "summary": "Leave a quick-match seat; empty matches close (TTL GC also applies).", "title": "Rooms Leave", "when_blocked": {"invalid_parameters": "match_id or room_id", "match_not_found": "rooms.quick_match"}, "when_not_to_use": "Not for DNA-only coop — no QM seat to release.", "when_to_use": "Free a seat; empty matches close (TTL GC).", "write_mode": null}, {"action": "rooms.poll_events", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "simple", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.poll_events", "related_tools": ["rooms.quick_match", "rooms.match_status", "stream.relay.ws_ticket"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rooms Poll Events", "visitor_callable": true}, "do_not_use_when": "Not without match_id from quick_match or join_by_code.", "domain_title": "Rooms MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match", "not_a_participant": "Only seated players may poll or open ws_ticket — rooms.quick_match first. → next: rooms.quick_match"}, "example_params": {"after_ts": 0, "limit": 32, "match_id": "example_string", "room_id": "example_string"}, "example_request": {"action": "rooms.poll_events", "params": {"after_ts": 0, "limit": 32, "match_id": "example_string", "room_id": "example_string"}}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rooms.gen1", "core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Long-poll match events (player_seated/bot_seated/started). WS fallback plane.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rooms", "owner_gene": "core.mcp.rooms.gen1", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["rooms.quick_match", "rooms.match_status", "stream.relay.ws_ticket"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "rooms_poll_events", "semantic_input_mode": "inherit_workflow", "summary": "Poll match events (player_seated, bot_seated, started, player_left). Also soft-triggers bot fill when bot_fill_after_ms elapsed. WS fallback plane.", "title": "Rooms Poll Events", "when_blocked": {"invalid_parameters": "match_id or room_id + user_id", "match_not_found": "rooms.quick_match", "not_a_participant": "rooms.quick_match first"}, "when_not_to_use": "Not without match_id from quick_match or join_by_code.", "when_to_use": "Long-poll match events (player_seated/bot_seated/started). WS fallback plane.", "write_mode": null}, {"action": "rooms.match_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "simple", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.match_status", "related_tools": ["rooms.quick_match", "rooms.poll_events"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Rooms Match Status", "visitor_callable": true}, "do_not_use_when": "Read-only — use rooms.poll_events when you need events.", "domain_title": "Rooms MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match", "not_a_participant": "Only seated players may poll or open ws_ticket — rooms.quick_match first. → next: rooms.quick_match"}, "example_params": {"match_id": "example_string", "project_id": 123}, "example_request": {"action": "rooms.match_status", "params": {"match_id": "example_string", "project_id": 123}}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rooms.gen1", "core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Read seat/status by match_id without mutating.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rooms", "owner_gene": "core.mcp.rooms.gen1", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["rooms.quick_match", "rooms.poll_events"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "rooms_match_status", "semantic_input_mode": "inherit_workflow", "summary": "Read quick-match status by match_id.", "title": "Rooms Match Status", "when_blocked": {"invalid_parameters": "match_id", "match_not_found": "rooms.quick_match", "not_a_participant": "rooms.quick_match"}, "when_not_to_use": "Read-only — use rooms.poll_events when you need events.", "when_to_use": "Read seat/status by match_id without mutating.", "write_mode": null}, {"action": "rooms.create", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "intermediate", "domain": "games", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.create", "related_tools": ["rooms.join_by_code", "rooms.list_open", "rooms.poll_events"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rooms Create", "visitor_callable": true}, "do_not_use_when": "Not for one-click open pool — use rooms.quick_match. Guests cannot host.", "domain_title": "Rooms MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required_to_host": "Custom lobby host requires sign-in — guests use rooms.quick_match or join_by_code. → next: auth.login", "invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "room_create_failed": "Could not allocate relay room — retry or lower concurrent matches. → next: rooms.quick_match", "room_table_full": "In-process room table full — rooms.leave stale matches, then rooms.quick_match. → next: rooms.leave", "service_cap_denied": "Hosted MCP needs session cookie (POST /api/hosted-apps/{pid}/session) — not API key alone on /s/{pid}/mcp. → next: auth.get_profile"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.rooms.gen1", "core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Signed-in host creates a lobby with invite_code; pair with list_open or private code share.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rooms", "owner_gene": "core.mcp.rooms.gen1", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["rooms.join_by_code", "rooms.list_open", "rooms.poll_events"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "rooms_create", "semantic_input_mode": "inherit_workflow", "summary": "Create a custom lobby (host seat). Signed-in players only — guests use quick_match or join_by_code.", "title": "Rooms Create", "when_blocked": {"auth_required_to_host": "auth.login — guests use quick_match or join_by_code", "invalid_parameters": "script_id + authenticated user_id", "room_create_failed": "Retry script_id + relay capacity", "room_table_full": "rooms.leave stale matches", "service_cap_denied": "Mint POST /api/hosted-apps/{pid}/session — hosted cookie + hosted_shell_read caps"}, "when_not_to_use": "Not for one-click open pool — use rooms.quick_match. Guests cannot host.", "when_to_use": "Signed-in host creates a lobby with invite_code; pair with list_open or private code share.", "write_mode": null}, {"action": "rooms.list_open", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "simple", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.list_open", "related_tools": ["rooms.join_by_code", "rooms.quick_match"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rooms List Open", "visitor_callable": true}, "do_not_use_when": "Not for anonymous quick pool — use rooms.quick_match.", "domain_title": "Rooms MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rooms.gen1", "core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Browse public waiting lobbies before join_by_code or quick_match.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rooms", "owner_gene": "core.mcp.rooms.gen1", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["rooms.join_by_code", "rooms.quick_match"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "rooms_list_open", "semantic_input_mode": "inherit_workflow", "summary": "List public waiting lobbies (no private invite-only rooms).", "title": "Rooms List Open", "when_blocked": {"invalid_parameters": "project_id"}, "when_not_to_use": "Not for anonymous quick pool — use rooms.quick_match.", "when_to_use": "Browse public waiting lobbies before join_by_code or quick_match.", "write_mode": null}, {"action": "rooms.join_by_code", "aliases": ["room.join", "rooms.join"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "simple", "domain": "games", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "rooms.join_by_code", "related_tools": ["rooms.create", "rooms.poll_events", "stream.relay.ws_ticket"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Rooms Join By Code", "visitor_callable": true}, "do_not_use_when": "Not for anonymous open pool — use rooms.quick_match unless you have invite_code.", "domain_title": "Rooms MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "invite_not_found": "Unknown invite_code — ask host to re-share invite_code from rooms.create. → next: rooms.list_open", "join_failed": "Runtime room join failed — rooms.leave then rooms.quick_match with new idempotency_key. → next: rooms.quick_match", "match_full": "No open seats — new quick_match or wait bot_fill / poll_events. → next: rooms.poll_events", "match_provisioning": "Lobby room is still being created — retry quick_match or join_by_code in ~200ms (same idempotency_key). → next: rooms.quick_match"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.rooms.gen1", "core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Guest joins host lobby using invite_code from rooms.create.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rooms", "owner_gene": "core.mcp.rooms.gen1", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["rooms.create", "rooms.poll_events", "stream.relay.ws_ticket"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "read", "safe_action": "rooms_join_by_code", "semantic_input_mode": "inherit_workflow", "summary": "Join a lobby by invite_code from rooms.create (guest-friendly).", "title": "Rooms Join By Code", "when_blocked": {"invalid_parameters": "invite_code + user_id", "invite_not_found": "rooms.list_open or ask host", "join_failed": "rooms.leave then retry", "match_full": "rooms.quick_match", "match_provisioning": "Lobby still starting — retry join_by_code in ~200ms"}, "when_not_to_use": "Not for anonymous open pool — use rooms.quick_match unless you have invite_code.", "when_to_use": "Guest joins host lobby using invite_code from rooms.create.", "write_mode": null}], "safety": [{"action": "safety.evaluate", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.safety.gen1"], "id": "safety.evaluate", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Safety Evaluate"}, "domain_title": "Safety MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "evaluate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "evaluate", "execution_class": "plain_read", "genetic_tags": ["core.mcp.safety.gen1"], "instruction_hint": "Score user or model text against the project safety policy and return a verdict.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.safety", "owner_gene": "core.mcp.safety.gen1", "plane": "Safety probe: safety.evaluate — rules-first verdict; tenant overlays via generation plane.", "plane_chooser": "Probe one text: safety.evaluate (bots_run cap). Rules-first verdict — not a second safety LLM. Tenant playbook overlays: knowledge.config.patch + generation.promote — not raw prod DNA scripts.", "related_prompts": ["agentstack_knowledge_safety_tune"], "required_cap": "bots_run", "requires_preflight": false, "risk_class": "read", "safe_action": "safety_evaluate", "semantic_input_mode": "inherit_workflow", "summary": "Score user or model text against the project safety policy and return a verdict.", "title": "Safety Evaluate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Score user or model text against the project safety policy and return a verdict.", "write_mode": null}], "scheduler": [{"action": "scheduler.create_task", "aliases": ["scheduler.schedule_task"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Do not create_task to cancel — use scheduler.cancel_task."], "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.create_task", "mutation_risk": "low", "related_tools": ["scheduler.list_tasks", "scheduler.get_task", "scheduler.cancel_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Create Task"}, "channel_pass_sweep_task_example": {"cron": "15 * * * *", "enabled": true, "name": "channel_pass_sweep", "payload": {"action": "commerce.channel_pass.sweep", "project_id": "<context.project_id>"}}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"command": "backup_database", "cron": "0 0 * * *", "enabled": true, "execute_at": "2026-09-28T10:00:00Z", "name": "Daily Backup", "payload": {}, "timezone": "UTC"}, "example_request": {"action": "scheduler.create_task", "params": {"command": "backup_database", "cron": "0 0 * * *", "enabled": true, "execute_at": "2026-09-28T10:00:00Z", "name": "Daily Backup", "payload": {}, "timezone": "UTC"}}, "examples": [{"description": "Create a task that runs daily at midnight", "name": "Create daily task", "request": {"command": "backup_database", "cron": "0 0 * * *", "enabled": true, "name": "Daily Backup"}, "response": {"data": {"command": "backup_database", "committed": true, "created_at": "2025-01-20T10:00:00Z", "created_by": 1, "cron": "0 0 * * *", "enabled": true, "id": "task_20250120_100000_000000", "name": "Daily Backup", "project_id": 123, "state": "ready", "task_id": "task_20250120_100000_000000"}, "success": true}}, {"description": "Create a task that runs every Monday at 9 AM", "name": "Create weekly task", "request": {"command": "generate_weekly_report", "cron": "0 9 * * 1", "enabled": true, "name": "Weekly Report"}, "response": {"data": {"command": "generate_weekly_report", "committed": true, "created_at": "2025-01-20T10:00:00Z", "created_by": 1, "cron": "0 9 * * 1", "enabled": true, "id": "task_20250120_100100_000000", "name": "Weekly Report", "project_id": 123, "state": "ready", "task_id": "task_20250120_100100_000000"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Recurring cron or one execute_at. Timezone only shifts the next cron fire. Not Celery/BullMQ.", "mutation_kind": "entity", "next_actions": ["scheduler.get_task"], "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_commerce_actions": ["commerce.channel_pass.configure", "commerce.channel_pass.sweep"], "related_tools": ["scheduler.list_tasks", "scheduler.get_task", "scheduler.cancel_task"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "low_write", "rollback": ["scheduler.cancel_task", "scheduler.delete_task"], "safe_action": "scheduler_create_task", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Create a new scheduled task for automated execution.", "title": "Create Scheduled Task", "tool_chains": ["scheduled_rewards", "payment_to_subscription", "project_bootstrap"], "verification": ["scheduler.list_tasks", "scheduler.get_task"], "verify": [{"action": "scheduler.list_tasks", "predicate": "named resource is visible"}, {"action": "scheduler.get_task", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; scheduler.list_tasks then scheduler.get_task receipt id", "insufficient_permissions": "rbac.check_permission or widen service_caps scheduler", "invalid_cron": "Five-field cron (minute hour day month weekday) — not interval prose", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "name_required": "Pass non-empty name before cron or execute_at", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Recurring cron or one execute_at. Timezone only shifts the next cron fire. Not Celery/BullMQ.", "write_mode": null}, {"action": "scheduler.get_task", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.get_task", "related_tools": ["scheduler.list_tasks", "scheduler.create_task", "scheduler.execute_task", "scheduler.update_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Get Task"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve complete task information using task ID", "name": "Get task by ID", "request": {"task_id": "task_20251230_125227_681021"}, "response": {"data": {"action": "backup_database", "command": "backup_database", "created_at": "2025-01-20T10:00:00Z", "created_by": 1, "cron": "0 0 * * *", "description": "", "effective_scope": {"env_uuid": null, "plane": "scheduler", "project_id": 123, "selection_source": "prod", "visibility": "committed"}, "enabled": true, "execute_at": "2025-01-21T00:00:00Z", "id": "task_20251230_125227_681021", "is_active": true, "name": "Daily Backup", "not_runnable_reason": null, "payload": {}, "project_id": 123, "runnable": true, "saved": true, "schedule": "0 0 * * *", "status": "created", "task_type": "recurring", "timezone": "UTC"}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Inspect one task schedule and payload.", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.list_tasks", "scheduler.create_task", "scheduler.execute_task", "scheduler.update_task"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "read", "safe_action": "scheduler_get_task", "semantic_input_mode": "inherit_workflow", "summary": "Get detailed information about a scheduled task by ID.", "title": "Scheduler Get Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Current user does not have permission to view this task", "invalid_parameters": "Task ID is missing or invalid format", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task with specified ID does not exist or is not accessible", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Inspect one task schedule and payload.", "write_mode": null}, {"action": "scheduler.update_task", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.update_task", "mutation_risk": "low", "related_tools": ["scheduler.get_task", "scheduler.create_task", "scheduler.cancel_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Update Task"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Change cron or payload on existing task.", "mutation_kind": "entity", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.get_task", "scheduler.create_task", "scheduler.cancel_task"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "low_write", "safe_action": "scheduler_update_task", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Update an existing scheduler task (requires write permission).", "title": "Scheduler Update Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Insufficient permissions for task update", "invalid_parameters": "task_id, project_id, or task_data missing or invalid", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Project not found", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task not found", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Change cron or payload on existing task.", "write_mode": null}, {"action": "scheduler.list_tasks", "aliases": ["scheduler.list", "scheduler.status"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.list_tasks", "related_tools": ["scheduler.get_task", "scheduler.cancel_task", "scheduler.update_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler List Tasks"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Get all scheduled tasks for the current project", "name": "List tasks for current project", "request": {}, "response": {"data": {"count": 1, "effective_scope": {"env_uuid": null, "plane": "scheduler", "project_id": 123, "selection_source": "prod", "visibility": "committed"}, "has_more": false, "project_id": 123, "readiness": "ready", "tasks": [{"command": "backup_database", "created_at": "2025-01-20T10:00:00Z", "created_by": 1, "cron": "0 0 * * *", "enabled": true, "execute_at": "2025-01-21T00:00:00Z", "id": "task_20251230_125227_681021", "name": "Daily Backup", "project_id": 123, "status": "created"}], "timestamp": "2025-01-20T10:00:00Z", "total": 1}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Audit scheduled tasks before cancel or update.", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.get_task", "scheduler.cancel_task", "scheduler.update_task"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "read", "safe_action": "scheduler_list_tasks", "semantic_input_mode": "inherit_workflow", "summary": "List all scheduled tasks for a project.", "title": "Scheduler List Tasks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Need scheduler cap on API key or project membership", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_not_found": "Bind context.project_id — projects.get_project", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit scheduled tasks before cancel or update.", "write_mode": null}, {"action": "scheduler.execute_task", "aliases": ["scheduler.run_now"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.execute_task", "mutation_risk": "low", "related_tools": ["scheduler.get_task", "scheduler.create_task", "scheduler.list_tasks", "scheduler.get_pool_tasks", "scheduler.cancel_task"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Scheduler Execute Task"}, "effect": {"audit_batch_allowed": true, "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"task_id": "task_20250120_100000_000000"}, "example_request": {"action": "scheduler.execute_task", "params": {"task_id": "task_20250120_100000_000000"}}, "examples": [{"description": "Trigger immediate execution of a scheduled task", "name": "Execute task immediately", "request": {"task_id": "task_20250120_100000_000000"}, "response": {"data": {"execution": {"executed_at": "2026-10-08T12:00:00+00:00", "executed_by": 7, "result": "Task executed successfully", "status": "executed", "task_id": "task_20250120_100000_000000", "task_name": "Nightly sync"}, "success": true, "timestamp": "2026-10-08T12:00:00+00:00"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Manual fire of scheduled task (ops/debug).", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.get_task", "scheduler.create_task", "scheduler.list_tasks", "scheduler.get_pool_tasks", "scheduler.cancel_task"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "low_write", "safe_action": "scheduler_execute_task", "semantic_input_mode": "inherit_workflow", "summary": "Execute a scheduled task immediately, bypassing the cron schedule.", "title": "Scheduler Execute Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Task execution failed. Check error message for details", "insufficient_permissions": "Current user does not have permission to execute this task", "invalid_parameters": "task_id or project_id missing or invalid", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_disabled": "Task is disabled and cannot be executed. Enable the task first", "task_not_found": "Task with specified ID does not exist or is not accessible", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Manual fire of scheduled task (ops/debug).", "write_mode": null}, {"action": "scheduler.get_pool_tasks", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.get_pool_tasks", "related_tools": ["scheduler.get_pool_task_details", "scheduler.delete_pool_task", "scheduler.clear_pool_tasks", "scheduler.refresh_pool"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Get Pool Tasks"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve all tasks currently in the execution pool", "name": "Get all pool tasks", "request": {}, "response": {"data": {"stats": {"future_count": 0, "last_refill_time": 1737360000.0, "max_pool_size": 10000, "pool_size": 1, "ready_count": 0, "refill_interval": 1200, "upcoming_count": 1, "window_minutes": 30}, "success": true, "tasks": [{"created_at": "2025-01-20T10:00:00Z", "description": "Backup database daily", "execute_at": "2025-01-20T10:30:00Z", "logic_id": "logic-1", "name": "Daily Backup", "priority": 5, "project_id": 123, "scheduler_id": "sched-1", "task_id": "scheduler_123_abc", "task_type": "scheduler"}], "timestamp": "2025-01-20T10:00:00Z", "total": 1}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Scheduler pool queue — ops visibility.", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.get_pool_task_details", "scheduler.delete_pool_task", "scheduler.clear_pool_tasks", "scheduler.refresh_pool"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "read", "safe_action": "scheduler_get_pool_tasks", "semantic_input_mode": "inherit_workflow", "summary": "Get all tasks from the execution pool (in-memory task queue).", "title": "Scheduler Get Pool Tasks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Failed to retrieve pool tasks", "insufficient_permissions": "Current user does not have permission to view pool tasks", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Scheduler pool queue — ops visibility.", "write_mode": null}, {"action": "scheduler.get_pool_task_details", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.get_pool_task_details", "related_tools": ["scheduler.get_pool_tasks", "scheduler.delete_pool_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Get Pool Task Details"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve detailed information about a task in the execution pool", "name": "Get pool task details", "request": {"task_id": "scheduler_123_abc"}, "response": {"data": {"task": {"created_at": "2025-01-20T10:00:00Z", "execute_at": "2025-01-20T10:30:00Z", "logic_id": "123", "priority": 5, "project_id": 123, "scheduler": {"id": "abc", "name": "Daily Backup", "schedule": {"cron": "0 0 * * *"}}, "scheduler_id": "abc", "task_id": "scheduler_123_abc", "task_type": "scheduler"}}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "Deep inspect one pooled task.", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.get_pool_tasks", "scheduler.delete_pool_task"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "read", "safe_action": "scheduler_get_pool_task_details", "semantic_input_mode": "inherit_workflow", "summary": "Get detailed information about a specific task from the execution pool.", "title": "Scheduler Get Pool Task Details", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Current user does not have permission to view this task", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task with specified ID not found in pool", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Deep inspect one pooled task.", "write_mode": null}, {"action": "scheduler.delete_pool_task", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.delete_pool_task", "mutation_risk": "low", "related_tools": ["scheduler.get_pool_tasks", "scheduler.clear_pool_tasks", "scheduler.cancel_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Delete Pool Task"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Remove a task from the execution pool", "name": "Delete pool task", "request": {"task_id": "scheduler_123_abc"}, "response": {"data": {"message": "Task scheduler_123_abc removed from pool", "success": true}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Remove task from scheduler pool.", "mutation_kind": "entity", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.get_pool_tasks", "scheduler.clear_pool_tasks", "scheduler.cancel_task"], "required_cap": "scheduler", "requires_preflight": true, "risk_class": "destructive", "safe_action": "scheduler_delete_pool_task", "semantic_input_mode": "inherit_workflow", "summary": "Remove a specific task from the execution pool (does not delete from database).", "title": "Scheduler Delete Pool Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "Current user does not have permission to remove this task", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task with specified ID not found in pool", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove task from scheduler pool.", "write_mode": null}, {"action": "scheduler.clear_pool_tasks", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.clear_pool_tasks", "mutation_risk": "low", "related_tools": ["scheduler.refresh_pool", "scheduler.delete_pool_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Clear Pool Tasks"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "examples": [{"description": "Remove all tasks from the execution pool", "name": "Clear pool tasks", "request": {}, "response": {"data": {"message": "Pool cleared: 10 tasks removed", "removed_count": 10, "success": true, "timestamp": "2025-01-20T10:00:00Z"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Bulk clear pool — ops only.", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_tools": ["scheduler.refresh_pool", "scheduler.delete_pool_task"], "required_cap": "scheduler", "requires_preflight": true, "risk_class": "destructive", "safe_action": "scheduler_clear_pool_tasks", "semantic_input_mode": "inherit_workflow", "summary": "Clear all tasks from the execution pool (does not delete from database).", "title": "Scheduler Clear Pool Tasks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Failed to clear pool", "insufficient_permissions": "Current user does not have permission to clear pool", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bulk clear pool — ops only.", "write_mode": null}, {"action": "scheduler.refresh_pool", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.refresh_pool", "mutation_risk": "low", "related_tools": ["scheduler.get_pool_tasks", "scheduler.clear_pool_tasks", "scheduler.create_task"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Refresh Pool"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Force immediate refresh of scheduler pool from database", "name": "Refresh pool", "request": {}, "response": {"data": {"message": "Pool refreshed successfully", "stats": {"future_count": 1, "last_refill_time": 1737360000.0, "max_pool_size": 1000, "pool_size": 4, "ready_count": 1, "refill_interval": 300, "upcoming_count": 2, "window_minutes": 30}, "success": true, "timestamp": "2025-01-20T10:00:00Z"}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Use this tool after creating new scheduled tasks, when you need to immediately see tasks in pool, o…", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.get_pool_tasks", "scheduler.clear_pool_tasks", "scheduler.create_task"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "low_write", "safe_action": "scheduler_refresh_pool", "semantic_input_mode": "inherit_workflow", "summary": "Force a refresh of the scheduler pool from the database.", "title": "Scheduler Refresh Pool", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Failed to refresh pool", "insufficient_permissions": "Current user does not have permission to refresh pool", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Use this tool after creating new scheduled tasks, when you need to immediately see tasks in pool, or to force pool refresh without waiting for automatic refill", "write_mode": null}, {"action": "scheduler.get_all_db_tasks", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": true, "audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.get_all_db_tasks", "related_tools": ["scheduler.list_tasks", "scheduler.get_pool_tasks"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Get All Db Tasks"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"description": "Retrieve tasks with pagination", "name": "Get all tasks with pagination", "request": {"limit": 100, "offset": 0}, "response": {"data": {"limit": 100, "offset": 0, "success": true, "tasks": [{"enabled": true, "execute_at": "2025-01-20T10:30:00Z", "name": "Daily Backup", "project_id": 123, "task_id": "scheduler_123_abc", "task_type": "scheduler"}], "timestamp": "2025-01-20T10:00:00Z", "total": 1}, "success": true}}], "execution_class": "plain_read", "instruction_hint": "DB-backed scheduler rows for migration audit.", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.list_tasks", "scheduler.get_pool_tasks"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "read", "safe_action": "scheduler_get_all_db_tasks", "semantic_input_mode": "inherit_workflow", "summary": "Get all scheduler and standalone tasks from the database (heavy operation).", "title": "Scheduler Get All Db Tasks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Failed to retrieve tasks", "insufficient_permissions": "Current user does not have permission to view all tasks", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "DB-backed scheduler rows for migration audit.", "write_mode": null}, {"action": "scheduler.cancel_task", "aliases": ["scheduler.delete"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.cancel_task", "mutation_risk": "low", "related_tools": ["scheduler.delete_pool_task", "scheduler.list_tasks"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Cancel Task"}, "effect": {"execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "examples": [{"description": "Cancel a scheduler task", "name": "Cancel task", "request": {"project_id": 123, "task_id": "task_20250120_100000_000000"}, "response": {"data": {"committed": true, "disabled_in_db": true, "eligible": false, "enabled": false, "message": "Task task_20250120_100000_000000 cancelled (disabled)", "next_run_eligible": false, "success": true}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Stop future runs. Then scheduler.get_task. committed=true and next_run_eligible=false means the row…", "mutation_kind": "none", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "related_tools": ["scheduler.delete_pool_task", "scheduler.list_tasks"], "required_cap": "scheduler", "requires_preflight": false, "risk_class": "low_write", "safe_action": "scheduler_cancel_task", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "summary": "Cancel/remove a scheduler task (removes from pool and disables in database).", "title": "Cancel Scheduled Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project_admin or scheduler write cap required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "scheduler.get_task with task_id from create receipt — not UUID", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Stop future runs. Then scheduler.get_task. committed=true and next_run_eligible=false means the row is stopped, not a pending projection. Do not follow cancel with scheduler.create_task.", "write_mode": null}, {"action": "scheduler.delete_task", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "cancel_action": "scheduler.cancel_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.delete_task", "mutation_risk": "high", "related_tools": ["scheduler.cancel_task", "scheduler.list_tasks"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Scheduler Delete Task"}, "deprecated": "true", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Same as scheduler.cancel_task — prefer cancel_task in new integrations.", "mutation_kind": "entity", "plane": "Schedules: scheduler.list_tasks reads this user's scheduler fork, else the live head. An empty list is not a missing task. Do not create_task a replacement. Cancel: scheduler.cancel_task then get_task. Do not create_task to cancel.", "plane_chooser": "Create with name, cron, and command. To stop one, scheduler.cancel_task then get_task. An empty scheduler.list_tasks is valid. Do not create a second schedule.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preferred_action": "scheduler.cancel_task", "preflight_action": "preflight.check", "reason": "Use scheduler.cancel_task — delete_task is a legacy alias.", "related_tools": ["scheduler.cancel_task", "scheduler.list_tasks"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "scheduler_delete_task", "semantic_input_mode": "inherit_workflow", "summary": "Soft-disable alias for scheduler.cancel_task (sets enabled=false; row remains). Prefer scheduler.cancel_task for new agents.", "title": "Scheduler Delete Task", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "No permission to cancel this task", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "task_not_found": "Task with specified ID not found", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Same as scheduler.cancel_task — prefer cancel_task in new integrations.", "write_mode": null}], "script": [{"action": "script.put", "aliases": ["script.create", "scripts.create", "scripts.put"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "heavy", "external_side_effect": false, "generation": true, "kind": "mutate", "mutates_when": {"validate_only": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "validate_only=true compile-only; default persists SSBC + DNA index", "effect_depends_on_params": true, "kind": "mutate", "mutates_when": {"validate_only": false}}, "execution_class": "heavy", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.put", "mutates_when": {"validate_only": false}, "mutation_risk": "high", "related_tools": ["script.test", "script.dry_run", "script.versions"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Put"}, "do_not_use_when": "Not for executing exports — use script.test / script.dry_run after compile. validate_only=true does not persist; full put needs batch execution_intent when required.", "effect": {"audit_batch_param_sensitive": true, "conditional_mutate": "validate_only=true compile-only; default persists SSBC + DNA index", "effect_depends_on_params": true, "execution_class": "heavy", "generation": true, "kind": "mutate", "mutates_when": {"validate_only": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "validate_only=true compile-only; default persists SSBC + DNA index", "effect_depends_on_params": true, "kind": "mutate", "mutates_when": {"validate_only": false}}, "errors": {"SS1202": "P1 has no throw — return { ok: false } for a room error. Allowed: int expr, a+b, tick+1, return input, return { ok: true|false }. script.docs topic=syntax", "SS1210": "dna.read export missing read_paths — add read_paths: ['leaf.path']; or script.put validate_only + recompile_version for stale SSBC object returns", "SS9001": "script_version_conflict — refresh base_version", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "batch_semantic_anchor_required": "Persistent script.put in execute: options.execution_intent=direct or options.goal; validate_only=true compile-only batches exempt", "budget_exceeded": "Fabric execute budget saturated — honor retry_after_ms or split validate_only batches", "cap_not_implemented": "ctx.dna.cas is fail-closed at compile; events.emit needs a quoted string channel. http/notify/secrets stay unimplemented — script.docs topic=host", "caps_approval_required": "approve_caps=true on script.put or script.publish", "compile_error": "Compiler rejected body — see diagnostics[] and message_en", "compile_failed": "See diagnostics[] from compiler", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S — shrink sources or split script.put batches", "ctx_dna_write_without_cap": "Declare wallet/dna caps on export before ctx.dna.write", "ctx_not_declared": "Declare ctx in export signature before ctx.dna.read or ctx.dna.write (defineFn requires explicit ctx)", "dna_read_without_read_paths": "Add read_paths: ['leaf.path'] on dna.read export (SS1210)", "dna_write_path_not_constant": "One $segment is the room id: ctx.dna.write(['rooms', $room_id, 'state'], n) and write_paths: ['rooms.$room_id.state']. '{room_id}' and template strings are rejected.", "dna_write_without_write_paths": "Add write_paths: ['leaf.path'] on dna.write export before ctx.dna.write (SS1210)", "duplicate_export_name": "Two exports share the same name in one put batch", "entry_path_required": "Multi-file put requires entry: 'main.ts' (S-11)", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "export_body_stubbed_p1": "Use return int, a±b, tick+1, or { ok: true }; not host logic in body", "export_define_incomplete": "Object define* missing async body or run() — fix formatting/comments between }, and async", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before put", "invalid_parameters": "files[] required with path/content", "no_exports_found": "Entry file must export defineCommand/defineView/defineFn/defineRoom — script.docs topic=syntax; multi-file entry must be the file that contains define*", "no_exports_in_entry_scope": "Exports live in a sibling file — set entry to that path (e.g. room.ts) or move defineRoom/defineFn into the entry file; import alone does not publish exports", "partial_export_compile": "Fix all SS1210/SS1202 in batch — compile is fail-closed", "payload_too_large": "Split files[] or upload to storage first — max ~8MB per script.put batch", "preflight_blocked": "preflight.check action=script.publish before put publish=live", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "rate_limit_exceeded": "Throttle script.put — honor retry_after_ms from response", "script_put_failed": "Unexpected put failure — inspect data.diagnostics", "script_version_conflict": "Pass base_version from script.versions aliases.latest_version", "server_busy": "StackScript compile lane busy — retry after retry_after_ms", "shared_module_needs_main_export_in_same_put": "Include main.ts with defineFn/defineCommand in the same script.put files[] batch as thermo-shared.ts (use shared alone is not a script)", "source_pathological": "Source line count, line length, or comment-padding probe (SS1098) — max 25k lines/file, 8KiB/line; split or trim before script.put", "ssbc_blob_unreadable": "SSBC artifact missing or corrupt in storage — re script.put", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "storage_upload_failed": "Storage plane rejected sources manifest — check storage.get_quota"}, "example_params": {"approve_caps": true, "base_version": 123, "entry": "example_string", "files": [], "publish": "example_string", "script_id": "example_string", "validate_only": true}, "example_request": {"action": "script.put", "params": {"approve_caps": true, "base_version": 123, "entry": "example_string", "files": [], "publish": "example_string", "script_id": "example_string", "validate_only": true}}, "examples": [{"name": "Validate-only compile (no DNA write)", "request": {"params": {"files": [{"content": "export const tick = defineCommand({ name: \"tick\", caps: [], run() { return 1; } });", "path": "main.ts"}], "script_id": "demo-counter", "validate_only": true}, "tool": "script.put"}, "response": {"data": {"export_names": ["tick"], "ok": true}, "success": true}}], "execution_class": "heavy", "instruction_hint": "Compile TypeScript (.ts) sources to SSBC — files[].content is TS, not JSON. validate_only=true: com…", "language": "typescript", "lifecycle_checklist": "ABI: {} vs [] vs omitted for zero-arg exports — same in script.test and script.dry_run. Batch mutat…", "mcp_batch_hint": "MCP execute budget: whole batch ~60s — split large script.put (max ~8MB files) into validate_only first batch, then test/dry_run; compile concurrency defaults to 4. Hosted Nahual: batch success steps hoist script.run observability on the step root (timings, dna_persisted, runtime_neural_staged) — read step.timings, not only step.result.", "mutation_kind": "entity", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "preflight_action": "preflight.check", "related_tools": ["script.test", "script.dry_run", "script.versions"], "required_cap": "stackscript_write", "requires_preflight": true, "risk_class": "low_write", "rollback": ["script.delete"], "safe_action": "script_put", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Compile and store StackScript sources (TypeScript .ts subset → SSBC). files[]: {path, content} with TS source — not JSON logic rules. validate_only=true: compile receipt only (no DNA version). Persist", "title": "Script Put", "verification": ["script.get"], "verify": [{"action": "script.get", "predicate": "named resource is visible"}], "when_blocked": {"SS1202": "P1 has no throw — return { ok: false } for a room error. Allowed: int expr, a+b, tick+1, return input, return { ok: true|false }. script.docs topic=syntax", "SS1210": "dna.read export missing read_paths — add read_paths: ['leaf.path']; or script.put validate_only + recompile_version for stale SSBC object returns", "SS9001": "script_version_conflict — refresh base_version", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "batch_semantic_anchor_required": "Persistent script.put in execute: options.execution_intent=direct or options.goal; validate_only=true compile-only batches exempt", "budget_exceeded": "Fabric execute budget saturated — honor retry_after_ms or split validate_only batches", "cap_not_implemented": "ctx.dna.cas is fail-closed at compile; events.emit needs a quoted string channel. http/notify/secrets stay unimplemented — script.docs topic=host", "caps_approval_required": "approve_caps=true on script.put or script.publish", "compile_error": "Compiler rejected body — see diagnostics[] and message_en", "compile_failed": "See diagnostics[] from compiler", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S — shrink sources or split script.put batches", "ctx_dna_write_without_cap": "Declare wallet/dna caps on export before ctx.dna.write", "ctx_not_declared": "Declare ctx in export signature before ctx.dna.read or ctx.dna.write (defineFn requires explicit ctx)", "dna_read_without_read_paths": "Add read_paths: ['leaf.path'] on dna.read export (SS1210)", "dna_write_path_not_constant": "One $segment is the room id: ctx.dna.write(['rooms', $room_id, 'state'], n) and write_paths: ['rooms.$room_id.state']. '{room_id}' and template strings are rejected.", "dna_write_without_write_paths": "Add write_paths: ['leaf.path'] on dna.write export before ctx.dna.write (SS1210)", "duplicate_export_name": "Two exports share the same name in one put batch", "entry_path_required": "Multi-file put requires entry: 'main.ts' (S-11)", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "export_body_stubbed_p1": "Use return int, a±b, tick+1, or { ok: true }; not host logic in body", "export_define_incomplete": "Object define* missing async body or run() — fix formatting/comments between }, and async", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before put", "invalid_parameters": "files[] required with path/content", "no_exports_found": "Entry file must export defineCommand/defineView/defineFn/defineRoom — script.docs topic=syntax; multi-file entry must be the file that contains define*", "no_exports_in_entry_scope": "Exports live in a sibling file — set entry to that path (e.g. room.ts) or move defineRoom/defineFn into the entry file; import alone does not publish exports", "partial_export_compile": "Fix all SS1210/SS1202 in batch — compile is fail-closed", "payload_too_large": "Split files[] or upload to storage first — max ~8MB per script.put batch", "preflight_blocked": "preflight.check action=script.publish before put publish=live", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "rate_limit_exceeded": "Throttle script.put — honor retry_after_ms from response", "script_put_failed": "Unexpected put failure — inspect data.diagnostics", "script_version_conflict": "Pass base_version from script.versions aliases.latest_version", "server_busy": "StackScript compile lane busy — retry after retry_after_ms", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "shared_module_needs_main_export_in_same_put": "Include main.ts with defineFn/defineCommand in the same script.put files[] batch as thermo-shared.ts (use shared alone is not a script)", "source_pathological": "Source line count, line length, or comment-padding probe (SS1098) — max 25k lines/file, 8KiB/line; split or trim before script.put", "ssbc_blob_unreadable": "SSBC artifact missing or corrupt in storage — re script.put", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "storage_upload_failed": "Storage plane rejected sources manifest — check storage.get_quota"}, "when_not_to_use": "Not for executing exports — use script.test / script.dry_run after compile. validate_only=true does not persist; full put needs batch execution_intent when required.", "when_to_use": "Compile TypeScript (.ts) sources to SSBC — files[].content is TS, not JSON. validate_only=true: compile receipt only (no DNA version). Persistent put in a multi-step MCP batch: set options.execution_i", "workflow_ladder": ["script.docs?topic=syntax — TypeScript export shapes before script.put", "script.put validate_only=true — compile receipt only (persisted=false)", "script.put persist — version + code_hash from receipt", "script.test (version=latest) on the same script_id — before publish", "script.dry_run with export + input — inspect write_set and cost.fuel", "preflight.check action=script.publish — caps / approval preview", "script.publish alias live after caps approval if caps_diff.requires_approval", "script.run on prod only after generation.promote when using sandbox", "logic.attach_template tpl_stackscript_trigger_shell (field_values from put receipt)", "logic.dry_run — verify nested_stackscript trace on script_processor steps"], "write_mode": null}, {"action": "script.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.get", "mutation_risk": "low", "related_tools": ["script.versions", "script.put", "script.test"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Get"}, "do_not_use_when": "Not for executing exports — script.test / script.dry_run / script.run. Not a substitute for script.studio_bundle when you need versions ladder in one hop.", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Reads resolve against generation_env_uuid when set in MCP context (sandbox anchor); otherwise production project slice", "effect_depends_on_params": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "content_missing": "SSBC blob unreadable — script.put recompile or pick another version alias", "not_found": "Unknown script_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "version_not_found": "script.versions — pick live|staging|numeric"}, "execution_class": "plain_read", "instruction_hint": "Default version=latest (compiled slice); use live after script.publish. Pass include_sources=true t…", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.versions", "script.put", "script.test"], "required_cap": "stackscript_read", "requires_preflight": false, "risk_class": "read", "runtime_vars_hint": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "safe_action": "script_get", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Get script metadata and version info.", "title": "Script Get", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "content_missing": "SSBC blob unreadable — script.put recompile or pick another version alias", "not_found": "Unknown script_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "version_not_found": "script.versions — pick live|staging|numeric"}, "when_not_to_use": "Not for executing exports — script.test / script.dry_run / script.run. Not a substitute for script.studio_bundle when you need versions ladder in one hop.", "when_to_use": "Default version=latest (compiled slice); use live after script.publish. Pass include_sources=true to hydrate meta.sources; files[] always returned. generation_env_uuid scopes sandbox reads.", "workflow_ladder": ["script.docs?topic=syntax — TypeScript export shapes before script.put", "script.put validate_only=true — compile receipt only (persisted=false)", "script.put persist — version + code_hash from receipt", "script.test (version=latest) on the same script_id — before publish", "script.dry_run with export + input — inspect write_set and cost.fuel", "preflight.check action=script.publish — caps / approval preview", "script.publish alias live after caps approval if caps_diff.requires_approval", "script.run on prod only after generation.promote when using sandbox", "logic.attach_template tpl_stackscript_trigger_shell (field_values from put receipt)", "logic.dry_run — verify nested_stackscript trace on script_processor steps"], "write_mode": null}, {"action": "script.studio_bundle", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.studio_bundle", "mutation_risk": "low", "related_tools": ["script.get", "script.versions", "script.put"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Studio Bundle"}, "do_not_use_when": "Not for headless automation — use script.get or script.list for one concern. Avoid include_sources=true on large trees; Studio sets it explicitly. Not a substitute for script.profile or script.dry_run.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "invalid_parameters": "max_versions must be integer 1–100 when set", "not_found": "Unknown script_id — script.put or script.list", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "version_not_found": "Resolved version missing from versions tree"}, "execution_class": "plain_read", "instruction_hint": "Studio shell read model — script.get (include_sources) + script.versions in one MCP round-trip. Pre…", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.get", "script.versions", "script.put"], "required_cap": "stackscript_read", "requires_preflight": false, "risk_class": "read", "safe_action": "script_studio_bundle", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Studio read model: detail files + version ladder in one call.", "title": "Script Studio Bundle", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "invalid_parameters": "max_versions must be integer 1–100 when set", "not_found": "Unknown script_id — script.put or script.list", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "version_not_found": "Resolved version missing from versions tree"}, "when_not_to_use": "Not for headless automation — use script.get or script.list for one concern. Avoid include_sources=true on large trees; Studio sets it explicitly. Not a substitute for script.profile or script.dry_run.", "when_to_use": "Studio shell read model — script.get (include_sources) + script.versions in one MCP round-trip. Prefer over separate get+versions when opening Script Studio.", "write_mode": null}, {"action": "script.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.list", "mutation_risk": "low", "related_tools": ["script.get", "script.put"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script List"}, "do_not_use_when": "Not for per-export bytecode or sources — script.get or script.studio_bundle. Does not run scripts.", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Reads resolve against generation_env_uuid when set in MCP context (sandbox anchor); otherwise production project slice", "effect_depends_on_params": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id"}, "execution_class": "plain_read", "instruction_hint": "Index map — scoped to generation_env_uuid when set (else production slice).", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.get", "script.put"], "required_cap": "stackscript_read", "requires_preflight": false, "risk_class": "read", "safe_action": "script_list", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "List scripts in project.", "title": "Script List", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id"}, "when_not_to_use": "Not for per-export bytecode or sources — script.get or script.studio_bundle. Does not run scripts.", "when_to_use": "Index map — scoped to generation_env_uuid when set (else production slice).", "write_mode": null}, {"action": "script.test", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.test", "mutation_risk": "low", "related_tools": ["script.put", "script.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Test"}, "do_not_use_when": "Not for production DNA commit or wallet settlement — use script.run after promote. Does not heal stale SSBC (unlike script.run); use script.recompile_version. dna.read needs read_paths prefetch — cache miss fails in dry_run VM.", "effect": {"audit_batch_allowed": true, "conditional_mutate": "VM smoke via dry_run — no persist on validate path; generation_env_uuid scopes sandbox reads like script.dry_run", "effect_depends_on_params": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"SS1202": "P1 has no throw — return { ok: false } for a room error. Allowed: int expr, a+b, tick+1, return input, return { ok: true|false }. script.docs topic=syntax", "SS1401": "dna.write path not in write_paths — fix export meta or script.put", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Retry once (heal from meta.sources) or script.put", "cap_not_implemented": "P1 VM — dna.*, events.emit (host allowlist), wallet via stackscript.wallet.replay; not http/notify/secrets — script.docs topic=host", "compile_failed": "Ephemeral files[] did not compile — see diagnostics", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S", "db_unavailable": "Retry script.test after retry_after_ms", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field on test_input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_write_path_denied": "Same as SS1401", "entry_path_required": "Multi-file files[] needs entry", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "expect_value_mismatch": "VM value differed from expect_value — fix script or input", "export_body_stubbed_p1": "Re script.put with supported return forms", "export_not_found": "Use export_names from script.put receipt", "input_alias_conflict": "test_input and input both set but differ — pass only one ABI payload", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass test_input / input — export requires parameters", "input_requires_integer_slots": "Numeric input slots only in P1 VM", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish or put with publish=live", "payload_too_large": "files[] exceeds the same byte cap as script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "run_timeout": "VM exceeded run timeout — simplify export", "script_id_or_files_required": "Pass script_id or ephemeral files[] with path/content and optional entry", "script_not_found": "script.put first", "script_test_failed": "Smoke test failed", "source_pathological": "Trim pathological sources (SS1098) before script.test", "stackscript_fuel_quota_exceeded": "Upgrade plan or script.profile", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "test_input_required": "Pass test_input matching export input_fields", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions", "vm_division_by_zero": "Guard divisor in script body before divide/mod", "vm_fuel_exhausted": "Export exceeded per-run fuel limit — simplify body or raise cap", "vm_int_overflow": "int53 overflow — narrow arithmetic in export body", "wallet_user_required": "MCP session user_id required — omit params.user_id", "workflow_scope_leak": "params.user_id must match session user_id"}, "examples": [{"name": "Smoke test with positional input", "request": {"params": {"expect_value": 5, "export": "add", "script_id": "demo-counter", "test_input": [2, 3], "version": "latest"}, "tool": "script.test"}}], "execution_class": "plain_read", "instruction_hint": "Sandbox smoke on latest_version after script.put (version=latest default; use version=live only aft…", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.put", "script.dry_run"], "required_cap": "stackscript_write", "requires_preflight": false, "risk_class": "read", "safe_action": "script_test", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Smoke-test an export via dry_run VM (no DNA commit). Optional expect_value assertion.", "title": "Script Test", "when_blocked": {"SS1202": "P1 has no throw — return { ok: false } for a room error. Allowed: int expr, a+b, tick+1, return input, return { ok: true|false }. script.docs topic=syntax", "SS1401": "dna.write path not in write_paths — fix export meta or script.put", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Retry once (heal from meta.sources) or script.put", "cap_not_implemented": "P1 VM — dna.*, events.emit (host allowlist), wallet via stackscript.wallet.replay; not http/notify/secrets — script.docs topic=host", "compile_failed": "Ephemeral files[] did not compile — see diagnostics", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S", "db_unavailable": "Retry script.test after retry_after_ms", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field on test_input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_write_path_denied": "Same as SS1401", "entry_path_required": "Multi-file files[] needs entry", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "expect_value_mismatch": "VM value differed from expect_value — fix script or input", "export_body_stubbed_p1": "Re script.put with supported return forms", "export_not_found": "Use export_names from script.put receipt", "input_alias_conflict": "test_input and input both set but differ — pass only one ABI payload", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass test_input / input — export requires parameters", "input_requires_integer_slots": "Numeric input slots only in P1 VM", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish or put with publish=live", "payload_too_large": "files[] exceeds the same byte cap as script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "run_timeout": "VM exceeded run timeout — simplify export", "script_id_or_files_required": "Pass script_id or ephemeral files[] with path/content and optional entry", "script_not_found": "script.put first", "script_test_failed": "Smoke test failed", "source_pathological": "Trim pathological sources (SS1098) before script.test", "stackscript_fuel_quota_exceeded": "Upgrade plan or script.profile", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "test_input_required": "Pass test_input matching export input_fields", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions", "vm_division_by_zero": "Guard divisor in script body before divide/mod", "vm_fuel_exhausted": "Export exceeded per-run fuel limit — simplify body or raise cap", "vm_int_overflow": "int53 overflow — narrow arithmetic in export body", "wallet_user_required": "MCP session user_id required — omit params.user_id", "workflow_scope_leak": "params.user_id must match session user_id"}, "when_not_to_use": "Not for production DNA commit or wallet settlement — use script.run after promote. Does not heal stale SSBC (unlike script.run); use script.recompile_version. dna.read needs read_paths prefetch — cache miss fails in dry_run VM.", "when_to_use": "Sandbox smoke on latest_version after script.put (version=latest default; use version=live only after script.publish). expect_value compares wire data.value (scalar or {value:…}); explicit null is ass", "workflow_ladder": ["script.docs?topic=syntax — TypeScript export shapes before script.put", "script.put validate_only=true — compile receipt only (persisted=false)", "script.put persist — version + code_hash from receipt", "script.test (version=latest) on the same script_id — before publish", "script.dry_run with export + input — inspect write_set and cost.fuel", "preflight.check action=script.publish — caps / approval preview", "script.publish alias live after caps approval if caps_diff.requires_approval", "script.run on prod only after generation.promote when using sandbox", "logic.attach_template tpl_stackscript_trigger_shell (field_values from put receipt)", "logic.dry_run — verify nested_stackscript trace on script_processor steps"], "write_mode": null}, {"action": "script.dry_run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.dry_run", "mutation_risk": "low", "related_tools": ["script.put", "script.test", "script.run", "script.publish", "logic.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Dry Run"}, "do_not_use_when": "Do not use for production DNA commit — script.run after promote. wallet_ops and events in dry_run are previews only.", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Reads resolve against generation_env_uuid when set in MCP context (sandbox anchor); otherwise production project slice", "effect_depends_on_params": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"SS1401": "dna.write path not in write_paths — fix export meta or script.put", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Re-upload via script.put", "bytecode_stale": "compiler_version on the stored artifact differs — script.recompile_version or script.put before dry_run", "cap_not_implemented": "P1 VM — dna.*, events.emit (host allowlist), wallet via stackscript.wallet.replay; not http/notify/secrets — script.docs topic=host", "compile_failed": "Ephemeral sources did not compile — see diagnostics", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S", "db_unavailable": "Retry dry_run after retry_after_ms — same as script.run", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field on input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_write_path_denied": "Same as SS1401", "entry_path_required": "Multi-file files[] needs entry", "expect_value_mismatch": "VM value differed from expect_value — fix script or input", "export_not_found": "Use export_names from script.put receipt", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass input object or positional array — export requires parameters", "input_requires_integer_slots": "input values must be numeric (coerce strings)", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "invalid_parameters": "Ephemeral dry_run needs files[] with path and content", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish or put with publish=live", "payload_too_large": "files[] exceeds the same byte cap as script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "run_timeout": "VM exceeded run timeout — simplify export or split work", "script_dry_run_failed": "VM or export error — see error field", "script_id_or_files_required": "Pass script_id or ephemeral files[] with path/content and optional entry", "script_not_found": "script.put first", "source_pathological": "Source line count, line length, or comment-padding probe (SS1098) — max 25k lines/file, 8KiB/line; split or trim before script.dry_run", "stackscript_fuel_quota_exceeded": "Upgrade plan or reduce fuel", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions", "vm_division_by_zero": "Guard divisor in script body before divide/mod", "vm_fuel_exhausted": "Export exceeded per-run fuel limit — simplify body or raise cap", "vm_int_overflow": "int53 overflow — narrow arithmetic in export body", "wallet_user_required": "MCP session user_id required — omit params.user_id", "workflow_scope_leak": "params.user_id must match session user_id"}, "examples": [{"name": "Preview write_set and fuel", "request": {"params": {"export": "tick", "input": {"n": 1}, "script_id": "demo-counter", "version": "latest"}, "tool": "script.dry_run"}}], "execution_class": "plain_read", "instruction_hint": "Simulate export — inspect write_set, fuel, cost before script.run. Optional files[{path,content}] c…", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.put", "script.test", "script.run", "script.publish", "logic.dry_run"], "required_cap": "stackscript_read", "requires_preflight": false, "risk_class": "read", "runtime_vars_hint": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "safe_action": "script_dry_run", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Execute without persisting side effects.", "title": "Script Dry Run", "when_blocked": {"SS1401": "dna.write path not in write_paths — fix export meta or script.put", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Re-upload via script.put", "bytecode_stale": "compiler_version on the stored artifact differs — script.recompile_version or script.put before dry_run", "cap_not_implemented": "P1 VM — dna.*, events.emit (host allowlist), wallet via stackscript.wallet.replay; not http/notify/secrets — script.docs topic=host", "compile_failed": "Ephemeral sources did not compile — see diagnostics", "compile_timeout": "Compile exceeded STACKSCRIPT_COMPILE_TIMEOUT_S", "db_unavailable": "Retry dry_run after retry_after_ms — same as script.run", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field on input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_write_path_denied": "Same as SS1401", "entry_path_required": "Multi-file files[] needs entry", "expect_value_mismatch": "VM value differed from expect_value — fix script or input", "export_not_found": "Use export_names from script.put receipt", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass input object or positional array — export requires parameters", "input_requires_integer_slots": "input values must be numeric (coerce strings)", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "invalid_parameters": "Ephemeral dry_run needs files[] with path and content", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish or put with publish=live", "payload_too_large": "files[] exceeds the same byte cap as script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "run_timeout": "VM exceeded run timeout — simplify export or split work", "script_dry_run_failed": "VM or export error — see error field", "script_id_or_files_required": "Pass script_id or ephemeral files[] with path/content and optional entry", "script_not_found": "script.put first", "source_pathological": "Source line count, line length, or comment-padding probe (SS1098) — max 25k lines/file, 8KiB/line; split or trim before script.dry_run", "stackscript_fuel_quota_exceeded": "Upgrade plan or reduce fuel", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions", "vm_division_by_zero": "Guard divisor in script body before divide/mod", "vm_fuel_exhausted": "Export exceeded per-run fuel limit — simplify body or raise cap", "vm_int_overflow": "int53 overflow — narrow arithmetic in export body", "wallet_user_required": "MCP session user_id required — omit params.user_id", "workflow_scope_leak": "params.user_id must match session user_id"}, "when_not_to_use": "Do not use for production DNA commit — script.run after promote. wallet_ops and events in dry_run are previews only.", "when_to_use": "Simulate export — inspect write_set, fuel, cost before script.run. Optional files[{path,content}] compiles in memory (ephemeral_compile) without script.put; omit files to run the stored SSBC. Multi-fi", "workflow_ladder": ["script.docs?topic=syntax — TypeScript export shapes before script.put", "script.put validate_only=true — compile receipt only (persisted=false)", "script.put persist — version + code_hash from receipt", "script.test (version=latest) on the same script_id — before publish", "script.dry_run with export + input — inspect write_set and cost.fuel", "preflight.check action=script.publish — caps / approval preview", "script.publish alias live after caps approval if caps_diff.requires_approval", "script.run on prod only after generation.promote when using sandbox", "logic.attach_template tpl_stackscript_trigger_shell (field_values from put receipt)", "logic.dry_run — verify nested_stackscript trace on script_processor steps"], "write_mode": null}, {"action": "script.run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.run", "mutation_risk": "low", "related_tools": ["script.dry_run", "script.profile", "stackscript.dna.replay", "stackscript.wallet.replay", "rooms.quick_match"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Run", "visitor_callable": true}, "do_not_use_when": "Do not use under generation_env_uuid or to preview write_set — use script.dry_run, then generation.promote before prod commit. Batch context.generation_env_uuid is ignored (W25); passing env_uuid still triggers sandbox_run_commit_forbidden. Not for compile smoke — use script.test or script.put validate_only. Hosted wt.m.* exports need rooms.quick_match seat first — not for QM netplay without poll/ws. DNA coop lobby scripts (e.g. *.open / *.scan) do not use rooms.* — do not force quick_match.", "effect": {"conditional_mutate": "Production commit only (_env_uuid_prod_commit); consumes VM fuel; preflight.check with context.project_id before first run; generation_env_uuid ignored — use script.test or script.dry_run to validate", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"SS1401": "dna.write path not in export write_paths — add write_paths on defineFn/defineCommand or narrow ctx.dna.put leaf", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Re-compile via script.put", "bytecode_stale": "Stored compiler_version differs — script.recompile_version off hosted hot path (no heal-on-read on script.run)", "cap_not_implemented": "P1 fail-closed — ctx.dna.cas is cap_not_implemented (not generic SS1202); dna.read/write + events.emit + wallet — script.docs topic=host", "commit_failed": "Ledger may be committed; DNA atomic failed — stackscript.dna.replay with dna_repair_path then script.profile", "db_unavailable": "Postgres recovering or pool reset — retry script.run with the same idempotency_key after retry_after_ms. failure_phase=dna_commit|repair_lookup|index_lookup|idempotency_lock|neural_flush tells which stage timed out — see data.failure_phase. neural_flush: L1 staged ok; background PG flush backlog — retry same idempotency_key", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field (matchId) on input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_read_miss_in_run": "Live script.run — declare read_paths on export, prefetch via input.__dna_prefetch, then script.dry_run to verify before commit", "dna_repair_outbox_failed": "Ledger committed but DNA repair outbox did not persist — operator incident; do not assume DNA matches ledger without manual verify", "dna_repair_pending": "Pending dna_repair outbox for this idempotency_key — stackscript.dna.replay before script.run (VM skipped)", "dna_write_path_denied": "Same as SS1401 — declare write_paths matching DNA leaves", "dry_run_preview_not_committable": "Internal — do not commit dry_run preview", "export_not_found": "Match script.put export_names", "export_not_public": "Hosted script.run denied — owner script.publish with approve_public_run=true after generation.promote", "generation_fork_required": "Operator-only prod write — hosted players use public_run after script.publish approve_public_run", "idempotency_key_reused": "Same key with different payload", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass input matching export input_fields — same ABI as script.dry_run", "input_requires_integer_slots": "Numeric input slots only in P1 VM", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish alias live or script.dry_run version=latest", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "public_run_caps_exceed_ceiling": "Export caps exceed hosted visitor ceiling — narrow caps or use operator run", "quick_match_required": "Hosted wt.m.* export without QM seat — rooms.quick_match then rooms.poll_events before retry", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "revision_conflict": "input.expected_revision does not match the runtime leaf. Retry script.run with data.actual_revision and a new idempotency_key.", "revision_required": "Runtime DNA write needs input.expected_revision (aliases match_revision, revision). Use data.actual_revision from this error — do not re-read DNA first. Not emitted for internal room_host ticks (script.room.tick); those use revision_gate + in-txn CAS.", "run_in_progress": "Same idempotency_key still running — wait retry_after_ms or use a new key", "run_lock_timeout": "Idempotency lock held too long — another run with the same key may be stuck; wait retry_after_ms or use a fresh idempotency_key", "run_timeout": "VM exceeded STACKSCRIPT_RUN_VM_SEC — simplify export, prefetch DNA, or split work", "sandbox_run_commit_forbidden": "Hosted cannot pin env_uuid for prod commit — use operator promote ladder", "sandbox_runtime_path_denied": "Sandbox commit allows ecosystem.scripts.runtime.* only — fix export write_paths (SS1401)", "script_not_found": "script.profile — then script.put + script.publish (live); not a missing export name", "script_run_failed": "VM or host error — see diagnostics in data", "stackscript_fuel_quota_exceeded": "Monthly fuel cap exceeded", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions — live alias may lag latest", "vm_division_by_zero": "Guard divisor before divide/mod in export body", "vm_fuel_exhausted": "Per-run fuel cap — reduce work or split exports", "vm_int_overflow": "int53 overflow in export body", "wallet_commit_failed": "Ledger step failed — balances unchanged in DNA on current path; legacy repair leaves: stackscript.wallet.replay with wallet_repair_path", "wallet_insufficient_funds": "Top up commerce wallet before wallet.debit in script.run", "wallet_partial_state": "Ledger spend_partial_state for script ref_id — stackscript.wallet.replay or new idempotency_key after ops review", "wallet_user_required": "MCP session must include operator user_id for wallet caps", "workflow_scope_leak": "params.user_id must match session user_id"}, "example_params": {"export": "example_string", "idempotency_key": "example_string", "input": {"a": 2, "b": 3}, "script_id": "example_string", "version": "example_string"}, "example_request": {"action": "script.run", "params": {"export": "example_string", "idempotency_key": "example_string", "input": {"a": 2, "b": 3}, "script_id": "example_string", "version": "example_string"}}, "examples": [{"name": "Live export after publish ladder", "request": {"params": {"export": "tick", "idempotency_key": "run-demo-1", "input": {}, "script_id": "demo-counter", "version": "live"}, "tool": "script.run"}, "response": {"data": {"fuel_used": 12, "ok": true}, "success": true}}], "execution_class": "cheap", "hosted_coop_input": "Hosted coop commits: optional input.advisory_scope or coop_advisory_scope (opaque string); else runtime match_id from write_set; else {export}:{seed} on *.open; else {export}:{shard_key}:{value} for lobby_id|shard|pub|room_id. Same scope serializes; runtime leaves are NeuralCache L1 hot with debounced PG flush (timings.neural_defer=true); idempotency/fuel infra still flush immediately — retry same idempotency_key on db_unavailable. Read-only exports (e.g. nhl.scan without dna.write) set persist_idempotency=false — replay check still runs; PG idempotency leaf is omitted on commit.", "instruction_hint": "Production DNA commit — batch generation_env_uuid is ignored (W25); use script.dry_run in sandbox, …", "language": "typescript", "mutation_kind": "entity", "plane_chooser": "Hosted /s/{pid}/mcp: public_run exports after script.publish approve_public_run. DNA coop lobby: script.run on tenant exports — not rooms.*. QM netplay: rooms.quick_match → poll/ws_ticket → script.run on wt.m.*. Operator: full compile ladder + generation.promote. Match turns: idempotency + expected_revision in input.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.dry_run", "script.profile", "stackscript.dna.replay", "stackscript.wallet.replay", "rooms.quick_match"], "required_cap": "stackscript_run", "requires_preflight": true, "risk_class": "external_side_effect", "rollback": ["stackscript.dna.replay"], "runtime_vars_hint": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "safe_action": "script_run", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Execute a published script export on production DNA. Batch generation_env_uuid is ignored; use script.dry_run in sandbox.", "title": "Script Run", "verification": ["script.profile"], "verify": [{"action": "script.profile", "predicate": "named resource is visible"}], "when_blocked": {"SS1401": "dna.write path not in export write_paths — add write_paths on defineFn/defineCommand or narrow ctx.dna.put leaf", "SS2301": "Export cap denied — declare cap on export or remove host call", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Re-compile via script.put", "bytecode_stale": "Stored compiler_version differs — script.recompile_version off hosted hot path (no heal-on-read on script.run)", "cap_not_implemented": "P1 fail-closed — ctx.dna.cas is cap_not_implemented (not generic SS1202); dna.read/write + events.emit + wallet — script.docs topic=host", "commit_failed": "Ledger may be committed; DNA atomic failed — stackscript.dna.replay with dna_repair_path then script.profile", "db_unavailable": "Postgres recovering or pool reset — retry script.run with the same idempotency_key after retry_after_ms. failure_phase=dna_commit|repair_lookup|index_lookup|idempotency_lock|neural_flush tells which stage timed out — see data.failure_phase. neural_flush: L1 staged ok; background PG flush backlog — retry same idempotency_key", "dna_path_binding_missing": "DNA path template $segment has no input binding — pass the named field (matchId) on input", "dna_prefetch_failed": "Batch DNA prefetch failed before VM — retry or shrink read_paths / __dna_prefetch", "dna_read_miss_in_dry_run": "Declare read_paths on export or prefetch DNA leaf in script.put meta", "dna_read_miss_in_run": "Live script.run — declare read_paths on export, prefetch via input.__dna_prefetch, then script.dry_run to verify before commit", "dna_repair_outbox_failed": "Ledger committed but DNA repair outbox did not persist — operator incident; do not assume DNA matches ledger without manual verify", "dna_repair_pending": "Pending dna_repair outbox for this idempotency_key — stackscript.dna.replay before script.run (VM skipped)", "dna_write_path_denied": "Same as SS1401 — declare write_paths matching DNA leaves", "dry_run_preview_not_committable": "Internal — do not commit dry_run preview", "export_not_found": "Match script.put export_names", "export_not_public": "Hosted script.run denied — owner script.publish with approve_public_run=true after generation.promote", "generation_fork_required": "Operator-only prod write — hosted players use public_run after script.publish approve_public_run", "idempotency_key_reused": "Same key with different payload", "input_invalid_order": "__order must list field names, not values — use [a,b] or {a:1,b:2}", "input_missing_field": "Named field missing from input object", "input_positional_length_mismatch": "Positional array length must match export input_fields", "input_required": "Pass input matching export input_fields — same ABI as script.dry_run", "input_requires_integer_slots": "Numeric input slots only in P1 VM", "input_type_mismatch": "Non-numeric string or array in input slot — use int or nested object", "locals_arity_mismatch": "VM locals length must match export params — use [a,b] not [0,a,b] without ctx", "no_published_version": "script.publish alias live or script.dry_run version=latest", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "public_run_caps_exceed_ceiling": "Export caps exceed hosted visitor ceiling — narrow caps or use operator run", "quick_match_required": "Hosted wt.m.* export without QM seat — rooms.quick_match then rooms.poll_events before retry", "read_paths_prefetch_exceeded": "Union of read_paths + input.__dna_prefetch exceeds 32 — split exports or narrow leaves", "revision_conflict": "input.expected_revision does not match the runtime leaf. Retry script.run with data.actual_revision and a new idempotency_key.", "revision_required": "Runtime DNA write needs input.expected_revision (aliases match_revision, revision). Use data.actual_revision from this error — do not re-read DNA first. Not emitted for internal room_host ticks (script.room.tick); those use revision_gate + in-txn CAS.", "run_in_progress": "Same idempotency_key still running — wait retry_after_ms or use a new key", "run_lock_timeout": "Idempotency lock held too long — another run with the same key may be stuck; wait retry_after_ms or use a fresh idempotency_key", "run_timeout": "VM exceeded STACKSCRIPT_RUN_VM_SEC — simplify export, prefetch DNA, or split work", "sandbox_run_commit_forbidden": "Hosted cannot pin env_uuid for prod commit — use operator promote ladder", "sandbox_runtime_path_denied": "Sandbox commit allows ecosystem.scripts.runtime.* only — fix export write_paths (SS1401)", "script_not_found": "script.profile — then script.put + script.publish (live); not a missing export name", "script_run_failed": "VM or host error — see diagnostics in data", "stackscript_fuel_quota_exceeded": "Monthly fuel cap exceeded", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "script.put again from retained sources — legacy SSBC shared entry_pc", "unknown_input_field": "Remove ctx from input — ctx is VM local [0], not an input slot", "version_not_found": "Check script.versions — live alias may lag latest", "vm_division_by_zero": "Guard divisor before divide/mod in export body", "vm_fuel_exhausted": "Per-run fuel cap — reduce work or split exports", "vm_int_overflow": "int53 overflow in export body", "wallet_commit_failed": "Ledger step failed — balances unchanged in DNA on current path; legacy repair leaves: stackscript.wallet.replay with wallet_repair_path", "wallet_insufficient_funds": "Top up commerce wallet before wallet.debit in script.run", "wallet_partial_state": "Ledger spend_partial_state for script ref_id — stackscript.wallet.replay or new idempotency_key after ops review", "wallet_user_required": "MCP session must include operator user_id for wallet caps", "workflow_scope_leak": "params.user_id must match session user_id"}, "when_not_to_use": "Do not use under generation_env_uuid or to preview write_set — use script.dry_run, then generation.promote before prod commit. Batch context.generation_env_uuid is ignored (W25); passing env_uuid still triggers sandbox_run_commit_forbidden. Not for compile smoke — use script.test or script.put validate_only. Hosted wt.m.* exports need rooms.quick_match seat first — not for QM netplay without poll/ws. DNA coop lobby scripts (e.g. *.open / *.scan) do not use rooms.* — do not force quick_match.", "when_to_use": "Production DNA commit — batch generation_env_uuid is ignored (W25); use script.dry_run in sandbox, generation.promote, then script.run. script.dry_run first. See docs/operations/STACKSCRIPT_GENERATION", "workflow_ladder": ["script.docs?topic=syntax — TypeScript export shapes before script.put", "script.put validate_only=true — compile receipt only (persisted=false)", "script.put persist — version + code_hash from receipt", "script.test (version=latest) on the same script_id — before publish", "script.dry_run with export + input — inspect write_set and cost.fuel", "preflight.check action=script.publish — caps / approval preview", "script.publish alias live after caps approval if caps_diff.requires_approval", "script.run on prod only after generation.promote when using sandbox", "logic.attach_template tpl_stackscript_trigger_shell (field_values from put receipt)", "logic.dry_run — verify nested_stackscript trace on script_processor steps"], "write_mode": null}, {"action": "script.docs", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.docs", "mutation_risk": "low", "related_tools": ["script.put", "script.dry_run"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Docs"}, "do_not_use_when": "Reference only — does not compile, publish, or mutate DNA. For live errors use instruction_slice on script.test / script.dry_run / script.run.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"unknown_topic": "topic must be a key from script.docs with no topic (overview lists topics)"}, "execution_class": "plain_read", "instruction_hint": "TypeScript syntax + runtime topics (syntax, overview, fuel, migration, host, runtime, room, idempot…", "language": "typescript", "lifecycle_checklist": "ABI: {} vs [] vs omitted for zero-arg exports — same in script.test and script.dry_run. Batch mutat…", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.put", "script.dry_run"], "required_cap": "stackscript_read", "requires_preflight": false, "risk_class": "read", "safe_action": "script_docs", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "StackScript language docs (TypeScript subset). Topics: syntax, overview, fuel, migration, host, runtime, room, idempotency, dna_repair, limits (aliases: rooms, multiplayer).", "title": "Script Docs", "when_blocked": {"unknown_topic": "topic must be a key from script.docs with no topic (overview lists topics)"}, "when_not_to_use": "Reference only — does not compile, publish, or mutate DNA. For live errors use instruction_slice on script.test / script.dry_run / script.run.", "when_to_use": "TypeScript syntax + runtime topics (syntax, overview, fuel, migration, host, runtime, room, idempotency, dna_repair, limits).", "write_mode": null}, {"action": "script.publish", "aliases": ["stackscript.publish"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": true, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.publish", "mutation_risk": "low", "related_tools": ["script.versions", "script.dry_run", "script.rollback", "preflight.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Publish"}, "do_not_use_when": "Not for sandbox verification — dry_run/test under generation_env_uuid first. Does not run exports; only moves live/staging alias after caps preflight.", "effect": {"conditional_mutate": "Mutates script alias leaf in project DNA.", "effect_depends_on_params": true, "execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "budget_exceeded": "Fabric budget — wait retry_after_ms or narrow publish batch", "caps_approval_required": "approve_caps or config.agent_can_approve_caps — see caps_diff", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before publish", "index_update_failed": "DNA index patch failed — verify generation_env_uuid anchor", "preflight_blocked": "Run preflight.check action=script.publish first", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "public_run_no_eligible_exports": "No export has approve_public_run — owner script.publish with approve_public_run=true", "script_not_found": "script.put on resolved_env_uuid — verify script.versions", "script_publish_failed": "Unexpected publish failure — inspect data", "server_busy": "Publish lane saturated — retry after retry_after_ms", "version_not_found": "Check script.versions"}, "example_params": {"alias": "example_string", "approve_caps": true, "approve_public_run": true, "script_id": "example_string", "version": 123}, "example_request": {"action": "script.publish", "params": {"alias": "example_string", "approve_caps": true, "approve_public_run": true, "script_id": "example_string", "version": 123}}, "examples": [{"name": "Promote version to live", "request": {"params": {"alias": "live", "approve_caps": true, "script_id": "demo-counter", "version": 2}, "tool": "script.publish"}, "response": {"data": {"alias": "live", "ok": true, "version": 2}, "success": true}}], "execution_class": "cheap", "instruction_hint": "Requires stackscript_admin (or project write + caps). After auth.switch_project in the same execute…", "language": "typescript", "mutation_kind": "entity", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "preflight_action": "preflight.check", "related_tools": ["script.versions", "script.dry_run", "script.rollback", "preflight.check"], "required_cap": "stackscript_admin", "requires_preflight": true, "risk_class": "production_publish", "rollback": ["script.rollback"], "safe_action": "script_publish", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Move alias live/staging to a version.", "title": "Script Publish", "verification": ["script.versions", "script.get"], "verify": [{"action": "script.versions", "predicate": "named resource is visible"}, {"action": "script.get", "predicate": "named resource is visible"}], "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "budget_exceeded": "Fabric budget — wait retry_after_ms or narrow publish batch", "caps_approval_required": "approve_caps or config.agent_can_approve_caps — see caps_diff", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before publish", "index_update_failed": "DNA index patch failed — verify generation_env_uuid anchor", "preflight_blocked": "Run preflight.check action=script.publish first", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "public_run_no_eligible_exports": "No export has approve_public_run — owner script.publish with approve_public_run=true", "script_not_found": "script.put on resolved_env_uuid — verify script.versions", "script_publish_failed": "Unexpected publish failure — inspect data", "server_busy": "Publish lane saturated — retry after retry_after_ms", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "version_not_found": "Check script.versions"}, "when_not_to_use": "Not for sandbox verification — dry_run/test under generation_env_uuid first. Does not run exports; only moves live/staging alias after caps preflight.", "when_to_use": "Requires stackscript_admin (or project write + caps). After auth.switch_project in the same execute batch, rely on batch_session_promote so preflight sees the tenant pid. Promote version to live/stagi", "workflow_ladder": ["script.docs?topic=syntax — TypeScript export shapes before script.put", "script.put validate_only=true — compile receipt only (persisted=false)", "script.put persist — version + code_hash from receipt", "script.test (version=latest) on the same script_id — before publish", "script.dry_run with export + input — inspect write_set and cost.fuel", "preflight.check action=script.publish — caps / approval preview", "script.publish alias live after caps approval if caps_diff.requires_approval", "script.run on prod only after generation.promote when using sandbox", "logic.attach_template tpl_stackscript_trigger_shell (field_values from put receipt)", "logic.dry_run — verify nested_stackscript trace on script_processor steps"], "write_mode": null}, {"action": "script.rollback", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.rollback", "mutation_risk": "low", "related_tools": ["script.versions", "script.publish"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Rollback"}, "do_not_use_when": "Alias move only — does not fix broken exports; recompile or script.put after rollback.", "effect": {"conditional_mutate": "Repoints live script alias via publish; not a read.", "effect_depends_on_params": true, "execution_class": "cheap", "generation": true, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "caps_approval_required": "approve_caps=true on script.rollback", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before rollback", "index_update_failed": "Same as script.publish — index patch failed", "preflight_blocked": "Run preflight.check action=script.publish first", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_rollback_failed": "Unexpected rollback failure — inspect data", "version_not_found": "Target version missing"}, "example_params": {"approve_caps": true, "reason": "example_string", "script_id": "example_string", "to_version": 123}, "example_request": {"action": "script.rollback", "params": {"approve_caps": true, "reason": "example_string", "script_id": "example_string", "to_version": 123}}, "execution_class": "cheap", "instruction_hint": "Point live alias at prior version — script.versions first. Same preflight/caps gates as script.publ…", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "preflight_action": "preflight.check", "related_tools": ["script.versions", "script.publish"], "required_cap": "stackscript_admin", "requires_preflight": true, "risk_class": "low_write", "rollback": [], "safe_action": "script_rollback", "sdk_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Rollback live alias to a prior version.", "title": "Script Rollback", "verification": ["script.versions", "script.get"], "verify": [{"action": "script.versions", "predicate": "named resource is visible"}, {"action": "script.get", "predicate": "named resource is visible"}], "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "caps_approval_required": "approve_caps=true on script.rollback", "generation_fork_required": "Fork sandbox — bind generation_env_uuid before rollback", "index_update_failed": "Same as script.publish — index patch failed", "preflight_blocked": "Run preflight.check action=script.publish first", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_rollback_failed": "Unexpected rollback failure — inspect data", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "version_not_found": "Target version missing"}, "when_not_to_use": "Alias move only — does not fix broken exports; recompile or script.put after rollback.", "when_to_use": "Point live alias at prior version — script.versions first. Same preflight/caps gates as script.publish.", "write_mode": null}, {"action": "script.versions", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.versions", "mutation_risk": "low", "related_tools": ["script.get", "script.publish"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Versions"}, "do_not_use_when": "Index metadata — not source bodies; use script.get with version= or studio_bundle.", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Reads resolve against generation_env_uuid when set in MCP context (sandbox anchor); otherwise production project slice", "effect_depends_on_params": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "not_found": "Unknown script_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_not_found": "Unknown script_id — script.list or script.put first"}, "execution_class": "plain_read", "instruction_hint": "List versions before publish or rollback.", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.get", "script.publish"], "required_cap": "stackscript_read", "requires_preflight": false, "risk_class": "read", "safe_action": "script_versions", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "List versions and aliases for a script.", "title": "Script Versions", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "env_uuid_conflict": "Omit env_uuid to inherit batch head, or align with generation_env_uuid", "not_found": "Unknown script_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_not_found": "Unknown script_id — script.list or script.put first"}, "when_not_to_use": "Index metadata — not source bodies; use script.get with version= or studio_bundle.", "when_to_use": "List versions before publish or rollback.", "write_mode": null}, {"action": "script.recompile_version", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.recompile_version", "mutation_risk": "low", "related_tools": ["script.versions", "script.dry_run", "script.put"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Recompile Version"}, "do_not_use_when": "Not for new semver — script.put allocates versions. Does not publish live alias.", "effect": {"execution_class": "heavy", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Version meta missing code_hash", "cap_not_implemented": "Same as script.put — ctx.dna.cas is compile fail-closed; see script.docs topic=host", "compile_failed": "Fix diagnostics[] then recompile", "export_body_stubbed_p1": "P1 body unsupported — script.docs topic=syntax", "generation_fork_required": "Bind generation_env_uuid before recompile", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_recompile_failed": "Unexpected recompile failure — inspect diagnostics", "sources_missing": "No retained sources on version — script.put again", "ssbc_blob_unreadable": "Storage upload failed — check storage.get_quota", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "version_not_found": "script.versions — pick numeric version"}, "execution_class": "heavy", "instruction_hint": "Refresh SSBC + meta.exports from retained sources for an existing version (legacy entry_pc heal wit…", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.versions", "script.dry_run", "script.put"], "required_cap": "stackscript_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "script_recompile_version", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Re-compile retained sources for a version; refresh SSBC blob and meta.exports (heal legacy entry_pc without script.put bump).", "title": "Script Recompile Version", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Version meta missing code_hash", "cap_not_implemented": "Same as script.put — ctx.dna.cas is compile fail-closed; see script.docs topic=host", "compile_failed": "Fix diagnostics[] then recompile", "export_body_stubbed_p1": "P1 body unsupported — script.docs topic=syntax", "generation_fork_required": "Bind generation_env_uuid before recompile", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_recompile_failed": "Unexpected recompile failure — inspect diagnostics", "sources_missing": "No retained sources on version — script.put again", "ssbc_blob_unreadable": "Storage upload failed — check storage.get_quota", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "version_not_found": "script.versions — pick numeric version"}, "when_not_to_use": "Not for new semver — script.put allocates versions. Does not publish live alias.", "when_to_use": "Refresh SSBC + meta.exports from retained sources for an existing version (legacy entry_pc heal without allocating a new version).", "write_mode": null}, {"action": "script.profile", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.profile", "mutation_risk": "low", "related_tools": ["script.run", "script.dry_run", "script.versions"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Profile"}, "do_not_use_when": "Read-only aggregates — not DNA repair; use stackscript.dna.replay / wallet.replay with paths from a failed script.run.", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Reads resolve against generation_env_uuid when set in MCP context (sandbox anchor); otherwise production project slice", "effect_depends_on_params": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_not_found": "Unknown script_id for this generation_env_uuid slice"}, "execution_class": "plain_read", "instruction_hint": "Invocation fuel + optrace rollup for script_id — scoped with generation_env_uuid when set.", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.run", "script.dry_run", "script.versions"], "required_cap": "stackscript_read", "requires_preflight": false, "risk_class": "read", "safe_action": "script_profile", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Execution aggregates and hot lines.", "title": "Script Profile", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_not_found": "Unknown script_id for this generation_env_uuid slice"}, "when_not_to_use": "Read-only aggregates — not DNA repair; use stackscript.dna.replay / wallet.replay with paths from a failed script.run.", "when_to_use": "Invocation fuel + optrace rollup for script_id — scoped with generation_env_uuid when set.", "write_mode": null}, {"action": "script.archive", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.archive", "mutation_risk": "low", "related_tools": ["script.list", "script.delete", "script.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Archive"}, "do_not_use_when": "Soft-hide listing — does not delete bytecode; script.delete for removal.", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Retires script from Studio index; SSBC versions remain. Prefer archive over script.delete; tenant DNA via generation.promote after sandbox", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"archive_failed": "Index leaf write failed — bind generation_env_uuid in sandbox", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "not_found": "Unknown script_id — script.list or script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_id_required": "params.script_id required", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "execution_class": "cheap", "instruction_hint": "Retire script from default flows without purging SSBC — reversible in sandbox.", "language": "typescript", "mutation_kind": "entity", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.list", "script.delete", "script.get"], "required_cap": "stackscript_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "script_archive", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Archive a script index entry (reversible via script.put index patch in sandbox). Does not delete SSBC versions — use script.delete for tombstone.", "title": "Script Archive", "when_blocked": {"archive_failed": "Index leaf write failed — bind generation_env_uuid in sandbox", "auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "not_found": "Unknown script_id — script.list or script.put", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_id_required": "params.script_id required", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "when_not_to_use": "Soft-hide listing — does not delete bytecode; script.delete for removal.", "when_to_use": "Retire script from default flows without purging SSBC — reversible in sandbox.", "write_mode": null}, {"action": "script.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.delete", "mutation_risk": "low", "related_tools": ["script.archive", "script.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Script Delete"}, "do_not_use_when": "Destructive — not reversible via MCP. Not for sandbox experiments (generation.promote path instead).", "effect": {"conditional_mutate": "Tombstones script index (destructive). Use generation_env_uuid + promote; preflight.check when batching with other script.* mutates", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "delete_failed": "Index tombstone failed — sandbox + generation.promote for tenants", "not_found": "Unknown script_id — script.list", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_id_required": "params.script_id required", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "execution_class": "cheap", "instruction_hint": "Tombstone script index (destructive). Prefer script.archive; tenant DNA via generation.promote afte…", "language": "typescript", "mutation_kind": "entity", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "preflight_action": "preflight.check", "related_tools": ["script.archive", "script.list"], "required_cap": "stackscript_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "script_delete", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Tombstone script index (destructive). SSBC blobs may remain for audit — prefer script.archive when retiring from Studio.", "title": "Script Delete", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "delete_failed": "Index tombstone failed — sandbox + generation.promote for tenants", "not_found": "Unknown script_id — script.list", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "script_id_required": "params.script_id required", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "when_not_to_use": "Destructive — not reversible via MCP. Not for sandbox experiments (generation.promote path instead).", "when_to_use": "Tombstone script index (destructive). Prefer script.archive; tenant DNA via generation.promote after sandbox script.delete.", "write_mode": null}, {"action": "script.room.status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.room.status", "mutation_risk": "low", "related_tools": ["script.room.create", "script.room.join", "script.room.leave", "script.room.tick"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Script Room Status"}, "do_not_use_when": "In-process table only — not cross-worker SoT; create on the same worker that ticks. Not authoritative board/revision — poll DNA runtime.{matchId}.* or journal CAS.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name (or name) required", "service_cap_denied": "Operator session needs mcp_read — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "example_params": {"room_name": "lobby"}, "example_request": {"action": "script.room.status", "params": {"room_name": "lobby"}}, "execution_class": "plain_read", "instruction_hint": "In-process script.room table — read exists/player_count before join/tick smoke.", "language": "typescript", "mutation_kind": "none", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.room.create", "script.room.join", "script.room.leave", "script.room.tick"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "script_room_status", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Read in-process StackScript room runtime state (script.room.* table; no defineRoom TS API).", "title": "Script Room Status", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name (or name) required", "service_cap_denied": "Operator session needs mcp_read — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "when_not_to_use": "In-process table only — not cross-worker SoT; create on the same worker that ticks. Not authoritative board/revision — poll DNA runtime.{matchId}.* or journal CAS.", "when_to_use": "In-process script.room table — read exists/player_count before join/tick smoke.", "write_mode": null}, {"action": "script.room.create", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.room.create", "mutation_risk": "low", "related_tools": ["script.room.join", "script.room.leave", "script.room.status", "script.docs"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Script Room Create"}, "do_not_use_when": "Not persistent multi-host rooms — same-process demo; not DNA-backed lobbies.", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "auth_required_to_host": "Anonymous hosted guest — quick_match/join/solo OK; sign in to host custom room (TG 2177)", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name required — MCP script.room.create", "room_table_full": "Process room table full with seated rooms — script.room.status, leave idle rooms, or retry on another worker", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "example_params": {"room_name": "lobby", "tick_hz": 20}, "example_request": {"action": "script.room.create", "params": {"room_name": "lobby", "tick_hz": 20}}, "execution_class": "cheap", "instruction_hint": "Host a custom in-process room (defineRoom lab). Anonymous guests: rooms.quick_match or script.room.…", "language": "typescript", "mutation_kind": "entity", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.room.join", "script.room.leave", "script.room.status", "script.docs"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "script_room_create", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Create in-process StackScript room (MCP script.room.create — not a TS defineRoom export).", "title": "Script Room Create", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "auth_required_to_host": "Anonymous hosted guest — quick_match/join/solo OK; sign in to host custom room (TG 2177)", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name required — MCP script.room.create", "room_table_full": "Process room table full with seated rooms — script.room.status, leave idle rooms, or retry on another worker", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)"}, "when_not_to_use": "Not persistent multi-host rooms — same-process demo; not DNA-backed lobbies.", "when_to_use": "Host a custom in-process room (defineRoom lab). Anonymous guests: rooms.quick_match or script.room.join — not create.", "write_mode": null}, {"action": "script.room.join", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.room.join", "mutation_risk": "low", "related_tools": ["script.room.create", "script.room.leave", "script.room.status", "script.room.tick"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Script Room Join"}, "do_not_use_when": "Not account provisioning — requires wallet user_id; room must exist (script.room.create).", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_full": "Seat cap reached — leave players or create another room_name", "room_name_required": "params.room_name required", "room_not_found": "script.room.create first — join does not create rooms", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "wallet_user_required": "MCP session user_id required — params.user_id cannot impersonate", "workflow_scope_leak": "params.user_id must match session user_id — body cannot override principal"}, "example_params": {"room_name": "lobby"}, "example_request": {"action": "script.room.join", "params": {"room_name": "lobby"}}, "execution_class": "cheap", "instruction_hint": "Join authenticated operator to in-process room table (mcp_write). Uses MCP context user_id; params.…", "language": "typescript", "mutation_kind": "entity", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.room.create", "script.room.leave", "script.room.status", "script.room.tick"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "script_room_join", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Join player to in-process room table.", "title": "Script Room Join", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_full": "Seat cap reached — leave players or create another room_name", "room_name_required": "params.room_name required", "room_not_found": "script.room.create first — join does not create rooms", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "wallet_user_required": "MCP session user_id required — params.user_id cannot impersonate", "workflow_scope_leak": "params.user_id must match session user_id — body cannot override principal"}, "when_not_to_use": "Not account provisioning — requires wallet user_id; room must exist (script.room.create).", "when_to_use": "Join authenticated operator to in-process room table (mcp_write). Uses MCP context user_id; params.user_id must match or be omitted (no defineRoom — rooms are script.room.* only).", "write_mode": null}, {"action": "script.room.leave", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.room.leave", "mutation_risk": "low", "related_tools": ["script.room.join", "script.room.status", "script.room.create"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Script Room Leave"}, "do_not_use_when": "Not quick-match lifecycle — use rooms.leave for QM seats; idempotent when room already gone.", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name required", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "wallet_user_required": "MCP session user_id required — params.user_id cannot impersonate", "workflow_scope_leak": "params.user_id must match session user_id — body cannot override principal"}, "example_params": {"room_name": "lobby"}, "example_request": {"action": "script.room.leave", "params": {"room_name": "lobby"}}, "execution_class": "cheap", "instruction_hint": "Remove authenticated operator seat from in-process room table; empty rooms close (GC / room_table_f…", "language": "typescript", "mutation_kind": "entity", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.room.join", "script.room.status", "script.room.create"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "script_room_leave", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Leave in-process StackScript room seat; empty rooms close.", "title": "Script Room Leave", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "room_name_required": "params.room_name required", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "wallet_user_required": "MCP session user_id required — params.user_id cannot impersonate", "workflow_scope_leak": "params.user_id must match session user_id — body cannot override principal"}, "when_not_to_use": "Not quick-match lifecycle — use rooms.leave for QM seats; idempotent when room already gone.", "when_to_use": "Remove authenticated operator seat from in-process room table; empty rooms close (GC / room_table_full relief). Not rooms.leave quick-match — use script.room.* for StackScript lobby smoke.", "write_mode": null}, {"action": "script.room.tick", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "script.room.tick", "mutation_risk": "low", "related_tools": ["script.room.status", "script.publish", "script.get", "script.profile"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Script Room Tick"}, "do_not_use_when": "Not cron/scheduler — client must poll; not write-set preview — script.dry_run. Unbound room_name fails closed with room_not_bound (no ok:true skip).", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Live SSBC unreadable — script.recompile_version or script.put on host script", "bytecode_stale": "Live SSBC compiler_version mismatch — script.recompile_version before script.room.tick", "commit_failed": "DNA commit failed after VM — retry same tick idempotency key or dna.replay", "db_unavailable": "Postgres blip — retry same tick idempotency key after pool healthy", "dna_path_binding_invalid": "Path binding has characters outside [A-Za-z0-9_.:-] — shorten room_name", "dna_path_binding_missing": "Room export DNA path uses $matchId or $room_id but tick input has no binding", "dna_prefetch_failed": "DNA prefetch before room tick failed — narrow read_paths on defineRoom export", "dna_repair_pending": "Prior room tick left dna_repair_path — stackscript.dna.replay before next tick", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "rate_limited": "ok with skipped:true — wait until last_tick_at + 1/tick_hz or poll script.room.status", "read_paths_prefetch_exceeded": "Too many read_paths on room export — split DNA reads across smaller exports", "revision_conflict": "Runtime revision moved. Retry script.room.tick with the same idempotency room:{pid}:{room_name}:{tick}. Do not script.run the room export.", "revision_prefetch_failed": "Runtime revision leaf probe failed before tick VM — fix project DNA slice / room bind; transient pool errors return db_unavailable with same idempotency key", "revision_required": "Reserved for non–room_host commits. script.room.tick uses caller_kind=room_host: prefetched revision_gate + in-txn CAS — clients do not pass expected_revision on ticks. Co-op / player turns use script.run with input.expected_revision instead.", "room_host_run_failed": "Room VM tick failed — see diagnostics and fuel_used", "room_name_required": "params.room_name required", "room_not_bound": "No live defineRoom export — script.put + script.publish live with kind=room or script.room.create with matching room_name", "room_not_found": "script.room.create first — tick does not create the room", "run_in_progress": "Concurrent retry for same tick — idempotency room:{pid}:{room_name}:{tick}; wait retry_after_ms", "run_lock_timeout": "Concurrent tick for same idempotency key — wait retry_after_ms or use room:{pid}:{name}:{tick}", "run_timeout": "Room tick VM exceeded STACKSCRIPT_ROOM_TICK_VM_SEC (default 2s) — shrink onTick", "script_not_found": "room host script_id missing from index — script.publish live after defineRoom", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_fuel_quota_exceeded": "Monthly fuel cap exceeded — top up or lower tick_hz", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "Legacy SSBC dispatch layout — script.recompile_version off the room tick hot path", "tick_failed": "Unexpected tick failure — room missing returns room_not_found (not ok:false skip)", "wallet_commit_failed": "Room tick ledger step failed — stackscript.wallet.replay with wallet_repair_path or retry tick after balances fixed", "wallet_insufficient_funds": "Top up commerce wallet before wallet.debit in room onTick export", "wallet_partial_state": "Room tick ledger partial — stackscript.wallet.replay before next script.room.tick", "wallet_user_required": "MCP session must include operator user_id for room tick wallet caps"}, "example_params": {"room_name": "lobby"}, "example_request": {"action": "script.room.tick", "params": {"room_name": "lobby"}}, "execution_class": "cheap", "instruction_hint": "Server authority tick (≤20 Hz), not a client frame — commits the live defineRoom export. Clients se…", "language": "typescript", "mutation_kind": "entity", "plane_chooser": "Browser/React/WebGL in App Studio uses ai_builder.* + publish — not script.put. StackScript ladder: script.docs → script.put (validate_only then persist) → script.test → script.dry_run → preflight.check action=script.publish → script.publish → script.run on prod. Heavy deterministic game/economy math belongs here, not logic.create. Persistent script.put in agentstack.execute needs options.execution_intent=direct or options.goal (validate_only exempt). logic.dry_run nests script.dry_run for script_processor steps.", "playbook_steps": ["script.docs?topic=syntax", "script.put validate_only", "script.test", "script.dry_run", "preflight.check action=script.publish", "script.publish", "script.run (prod slice only)", "generation.promote when auto_generation_mode", "logic.dry_run nested_stackscript", "script.versions", "script.rollback if needed", "agents.work_next read-only verify"], "related_tools": ["script.room.status", "script.publish", "script.get", "script.profile"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "script_room_tick", "semantic_input_mode": "inherit_workflow", "source_file_extension": ".ts", "stackscript_atoms": {"STACKSCRIPT_EXECUTE_ANCHOR": "Persistent script.put in agentstack.execute: set options.execution_intent to direct (or validate for compile-only batches). Does not bypass RBAC/caps/preflight. validate_only=true on script.put needs no anchor. See batch_semantic_anchor_required example_recovery on errors.", "STACKSCRIPT_EXPORT_NAMING": "script.dry_run export= must match SSBC export name: defineFn first string arg, defineCommand.name field, or export const id for defineFn arrow — not arbitrary aliases.", "STACKSCRIPT_GAME_PROMOTE_LADDER": "Games / tenant DNA: run recipe mcp_stackscript_sandbox_v1 (generation fork + compile/test) before mcp_stackscript_promote_v1 — never promote-only on prod slice. See docs/operations/TG1692_WT2052_PROMOTE_LADDER.md.", "STACKSCRIPT_INDEX_LOOKUP": "script.run index fetch uses STACKSCRIPT_INDEX_LOOKUP_SEC (default 15s). On db_unavailable after timeout, retry with same idempotency_key when pool is healthy.", "STACKSCRIPT_IS_TYPESCRIPT": "StackScript sources are TypeScript (.ts): write normal TS syntax in files[].content (defineCommand/defineFn exports, @stack/runtime, @stack/std). Not JSON logic rules — not arbitrary JS; subset: int-only math, idiv() not /, no float literals. Fixed math: ctx.math.fixedMul/fixedDiv with explicit scale; Math.floor/imul are int-only — see stackscript/spec/language.md § Numeric model. Call script.docs?topic=syntax for canonical export shapes.", "STACKSCRIPT_MIGRATION": "script.docs?topic=migration — pair JSON triggers with StackScript exports; logic.dry_run nests script.dry_run trace for script_processor steps.", "STACKSCRIPT_P1_EXPORT_BODY": "P1 export bodies: int locals, if/else, for/while, idiv() for division, return int or { ok, n, ... }; ctx.dna.read/write with read_paths/write_paths caps; ctx.math.fixedMul/fixedDiv; sibling helpers when all .ts files are in the same script.put files[] batch (imports do not load files automatically).", "STACKSCRIPT_PUT_FIRST": "Imperative game/business logic: script.put → script.test → script.dry_run before script.publish. Do not use logic.create for heavy loops — use script_processor call.", "STACKSCRIPT_RUNTIME_VARS": "Durable state: DNA ecosystem.scripts.runtime.<key> via dna.write cap; script.dry_run returns write_set preview; script.run commits leaves (prod).", "STACKSCRIPT_SANDBOX_SCOPE": "auto_generation_mode: script.put/test/dry_run/get/list use generation_env_uuid; generation.diff_vs_prod path_prefixes ecosystem.scripts; script.run commits prod only.", "STACKSCRIPT_STORAGE_PLANE": "TS sources and SSBC bytes live in platform storage (ecosystem/system files); 8DNA holds storage_ref pointers only — not inline b64 in project slice.", "STACKSCRIPT_ZERO_ARG_INPUT": "Zero-parameter exports: omit input, null, [], and {} are equivalent in script.test, script.dry_run, and script.run — do not pass {} when input is omitted (test ABI parity)."}, "summary": "Advance one room tick (≤20 Hz) and commit bound defineRoom export (idempotency room:{pid}:{room_name}:{tick}).", "title": "Script Room Tick", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "bytecode_missing": "Live SSBC unreadable — script.recompile_version or script.put on host script", "bytecode_stale": "Live SSBC compiler_version mismatch — script.recompile_version before script.room.tick", "commit_failed": "DNA commit failed after VM — retry same tick idempotency key or dna.replay", "db_unavailable": "Postgres blip — retry same tick idempotency key after pool healthy", "dna_path_binding_invalid": "Path binding has characters outside [A-Za-z0-9_.:-] — shorten room_name", "dna_path_binding_missing": "Room export DNA path uses $matchId or $room_id but tick input has no binding", "dna_prefetch_failed": "DNA prefetch before room tick failed — narrow read_paths on defineRoom export", "dna_repair_pending": "Prior room tick left dna_repair_path — stackscript.dna.replay before next tick", "project_id_required": "Bind context.project_id", "project_not_found": "Unknown project or not a member — bind context.project_id", "rate_limited": "ok with skipped:true — wait until last_tick_at + 1/tick_hz or poll script.room.status", "read_paths_prefetch_exceeded": "Too many read_paths on room export — split DNA reads across smaller exports", "revision_conflict": "Runtime revision moved. Retry script.room.tick with the same idempotency room:{pid}:{room_name}:{tick}. Do not script.run the room export.", "revision_prefetch_failed": "Runtime revision leaf probe failed before tick VM — fix project DNA slice / room bind; transient pool errors return db_unavailable with same idempotency key", "revision_required": "Reserved for non–room_host commits. script.room.tick uses caller_kind=room_host: prefetched revision_gate + in-txn CAS — clients do not pass expected_revision on ticks. Co-op / player turns use script.run with input.expected_revision instead.", "room_host_run_failed": "Room VM tick failed — see diagnostics and fuel_used", "room_name_required": "params.room_name required", "room_not_bound": "No live defineRoom export — script.put + script.publish live with kind=room or script.room.create with matching room_name", "room_not_found": "script.room.create first — tick does not create the room", "run_in_progress": "Concurrent retry for same tick — idempotency room:{pid}:{room_name}:{tick}; wait retry_after_ms", "run_lock_timeout": "Concurrent tick for same idempotency key — wait retry_after_ms or use room:{pid}:{name}:{tick}", "run_timeout": "Room tick VM exceeded STACKSCRIPT_ROOM_TICK_VM_SEC (default 2s) — shrink onTick", "script_not_found": "room host script_id missing from index — script.publish live after defineRoom", "service_cap_denied": "Operator session needs mcp_write — Connect MCP or widen service_caps", "stackscript_fuel_quota_exceeded": "Monthly fuel cap exceeded — top up or lower tick_hz", "stackscript_runtime_unavailable": "StackScript VM not in backend image — run python agentstack-core/build_core.py then deploy RebuildBackend (stackscript/py must ship under /app/stackscript/py)", "stale_artifact": "Legacy SSBC dispatch layout — script.recompile_version off the room tick hot path", "tick_failed": "Unexpected tick failure — room missing returns room_not_found (not ok:false skip)", "wallet_commit_failed": "Room tick ledger step failed — stackscript.wallet.replay with wallet_repair_path or retry tick after balances fixed", "wallet_insufficient_funds": "Top up commerce wallet before wallet.debit in room onTick export", "wallet_partial_state": "Room tick ledger partial — stackscript.wallet.replay before next script.room.tick", "wallet_user_required": "MCP session must include operator user_id for room tick wallet caps"}, "when_not_to_use": "Not cron/scheduler — client must poll; not write-set preview — script.dry_run. Unbound room_name fails closed with room_not_bound (no ok:true skip).", "when_to_use": "Server authority tick (≤20 Hz), not a client frame — commits the live defineRoom export. Clients send inputs via script.run; do not write the board over relay. idempotency_key room:{pid}:{room_name}:{", "write_mode": null}], "seo": [{"action": "seo.meta.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "seo", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["docs.seo.surface.gen1"], "id": "seo.meta.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Seo Meta Get"}, "domain_title": "Seo MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.seo.gen1"], "instruction_hint": "Public marketing meta for path (title, OG, JSON-LD).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.seo", "owner_gene": "core.mcp.seo.gen1", "plane": "SEO surface: seo.meta.get — indexable meta caps in shared/seo/; not hosting bytes.", "plane_chooser": "Marketing meta: seo.meta.get path=/…. Copy caps live in shared/seo — not hosting.bucket.file.patch. After registry/deploy copy changes: seo.cache.clear; readiness: seo.health.check.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "seo_meta_get", "semantic_input_mode": "inherit_workflow", "summary": "Fetch dynamic meta tags for a public marketing path (title, description, OG, JSON-LD).", "title": "Seo Meta Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Public marketing meta for path (title, OG, JSON-LD).", "write_mode": null}, {"action": "seo.health.check", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "seo", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["docs.seo.surface.gen1"], "id": "seo.health.check", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Seo Health Check"}, "domain_title": "Seo MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.seo.gen1"], "instruction_hint": "SEO registry + indexable path readiness.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.seo", "owner_gene": "core.mcp.seo.gen1", "plane": "SEO surface: seo.meta.get — indexable meta caps in shared/seo/; not hosting bytes.", "plane_chooser": "Marketing meta: seo.meta.get path=/…. Copy caps live in shared/seo — not hosting.bucket.file.patch. After registry/deploy copy changes: seo.cache.clear; readiness: seo.health.check.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "seo_health_check", "semantic_input_mode": "inherit_workflow", "summary": "SEO registry version, indexable path count, and hosting funnel readiness.", "title": "Seo Health Check", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "SEO registry + indexable path readiness.", "write_mode": null}, {"action": "seo.cache.clear", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "seo", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["docs.seo.surface.gen1"], "id": "seo.cache.clear", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Seo Cache Clear"}, "domain_title": "Seo MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.seo.gen1"], "instruction_hint": "Invalidate SEO neural cache; optional IndexNow ping.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.seo", "owner_gene": "core.mcp.seo.gen1", "plane": "SEO surface: seo.meta.get — indexable meta caps in shared/seo/; not hosting bytes.", "plane_chooser": "Marketing meta: seo.meta.get path=/…. Copy caps live in shared/seo — not hosting.bucket.file.patch. After registry/deploy copy changes: seo.cache.clear; readiness: seo.health.check.", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "seo_cache_clear", "semantic_input_mode": "inherit_workflow", "summary": "Invalidate neural SEO meta + robots/sitemap caches; optionally ping IndexNow.", "title": "Seo Cache Clear", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Invalidate SEO neural cache; optional IndexNow ping.", "write_mode": null}], "services": [{"action": "services.diagnostic_sow_draft", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "services", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.services.gen1"], "id": "services.diagnostic_sow_draft", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Services Diagnostic Sow Draft"}, "do_not_use_when": "Guest lead capture — use POST /api/public/services/inquiry (202), not this tool.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"persist_failed": "CRM activity append failed after SoW render", "sku_required": "sku parameter required", "unknown_sku": "SKU not in public services catalog"}, "execution_class": "plain_read", "genetic_tag": "frontend.public.services_offers.gen1", "instruction_hint": "Staff kickoff after guest POST /api/public/services/inquiry (202, notify_pending). Draft diagnostic…", "mutation_kind": "none", "next_actions": ["crm.get_contact_360", "services.kickoff_slot_status", "GET /api/public/services/kickoff-preflight"], "required_cap": "mcp_read", "requires_preflight": false, "rest_bridge": {"genetic_tag": "frontend.public.services_offers.gen1", "method": "POST", "response": "202", "rest_path": "/api/public/services/inquiry", "when_blocked": {"inquiry_unavailable": {"hint": "CRM persist failed — retry in a minute; do not double-charge kickoff.", "next": "GET /api/public/services/catalog"}, "rate_limit_exceeded": {"hint": "10 inquiries/hour per client — wait or email studio directly.", "next": "POST /api/public/services/inquiry"}, "unknown_sku": {"hint": "sku must match services_offers_v1 listed id (shop.enablement unrelated).", "next": "GET /api/public/services/catalog"}}, "when_to_use": "POST /api/public/services/inquiry — guest CRM lead (ecosystem pid=1). Returns 202 with inquiry_id + notify_pending; email/Telegram fan-out is async. Fields: sku (listed catalog id), name, email, message (≥10), optional company, locale, source (e.g. investors_portal, services_spa), format_pick. Honeypot: website non-empty → 202 accepted, no CRM. Errors: 400 unknown_sku, 422 validation, 429 rate_limit, 503 inquiry_unavailable. Not checkout — paid kickoff: GET /api/public/services/kickoff-preflight."}, "risk_class": "read", "safe_action": "services_diagnostic_sow_draft", "semantic_input_mode": "inherit_workflow", "summary": "Render a studio diagnostic (kickoff) SoW markdown from the services catalog fixture. Staff-only on ecosystem project 1.", "title": "Services Diagnostic Sow Draft", "when_blocked": {"persist_failed": "CRM activity append failed after SoW render", "sku_required": "sku parameter required", "unknown_sku": "SKU not in public services catalog"}, "when_not_to_use": "Guest lead capture — use POST /api/public/services/inquiry (202), not this tool.", "when_to_use": "Staff kickoff after guest POST /api/public/services/inquiry (202, notify_pending). Draft diagnostic SoW; optional contact_id from inquiry response.", "write_mode": null}, {"action": "services.kickoff_slot_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "services", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.services.gen1"], "id": "services.kickoff_slot_status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Services Kickoff Slot Status"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"validation_failed": "sku and contact_id required"}, "execution_class": "plain_read", "genetic_tag": "frontend.public.services_offers.gen1", "instruction_hint": "Preflight kickoff slot/buff state before scheduling or applying delivery.", "mutation_kind": "none", "required_cap": "mcp_read", "requires_preflight": false, "rest_bridge": {"method": "GET", "rest_path": "/api/public/services/kickoff-preflight", "when_to_use": "Guest-visible kickoff gate — same preflight as SPA after inquiry."}, "risk_class": "read", "safe_action": "services_kickoff_slot_status", "semantic_input_mode": "inherit_workflow", "summary": "Read kickoff slot status for CRM contact (optional payer user buff merge).", "title": "Services Kickoff Slot Status", "when_blocked": {"validation_failed": "sku and contact_id required"}, "when_to_use": "Preflight kickoff slot/buff state before scheduling or applying delivery.", "write_mode": null}, {"action": "services.apply_delivery_slot", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "services", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.services.gen1"], "id": "services.apply_delivery_slot", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Services Apply Delivery Slot"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"apply_failed": "delivery slot grant failed", "unknown_sku": "SKU not in catalog", "validation_failed": "head_project_id and sku required"}, "execution_class": "cheap", "genetic_tag": "frontend.public.services_offers.gen1", "instruction_hint": "After signed SoW — reserve phase-1 delivery slot on tenant head project.", "mutation_kind": "entity", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "services_apply_delivery_slot", "semantic_input_mode": "inherit_workflow", "summary": "Grant phase-1 studio delivery slot on tenant head project (data.ecosystem.buffs[] protected). After signed main SoW.", "title": "Services Apply Delivery Slot", "when_blocked": {"apply_failed": "delivery slot grant failed", "unknown_sku": "SKU not in catalog", "validation_failed": "head_project_id and sku required"}, "when_to_use": "After signed SoW — reserve phase-1 delivery slot on tenant head project.", "write_mode": null}], "shop": [{"action": "shop.products.upsert", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.products.upsert", "related_tools": ["assets.create", "shop.enablement.status", "shop.products.list", "commerce.channel_pass.configure", "commerce.channel_pass.binding.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Products Upsert", "visitor_callable": false}, "channel_pass_sku_examples": {"base_30d": {"grants": [{"amount": 30, "asset_id": "nebula", "kind": "channel_pass"}], "prices": [{"amount_minor": 333300, "currency": "RUB"}], "project_id": "<context.project_id>", "sku_id": "nebula_30", "status": "active", "title": {"ru": "nebula — 30 дней"}}, "manual_personal": {"description": "Напишите ответственному — оплата отдельно.", "grants": [{"amount": 1, "asset_id": "nebula", "kind": "manual_request"}], "project_id": "<context.project_id>", "sku_id": "nebula_personal", "status": "active", "title": {"ru": "Персональный продукт"}}, "proportional_90d": {"grants": [{"amount": 90, "asset_id": "nebula", "kind": "channel_pass"}], "prices": [{"amount_minor": 999900, "currency": "RUB"}], "project_id": "<context.project_id>", "rules": {"base_sku": "nebula_30", "pricing": "proportional"}, "sku_id": "nebula_90", "status": "active", "title": {"ru": "nebula — 90 дней"}}}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"grants": [{"amount": 100, "asset_id": "asset_gold_id", "kind": "currency"}], "prices": [{"amount_minor": 99, "currency": "USD"}], "project_id": 1438, "sku_id": "coins_100", "status": "active"}, "example_params_channel_pass": {"grants": [{"amount": 30, "asset_id": "nebula", "kind": "channel_pass"}], "prices": [{"amount_minor": 333300, "currency": "RUB"}], "project_id": "<context.project_id>", "sku_id": "nebula_30", "status": "active", "title": {"ru": "nebula — 30 дней"}}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Owner: SKU in 8DNA — grants kind currency (soft pack) or digital_item (cosmetic). Catalog cosmetics…", "kind": "mcp_domain", "mutation_kind": "entity", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "preflight_hint": "Run preflight.check with action=shop.products.upsert and the same grants to catch channel_binding_missing before mutate.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["assets.create", "shop.enablement.status", "shop.products.list", "commerce.channel_pass.configure", "commerce.channel_pass.binding.get"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "shop_products_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Create or update an in-app SKU (server-priced IAP pack).", "title": "Shop Products Upsert", "when_blocked": {"asset_not_currency": "Use asset type currency for soft-currency grants.", "asset_not_digital_item": "Grant kind digital_item needs assets.create type=digital_item (or service/nft).", "auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "channel_binding_missing": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "db_unavailable": "Postgres pool transient (deploy/recovery) — wait for GET /api/ready 200, honor retry_after_ms, same idempotency_key.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "invalid_channel_pass_period": "channel_pass grant amount must be period_days ≥ 1 — fix grants[].amount on shop.products.upsert.", "invalid_price": "Add at least one ISO price row to the SKU.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "proportional_base_sku_invalid": "Base SKU document failed validation — fix base SKU grants/prices before proportional child.", "proportional_base_sku_missing": "rules.base_sku must reference an existing catalog SKU — shop.products.list then upsert base first.", "proportional_base_sku_required": "rules.pricing=proportional needs rules.base_sku pointing to another SKU (not self).", "proportional_currency_mismatch": "Each price currency on proportional SKU must exist on base SKU prices.", "proportional_grants_required": "Proportional SKU and base SKU both need grants[] with period in amount.", "proportional_invalid_period": "Grant amount (period days) must be ≥ 1 on proportional SKU and base SKU.", "proportional_price_mismatch": "amount_minor must equal base amount_minor × (period / base_period) — no manual discount tiers; adjust period or base price.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "unknown_asset": "Create currency asset in catalog before SKU grants.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Owner: SKU in 8DNA — grants kind currency (soft pack) or digital_item (cosmetic). Catalog cosmetics: assets.create then grants asset_id. Lightweight cosmetics: grants kind=digital_item item_key=<game_", "write_mode": null}, {"action": "shop.enablement.status", "agent_checklist": "1) Distinguish IAP vs AgentPay vs marketplace vs fuel. 2) auth.get_profile + context.project_id. 3)…", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "shop.enablement.status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Enablement Status", "visitor_callable": true}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"project_id": 1438}, "examples": [{"name": "Sell gate before catalog/checkout", "request": {"params": {"project_id": 1444}, "tool": "shop.enablement.status"}, "response": {"data": {"blockers": [], "catalog_configured": true, "sell_enabled": true}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Read sell gate + blockers before checkout; sandbox_ok when test checkout allowed.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["shop.products.list", "shop.products.upsert", "assets.create"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "shop_enablement_status", "semantic_input_mode": "inherit_workflow", "summary": "Read-only sell gate: live checkout vs sandbox-only blockers.", "title": "Shop Enablement Status", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "bot_not_admin": "Channel bot is not administrator in the bound chat — add bot as admin with invite rights, then commerce.channel_pass.configure to refresh binding and run channel_pass_doctor.", "catalog_auth_required": "iap_public_catalog=false — guest browse blocked; sign in player or owner enables public catalog.", "channel_binding_missing": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "project_not_found": "Project slice missing or no membership — confirm project_id via projects.list / context.project_id.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sandbox_checkout_only": "sandbox_ok on enablement snap is test checkout only — read sandbox_bypass_honesty (cosmetic_only_when_sandbox / live_money). Live charges need sell_enabled + hosted publish.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Read sell gate + blockers before checkout; sandbox_ok when test checkout allowed.", "write_mode": null}, {"action": "shop.sandbox.simulate", "ai_tips": "Owner-only: sandbox checkout without live PSP — payment_method=test only (zero-PSP).", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"effect_depends_on_params": false, "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "shop.sandbox.simulate", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Sandbox Simulate", "visitor_callable": false}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"effect_depends_on_params": false, "kind": "mutate", "read_only_hint": false}, "example_params": {"payment_method": "example_string", "project_id": 123, "sku_id": "example_string", "user_id": 123}, "example_request": {"action": "shop.sandbox.simulate", "params": {"payment_method": "example_string", "project_id": 123, "sku_id": "example_string", "user_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Owner-only: sandbox checkout without live PSP — payment_method=test only (zero-PSP).", "kind": "mcp_domain", "mutation_kind": "body", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "shop_sandbox_simulate", "semantic_input_mode": "inherit_workflow", "summary": "Simulate checkout+fulfill in sandbox mode (no PSP charge).", "title": "Shop Sandbox Simulate", "verification": ["shop.orders.get", "shop.entitlements.list"], "verify": [{"action": "shop.orders.get", "predicate": "named resource is visible"}, {"action": "shop.entitlements.list", "predicate": "named resource is visible"}], "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "catalog_not_configured": "No active IAP SKUs — probe shop.enablement.status; owner path: assets.create → shop.products.upsert (status=active). Draft SKUs can be prepared while sell is off.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "idempotency_key_required": "Generate stable UUID per checkout or spend attempt.", "payment_method_unsupported": "shop.sandbox.simulate allows payment_method=test only (zero-PSP owner path).", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sandbox_checkout_requires_test_mode": "Enable sandbox_checkout_enabled in IAP DNA or IAP_TEST_CHECKOUT in dev before zero-PSP simulate.", "sandbox_disabled": "Set ecosystem.commerce.iap.sandbox_checkout_enabled or use dev APP_ENV + payment_method=test.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "sku_inactive": "Owner sets SKU status active via shop.products.upsert.", "sku_not_found": "Refresh catalog — owner shop.products.upsert in sandbox."}, "when_to_use": "Owner-only: sandbox checkout without live PSP — payment_method=test only (zero-PSP).", "write_mode": null}, {"action": "shop.products.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.products.list", "related_tools": ["shop.checkout.create", "payments.list_methods", "wallets.balance"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Products List", "visitor_callable": true}, "do_not_use_when": "Post-deploy or audit MCP batches expecting universal success — probe shop.enablement.status blockers instead.", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Visitor IAP catalog", "request": {"params": {"locale": "en-US", "project_id": 1444}, "tool": "shop.products.list"}, "response": {"data": {"products": [{"sku_id": "coin_pack_s"}]}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Visitor catalog on /s/{pid}/ — locale/currency filters; prices from DNA SKU.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["shop.enablement.status", "shop.products.upsert", "assets.create"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.checkout.create", "payments.list_methods", "wallets.balance"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "shop_products_list", "semantic_input_mode": "inherit_workflow", "summary": "List active IAP SKUs for visitors or all for owner.", "title": "Shop Products List", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "catalog_auth_required": "iap_public_catalog=false — guest browse blocked; sign in player or owner enables public catalog.", "catalog_not_configured": "No active IAP SKUs — probe shop.enablement.status; owner path: assets.create → shop.products.upsert (status=active). Draft SKUs can be prepared while sell is off.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_not_to_use": "Post-deploy or audit MCP batches expecting universal success — probe shop.enablement.status blockers instead.", "when_to_use": "Visitor catalog on /s/{pid}/ — locale/currency filters; prices from DNA SKU.", "write_mode": null}, {"action": "shop.checkout.create", "agent_checklist": "1) Distinguish IAP vs AgentPay vs marketplace vs fuel. 2) auth.get_profile + context.project_id. 3)…", "ai_tips": "Start pay flow; amount from SKU only. Requires idempotency_key + same-origin return_url. PAY-01: fail-closed when PSP returns no checkout_url/client_secret (psp_session_missing). payments.create uses metadata.recipient_project_id=tenant pid; payer DNA stays on profile project. digital_item SKUs use intent tenant_iap (no currency_code in pay meta). channel_pass SKUs stack period_days on CP:{binding_id}; bot checkout stamps buyer_subject. After redirect with ?iap_checkout=1&iap_payment_id=, hosted visitors use GET /api/commerce/iap/checkout/resume (hosted_app cookie, credentials include) — not payments.get. Bot deep link without a cookie: GET /api/commerce/iap/checkout/public-session.", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Server-priced order; same idempotency_key+sku+return_url may return replayed=true.", "kind": "mutate", "mutates_when": "always", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.checkout.create", "related_tools": ["shop.products.list", "payments.list_methods", "shop.orders.get", "payments.get", "shop.enablement.status"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Shop Checkout Create", "visitor_callable": true}, "do_not_use_when": "Do not use payments.create with client grant_amount for hosted SKU checkout.", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Server-priced order; same idempotency_key+sku+return_url may return replayed=true.", "execution_class": "cheap", "kind": "mutate", "mutates_when": "always", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Server-priced order; same idempotency_key+sku+return_url may return replayed=true.", "kind": "mutate", "mutates_when": "always", "read_only_hint": false}, "example_params": {"currency": "example_string", "idempotency_key": "example_string", "payment_method": "example_string", "project_id": 123, "return_url": "example_string", "sku_id": "example_string"}, "example_request": {"action": "shop.checkout.create", "params": {"currency": "example_string", "idempotency_key": "example_string", "payment_method": "example_string", "project_id": 123, "return_url": "example_string", "sku_id": "example_string"}}, "examples": [{"name": "Server-priced checkout (idempotent)", "request": {"params": {"idempotency_key": "iap-demo-stable-key-1", "project_id": 1444, "return_url": "https://agentstack.tech/s/1444/game?iap_checkout=1", "sku_id": "coin_pack_s"}, "tool": "shop.checkout.create"}, "response": {"data": {"checkout_url": "https://checkout.example/session", "order_id": "<uuid>", "payment_id": "<uuid>", "replayed": false}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "hosted_resume_bff": "/api/commerce/iap/checkout/resume", "instruction_hint": "Start pay flow; amount from SKU only.", "kind": "mcp_domain", "mutation_kind": "body", "navigation": ["payments.list_methods", "shop.products.list", "shop.orders.get", "payments.get"], "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["shop.orders.get", "payments.get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "payment_method_default": "card", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "receipt_rule": "Poll shop.orders.get until fulfilled; payments.get until soft_currency_grant.status=ok. Hosted card return: GET /api/commerce/iap/checkout/resume?project_id=&payment_id= after ?iap_checkout=1 — not payments.get for visitors.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.products.list", "payments.list_methods", "shop.orders.get", "payments.get", "shop.enablement.status"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "rollback": ["shop.orders.cancel"], "safe_action": "shop_checkout_create", "semantic_input_mode": "inherit_workflow", "summary": "Start visitor checkout for a SKU (server price; no client amount).", "title": "Shop Checkout Create", "treasury_note": "Project treasury / wallet settlement is not the hosted buyer checkout rail.", "verification": ["shop.orders.get", "payments.get"], "verify": [{"action": "shop.orders.get", "predicate": "named resource is visible"}, {"action": "payments.get", "predicate": "named resource is visible"}], "when_blocked": {"anonymous_account": "Anonymous accounts cannot sell. Register or sign in — a free account can sell with a higher platform commission (15%); paid plans use 3%.", "auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "buyer_subject_required": "channel_pass checkout needs buyer_subject (telegram external_user_id) in order metadata when any grant kind is channel_pass — use bot /passes or stamp metadata on shop.checkout.create.", "catalog_auth_required": "iap_public_catalog=false — guest browse blocked; sign in player or owner enables public catalog.", "catalog_not_configured": "No active IAP SKUs — probe shop.enablement.status; owner path: assets.create → shop.products.upsert (status=active). Draft SKUs can be prepared while sell is off.", "client_amount_forbidden": "Omit amount/amount_minor — shop.checkout.create prices from shop.products.list SKU.", "commerce_routers_pending": "Commerce REST routers still mounting after cold start — honor retry_after_ms, poll GET /api/ready until deferred commerce is ready, then shop.checkout.create.", "currency_not_supported": "Use a currency present on the SKU price row.", "execution_error": "Timeout or db_unavailable: same idempotency_key after GET /api/ready. New idempotency_key only after price_changed, idempotency_mismatch, or shop.orders.reconcile_stale.", "flags_divergent": "sell_enabled=true but commerce_iap_feature=false — platform flag mismatch; live PSP checkout stays blocked until flags align. Use shop.sandbox.simulate when sandbox_ok.", "forbidden_for_visitor": "Visitors: no shop.fulfill and no skip_sell_check on checkout — use shop.checkout.create with live sell gate; poll shop.orders.get.", "hosted_iap_return": "Mount Stripe from resume client_secret or assign checkout_url; strip query after terminal status. Static games: hosted-sdk-cdn iapCheckoutBoot.runIapCheckoutBootOnLoad().", "hosted_unpublished": "Hosted app /s/{project_id}/ is not published — visitors cannot complete live checkout while active SKUs exist. Exception: channel_only channel_pass (bot checkout) when enablement.channel_only_checkout_allowed is true. Owner: hosting.publish; or bot-only pass SKUs with channel_only binding.", "hosting_unavailable": "Hosting publish state could not be read — retry shop.enablement.status; ops: verify hosting service before live checkout.", "iap_order_required": "shop.checkout.create first — order_id only on currency_pack from that checkout; payments.create rejects sale intent with metadata.order_id (iap_order_required).", "idempotency_key_required": "Generate stable UUID per checkout or spend attempt.", "idempotency_mismatch": "Same idempotency_key but different return_url — use a new key or match the stored return_url.", "invalid_order": "IAP order missing price snapshot — re-checkout with new idempotency_key.", "invalid_parameters": "Fix checkout params — payment_method defaults to card; server prices from SKU. Read message for ValidationError detail.", "missing_payment_id": "PSP did not return payment_id — check AgentPay/Stripe project keys; order marked failed; retry shop.checkout.create with new idempotency_key.", "no_active_products": "SKUs exist but none are active — shop.products.upsert status=active or add a new active SKU.", "order_already_fulfilled": "Order already granted — do not replay payments.create or fulfill.", "order_amount_mismatch": "Internal payments.create after checkout must match SQL order amount_minor — never edit amount; re-run shop.checkout.create with new idempotency_key if SKU price changed.", "order_currency_mismatch": "Payment currency must match order row — use shop.checkout.create SKU price.", "order_not_found": "Use order_id from checkout response.", "order_not_payable": "Order not pending_payment — poll shop.orders.get before bind.", "order_project_mismatch": "metadata.recipient_project_id must match SQL order project_id and context.project_id.", "order_sku_mismatch": "Payment SKU metadata must match order — no client amount bypass.", "order_user_mismatch": "Payer user_id must match commerce_iap_orders.user_id — auth.get_profile.", "payment_create_failed": "AgentPay session failed — read order payment_error / payment_error_code. Checkout uses server-priced SKU + metadata.order_id bind (currency_pack or tenant_iap); payments.get may show ecosystem profile project_id — use metadata.recipient_project_id and metadata.order_id for IAP. Failed orders stay failed: retry shop.checkout.create with a new idempotency_key. Resume: GET /api/commerce/iap/checkout/resume. Else payments.list_methods + shop.enablement.status.", "payment_id_in_use": "PSP payment_id already bound — response includes bound_order_id; poll that order or start checkout with a new idempotency_key.", "preferred_method_required": "Pass payment_method card (or stripe/tochka) — omit for default card checkout.", "price_changed": "SKU price changed since order was created — new idempotency_key to re-quote server price.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "psp_not_configured": "Configure Stripe/Tochka BYOK keys + webhooks (/api/payments/webhooks/stripe/{pid}, /webhooks/tochka/{pid}) — then payments.list_methods.", "psp_session_missing": "PAY-01 fail-closed: PSP did not return checkout_url or client_secret — order marked failed. Check Stripe/Tochka keys on recipient_project_id, payments.list_methods, then shop.checkout.create with a new idempotency_key (not the same shop-order-{order_id}).", "rate_limit_exceeded": "IAP checkout/resume throttle (per user+project) — honor retry_after_ms or HTTP Retry-After, then retry shop.checkout.create. After the window, the same idempotency_key may return replayed=true without a new PSP session.", "return_url_invalid": "return_url must stay under /s/{project_id}/ on the same host.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "sku_changed": "Owner changed SKU since order row was created — use a new idempotency_key.", "sku_inactive": "Owner sets SKU status active via shop.products.upsert.", "sku_no_grants": "SKU has no grants[] — shop.products.upsert with grants: [{kind: currency, asset_id, amount}] or digital_item.", "sku_not_found": "Refresh catalog — owner shop.products.upsert in sandbox.", "unsupported_payment_method": "Checkout: payment_method card|stripe|tochka only — not wallet/crypto. See payments.list_methods before shop.checkout.create."}, "when_not_to_use": "Do not use payments.create with client grant_amount for hosted SKU checkout.", "when_to_use": "Start pay flow; amount from SKU only.", "write_mode": null}, {"action": "shop.orders.get", "agent_checklist": "1) Distinguish IAP vs AgentPay vs marketplace vs fuel. 2) auth.get_profile + context.project_id. 3)…", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.orders.get", "related_tools": ["shop.checkout.create", "payments.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Orders Get", "visitor_callable": true}, "do_not_use_when": "Merchant attention tail — use shop.orders.list with attention_only=true; get is buyer-safe single-order poll only.", "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"name": "Poll order after ?iap_checkout=1 redirect", "request": {"params": {"order_id": "<uuid-from-checkout>", "project_id": 1444}, "tool": "shop.orders.get"}, "response": {"data": {"status": "pending_payment", "terminal": false}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "hosted_resume_bff": "/api/commerce/iap/checkout/resume", "instruction_hint": "Poll order status after redirect; own orders only for hosted_app.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["payments.get"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "receipt_rule": "Poll until status=fulfilled and terminal=true, or terminal failed/cancelled. terminal=false when channel_pass_invites_pending is non-empty (including fulfilled). grant_pending: metadata.last_grant_error (invite_failed → replay shop.fulfill). Response may include channel_pass_invites_pending and channel_pass_invite_recovery for composite pass SKUs. Visitors: GET /api/commerce/iap/checkout/public-session (awaiting_fulfillment) or /checkout/resume — not payments.get.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.checkout.create", "payments.get"], "required_cap": "mcp_read", "requires_preflight": false, "response_fields": {"awaiting_fulfillment": "True when fulfilled but Telegram invites incomplete.", "channel_pass_bindings": "Binding ids on enriched row (metadata and/or grants_snapshot).", "channel_pass_invite_recovery": "Composite pass SKU operator recovery text.", "channel_pass_invites_pending": "Binding ids still missing Telegram invite.", "fulfillment_phase": "Top-level mirror of metadata.fulfillment_phase on merchant list/order rows.", "metadata.channel_pass_bindings": "Binding ids stamped at checkout (copy of grants_snapshot channel_pass legs).", "metadata.fulfillment_phase": "Merchant metadata: invites_pending | complete — denorm for attention_only SQL.", "metadata.last_grant_error": "Last grant/invite error when grant_pending or invite gap.", "recovery_hint": "Buyer-safe poll hint when terminal=false.", "status": "Order lifecycle status.", "terminal": "False when channel_pass_invites_pending is non-empty (buyer and merchant)."}, "risk_class": "read", "safe_action": "shop_orders_get", "semantic_input_mode": "inherit_workflow", "summary": "Poll IAP order status after checkout redirect.", "title": "Shop Orders Get", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "checkout_resume_auth": "Hosted IAP return: GET /api/commerce/iap/checkout/resume?project_id=&payment_id= with player Bearer/cookie after ?iap_checkout=1 — operators use payments.get, visitors do not.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "hosted_iap_return": "Mount Stripe from resume client_secret or assign checkout_url; strip query after terminal status. Static games: hosted-sdk-cdn iapCheckoutBoot.runIapCheckoutBootOnLoad().", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "order_not_found": "Use order_id from checkout response.", "payment_not_found": "Payment DNA missing for order-bound payment_id — shop.orders.reconcile_stale, then shop.checkout.create with new idempotency_key; operators poll payments.get.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "rate_limit_exceeded": "IAP checkout/resume throttle (per user+project) — honor retry_after_ms or HTTP Retry-After, then retry shop.checkout.create. After the window, the same idempotency_key may return replayed=true without a new PSP session.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_not_to_use": "Merchant attention tail — use shop.orders.list with attention_only=true; get is buyer-safe single-order poll only.", "when_to_use": "Poll order status after redirect; own orders only for hosted_app.", "write_mode": null}, {"action": "shop.orders.reconcile_stale", "ai_tips": "Operator PAY-01: fail stale pending_payment without PSP URL/secret (buyer-owned order or project owner). Not on hosted /s/ allowlist — buyers use shop.orders.cancel. After payment_not_found on resume, shop.checkout.create with a new idempotency_key. Poll payments.get (L1 operator) for soft_currency_grant.status=ok; visitors poll shop.orders.get only.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "shop.orders.reconcile_stale", "mutation_risk": "low", "related_tools": ["shop.orders.get", "shop.checkout.create", "payments.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Orders Reconcile Stale", "visitor_callable": false}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"kind": "mutate", "read_only_hint": false}, "example_params": {"max_age_seconds": 123, "order_id": "example_string", "project_id": 123}, "example_request": {"action": "shop.orders.reconcile_stale", "params": {"max_age_seconds": 123, "order_id": "example_string", "project_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Operator PAY-01: fail stale pending_payment without PSP URL/secret (buyer-owned order or project ow…", "kind": "mcp_domain", "mutation_kind": "body", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.orders.get", "shop.checkout.create", "payments.get"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "shop_orders_reconcile_stale", "semantic_input_mode": "inherit_workflow", "summary": "Fail stale pending_payment orders without a PSP checkout session (PAY-01).", "title": "Shop Orders Reconcile Stale", "verification": ["shop.orders.get"], "verify": [{"action": "shop.orders.get", "predicate": "named resource is visible"}], "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "order_not_found": "Use order_id from checkout response.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Operator PAY-01: fail stale pending_payment without PSP URL/secret (buyer-owned order or project owner).", "write_mode": null}, {"action": "shop.orders.cancel", "ai_tips": "Buyer abandons pending_payment with no PSP URL — then shop.checkout.create with new idempotency_key.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "shop.orders.cancel", "related_tools": ["shop.orders.get", "shop.checkout.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Orders Cancel", "visitor_callable": true}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"order_id": "example_string", "project_id": 123}, "example_request": {"action": "shop.orders.cancel", "params": {"order_id": "example_string", "project_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Abandon stuck checkout — new idempotency_key on shop.checkout.create.", "kind": "mcp_domain", "mutation_kind": "body", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.orders.get", "shop.checkout.create"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "rollback": [], "safe_action": "shop_orders_cancel", "semantic_input_mode": "inherit_workflow", "summary": "Cancel stuck pending_payment IAP order (buyer-owned).", "title": "Shop Orders Cancel", "verification": ["shop.orders.get"], "verify": [{"action": "shop.orders.get", "predicate": "named resource is visible"}], "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "order_not_cancelable": "Buyer cancel allowed for pending_payment, created, or failed only — paid/fulfilled/grant_pending need shop.refund (owner) or support; poll shop.orders.get.", "order_not_found": "Use order_id from checkout response.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Abandon stuck checkout — new idempotency_key on shop.checkout.create.", "write_mode": null}, {"action": "shop.orders.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.orders.list", "related_tools": ["shop.orders.get", "shop.checkout.create", "shop.fulfill", "commerce.channel_pass.sweep"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Orders List", "visitor_callable": true}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"limit": 50, "project_id": "<context.project_id>"}, "example_params_attention_only": {"attention_only": true, "limit": 20, "project_id": "<context.project_id>"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Visitor purchase history (hosted, scoped user_id) — rows include terminal, channel_pass_invites_pen…", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["shop.orders.get", "shop.fulfill"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "receipt_rule": "Merchant attention_only surfaces invite gaps — replay shop.fulfill; on-call sweep via commerce.channel_pass.sweep or scheduler.create_task.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.orders.get", "shop.checkout.create", "shop.fulfill", "commerce.channel_pass.sweep"], "required_cap": "mcp_read", "requires_preflight": false, "response_fields": {"attention_only": "Request param: when true, project_admin may omit user_id to list grant_pending/paid/created plus fulfillment_phase=invites_pending and fulfilled channel_pass invite gaps project-wide.", "channel_pass_bindings": "Binding ids on enriched row (metadata and/or grants_snapshot).", "channel_pass_invites_pending": "Binding ids still missing Telegram invite.", "fulfillment_phase": "Top-level mirror of metadata.fulfillment_phase on merchant list/order rows.", "metadata.channel_pass_bindings": "Binding ids stamped at checkout (copy of grants_snapshot channel_pass legs).", "metadata.fulfillment_phase": "Merchant metadata: invites_pending | complete — denorm for attention_only SQL.", "metadata.last_grant_error": "Merchant-only last grant/invite error code when present.", "orders": "Array of enriched IAP order rows (buyer or merchant surface).", "terminal": "False when channel_pass_invites_pending is non-empty (buyer and merchant)."}, "risk_class": "read", "safe_action": "shop_orders_list", "semantic_input_mode": "inherit_workflow", "summary": "Visitor purchase history (hosted, scoped user_id) — rows include terminal, channel_pass_invites_pending, recovery_hint (buyer-safe). Merchant support tail: attention_only=true (project_admin, omit use", "title": "Shop Orders List", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "forbidden": "Own buyer scope; attention_only without project_admin or cross-user user_id is forbidden.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "validation_error": "Fix SKU payload — shop.products.upsert partial fields; read validation message."}, "when_to_use": "Visitor purchase history (hosted, scoped user_id) — rows include terminal, channel_pass_invites_pending, recovery_hint (buyer-safe).", "write_mode": null}, {"action": "shop.sinks.upsert", "ai_tips": "Owner: configure spend sinks (cost vectors) for wallets.spend.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.sinks.upsert", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Sinks Upsert", "visitor_callable": false}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Owner: configure spend sinks (cost vectors) for wallets.spend.", "kind": "mcp_domain", "mutation_kind": "body", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "shop_sinks_upsert", "semantic_input_mode": "inherit_workflow", "summary": "Owner: configure spend sinks (cost vectors) for wallets.spend.", "title": "Shop Sinks Upsert", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "invalid_debit": "Ledger debit vector invalid for sink — owner shop.sinks.upsert.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "unknown_asset": "Create currency asset in catalog before SKU grants."}, "when_to_use": "Owner: configure spend sinks (cost vectors) for wallets.spend.", "write_mode": null}, {"action": "shop.fulfill", "ai_tips": "Internal only — webhook worker after PSP success; never visitor-callable. grant_pending retry: order_id only when payment_id is on the order row. Each delivered invite appends binding_id via order_store.append_channel_pass_invite_sent (idempotent). While channel_pass_invites_pending is non-empty, finalize stays grant_pending (message channel_pass_invites_pending). Every channel_pass grant gets its own invite (metadata.channel_pass_invites_sent). Composite extras use ledger ref {order_id}:cp:{leg}.", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.fulfill", "related_tools": ["shop.orders.get", "commerce.channel_pass.status", "commerce.channel_pass.configure", "commerce.channel_pass.binding.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Fulfill", "visitor_callable": false}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Internal only — webhook worker after PSP success; never visitor-callable.", "kind": "mcp_domain", "mutation_kind": "body", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["shop.orders.get", "commerce.channel_pass.status", "commerce.channel_pass.configure"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "receipt_rule": "Internal webhook worker only. Invites append metadata.channel_pass_invites_sent via append_channel_pass_invite_sent; replay until channel_pass_invites_pending is empty. bot_not_admin: grant bot channel admin, commerce.channel_pass.configure, then replay.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.orders.get", "commerce.channel_pass.status", "commerce.channel_pass.configure", "commerce.channel_pass.binding.get"], "required_cap": "service_internal", "requires_preflight": false, "response_fields": {"channel_pass_bindings": "Binding ids on enriched row (metadata and/or grants_snapshot).", "channel_pass_invites_pending": "Binding ids still missing Telegram invite.", "error": "Grant or delivery code (buyer_subject_required, outbound_failed, invite_failed, invite_stamp_failed, bot_not_admin, bot_not_found, channel_binding_missing, …).", "message": "Human hint such as channel_pass_invites_pending.", "metadata.channel_pass_bindings": "Binding ids stamped at checkout (copy of grants_snapshot channel_pass legs).", "metadata.fulfillment_phase": "Merchant metadata: invites_pending | complete — denorm for attention_only SQL.", "pending_bindings": "Binding ids still missing Telegram invite (channel_pass).", "recoverable": "True when order is grant_pending and shop.fulfill may be retried."}, "risk_class": "low_write", "safe_action": "shop_fulfill", "semantic_input_mode": "inherit_workflow", "summary": "System: fulfill paid order (idempotent).", "title": "Shop Fulfill", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "bonus_grant_failed": "Base grant ok; bonus pending — replay internal fulfill or poll shop.orders.get.", "bot_not_admin": "Channel bot is not administrator in the bound chat — add bot as admin with invite rights, then commerce.channel_pass.configure to refresh binding and run channel_pass_doctor.", "bot_not_found": "Bot runtime missing for channel binding — verify bot_id on ecosystem.commerce.channels.{binding_id}.", "buyer_subject_required": "channel_pass checkout needs buyer_subject (telegram external_user_id) in order metadata when any grant kind is channel_pass — use bot /passes or stamp metadata on shop.checkout.create.", "channel_binding_missing": "channel_pass SKU references binding_id with no ecosystem.commerce.channels.{id} leaf — call commerce.channel_pass.configure (chat_id, bot_id, channel_only) then shop.products.upsert.", "entitlement_grant_failed": "Entitlement grant failed after ledger/inventory step — for channel_pass replay shop.fulfill after buyer_subject + channel binding; for digital_item fix SKU grants/assets then replay.", "forbidden_for_visitor": "Visitors: no shop.fulfill and no skip_sell_check on checkout — use shop.checkout.create with live sell gate; poll shop.orders.get.", "fulfill_claim_lost": "Concurrent fulfill lost claim — safe idempotent retry shop.fulfill.", "grant_failed": "Paid order grant_pending — replay shop.fulfill (worker) or poll shop.orders.get.", "invalid_grant": "SKU grants snapshot invalid — fix grants on shop.products.upsert.", "invalid_grants_snapshot": "SKU grants snapshot on order row is invalid — owner fixes SKU DNA.", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "invalid_order_status": "Order not in pending/paid state for fulfill — poll shop.orders.get.", "inventory_grant_failed": "digital_item inventory grant failed — verify asset_id then retry fulfill.", "invite_failed": "Grant succeeded but Telegram invite/outbound failed or pending bindings remain — order may be grant_pending; retry shop.fulfill; verify bot admin on channel. shop.fulfill may return message channel_pass_invites_pending with pending_bindings — each binding must appear in metadata.channel_pass_invites_sent before terminal=true on shop.orders.get.", "invite_stamp_failed": "Telegram invite was sent but order metadata stamp failed — replay shop.fulfill; do not charge again. Check DB row metadata.channel_pass_invites_sent.", "order_amount_mismatch": "Internal payments.create after checkout must match SQL order amount_minor — never edit amount; re-run shop.checkout.create with new idempotency_key if SKU price changed.", "order_currency_mismatch": "Payment currency must match order row — use shop.checkout.create SKU price.", "order_not_found": "Use order_id from checkout response.", "order_not_fulfillable": "Order refunded, canceled, or chargeback — do not replay fulfill.", "order_sku_mismatch": "Payment SKU metadata must match order — no client amount bypass.", "order_user_mismatch": "Payer user_id must match commerce_iap_orders.user_id — auth.get_profile.", "outbound_failed": "Telegram invite link created but bot outbound failed — check bot queue and replay shop.fulfill.", "payment_id_in_use": "PSP payment_id already bound — response includes bound_order_id; poll that order or start checkout with a new idempotency_key.", "payment_id_mismatch": "Fulfill must use the payment_id bound at checkout/PSP.", "payment_id_required": "Pending order needs PSP payment_id from webhook before shop.fulfill.", "payment_not_completed": "Poll payments.get until wallet_credit=ok before shop.fulfill.", "payment_order_mismatch": "payments.create metadata.order_id must match checkout order_id.", "payment_verify_failed": "Retry after PSP webhook; check payment_id on order row.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "provider_not_supported": "Channel pass checkout requires telegram buyer_subject — use bot /passes flow.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Internal only — webhook worker after PSP success; never visitor-callable.", "write_mode": null}, {"action": "shop.refund", "ai_tips": "Owner refund fulfilled/paid/grant_pending with optional clawback (default true). Composite channel_pass SKUs shorten access first; response includes clawback map and channel_pass_legs when applicable. Not visitor-callable.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.refund", "related_tools": ["shop.orders.get", "shop.orders.list", "commerce.channel_pass.status", "shop.reports.summary"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Refund", "visitor_callable": false}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"clawback": true, "order_id": "example_string", "project_id": 123}, "example_request": {"action": "shop.refund", "params": {"clawback": true, "order_id": "example_string", "project_id": 123}}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Owner refund fulfilled/paid/grant_pending with optional clawback (default true).", "kind": "mcp_domain", "mutation_kind": "body", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "next_actions": ["shop.orders.get", "shop.orders.list"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.orders.get", "shop.orders.list", "commerce.channel_pass.status", "shop.reports.summary"], "required_cap": "project_admin", "requires_preflight": true, "response_fields": {"channel_pass": "Last channel_pass leg summary when order had pass grants.", "channel_pass_bindings": "Binding ids on enriched row (metadata and/or grants_snapshot).", "channel_pass_legs": "Per-binding refund legs on composite pass SKUs.", "clawback": "Per-asset amounts clawed from wallet (currency legs only).", "legs_applied": "Count of CP legs shortened before a mid-loop failure.", "metadata.channel_pass_bindings": "Binding ids stamped at checkout (copy of grants_snapshot channel_pass legs).", "metadata.fulfillment_phase": "Merchant metadata: invites_pending | complete — denorm for attention_only SQL.", "partial_refund": "True when a multi-binding pass refund failed mid-loop.", "replayed": "True when order was already refunded/chargeback.", "unrecovered_amount": "Shortfall when wallet balance < ledger owed."}, "risk_class": "financial", "rollback": [], "safe_action": "shop_refund", "semantic_input_mode": "inherit_workflow", "summary": "Owner refund fulfilled/paid/grant_pending with optional clawback (default true). Composite channel_pass SKUs shorten access first; response includes clawback map and channel_pass_legs when applicable.", "title": "Shop Refund", "verification": ["shop.orders.get", "payments.get"], "verify": [{"action": "shop.orders.get", "predicate": "named resource is visible"}, {"action": "payments.get", "predicate": "named resource is visible"}], "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "channel_pass_refund_failed": "Entitlement shorten or Telegram revoke failed mid-refund — poll shop.orders.get; retry shop.refund idempotently if status is not terminal. Partial multi-binding refunds expose legs_applied in service response.", "clawback_failed": "Inspect unrecovered_amount in refund response payload.", "invalid_order_id": "Use UUID order_id from shop.checkout.create.", "order_not_found": "Use order_id from checkout response.", "order_not_refundable": "Refund fulfilled, paid, or grant_pending orders — not pending_payment/canceled.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "refund_failed": "Refund clawback or status transition failed — inspect error payload.", "refund_in_progress": "Refund may be resuming after a crash — retry shop.refund (idempotent per-asset ledger).", "revoke_failed": "Telegram ban/revoke failed after entitlement expired on refund — verify bot admin; retry shop.refund (idempotent). Response may include partial_refund and legs.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "wallet_service_unavailable": "Wallet ops offline — retry refund or support."}, "when_to_use": "Owner refund fulfilled/paid/grant_pending with optional clawback (default true).", "write_mode": null}, {"action": "shop.reports.summary", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.reports.summary", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Reports Summary", "visitor_callable": false}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Owner: gross/refunds rollup from commerce_iap_orders.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "shop_reports_summary", "semantic_input_mode": "inherit_workflow", "summary": "Owner: gross/refunds rollup from commerce_iap_orders.", "title": "Shop Reports Summary", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "commerce_iap_schema_missing": "Platform Postgres missing migrate_036 — run python database/platform_db_init.py or redeploy with platform_upgrade.sql.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Owner: gross/refunds rollup from commerce_iap_orders.", "write_mode": null}, {"action": "shop.webhooks.subscribe", "ai_tips": "Owner: HMAC outbound shop.order.* events to your backend.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.webhooks.subscribe", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Webhooks Subscribe", "visitor_callable": false}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Owner: HMAC outbound shop.order.* events to your backend.", "kind": "mcp_domain", "mutation_kind": "body", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "shop_webhooks_subscribe", "semantic_input_mode": "inherit_workflow", "summary": "Owner: HMAC outbound shop.order.* events to your backend.", "title": "Shop Webhooks Subscribe", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "unsafe_webhook_url": "Use public HTTPS callback; private/metadata hosts blocked."}, "when_to_use": "Owner: HMAC outbound shop.order.* events to your backend.", "write_mode": null}, {"action": "shop.audit.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap_shop.gen1"], "id": "shop.audit.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Audit List", "visitor_callable": false}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Support review of checkout/refund events — not buyer-facing.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "shop_audit_list", "semantic_input_mode": "inherit_workflow", "summary": "Owner: recent IAP audit_log events (products upsert, checkout, cancel, refund) from DNA leaf ecosystem.commerce.iap.audit_log.", "title": "Shop Audit List", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Support review of checkout/refund events — not buyer-facing.", "write_mode": null}, {"action": "shop.entitlements.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.tenant_iap.gen1", "core.commerce.tenant_iap_shop.gen1"], "id": "shop.entitlements.list", "related_tools": ["shop.orders.get", "shop.checkout.create", "wallets.balance", "rest.commerce.iap.entitlements"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Shop Entitlements List", "visitor_callable": true}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Buyer entitlements after checkout.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["shop.orders.get", "shop.checkout.create", "wallets.balance", "rest.commerce.iap.entitlements"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "shop_entitlements_list", "semantic_input_mode": "inherit_workflow", "summary": "List buyer entitlements for hosted IAP (REST parity).", "title": "Shop Entitlements List", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "include_sandbox_ignored_on_hosted": "hosted_app and GET /api/commerce/iap/entitlements are live-only — include_sandbox=true is ignored (success, not an error). Sandbox grants after shop.sandbox.simulate: operator MCP shop.entitlements.list with include_sandbox=true (project_admin session).", "project_id_required": "Hosted BFF and MCP require project_id on order poll and entitlements.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Buyer entitlements after checkout.", "write_mode": null}, {"action": "shop.embed.snippet", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.shop.gen1"], "id": "shop.embed.snippet", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "Shop Embed Snippet"}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Agent needs copy-paste HTML aligned with /commerce/lite gallery — not a new widget.", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "shop_embed_snippet", "semantic_input_mode": "inherit_workflow", "summary": "HTML embed snippet from commerce-surface-snippets fixture for agents.", "title": "Shop Embed Snippet", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder."}, "when_to_use": "Agent needs copy-paste HTML aligned with /commerce/lite gallery — not a new widget.", "write_mode": null}], "showcase": [{"action": "showcase.catalog.get", "aliases": ["showcase.catalog"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.get", "related_tools": ["showcase.catalog.list_entries", "showcase.health.probe", "showcase.entry.resolve"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Get"}, "domain_title": "Showcase MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Full merged catalog + settings + health for ecosystem pid=1. Entries expose icon_path + icon_candid…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.list_entries", "showcase.health.probe", "showcase.entry.resolve"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "showcase_catalog_get", "semantic_input_mode": "inherit_workflow", "summary": "Merged public showcase catalog (ecosystem DNA + fixture seed). Each catalog.entries[] row includes icon_path and icon_candidates (svg/png/webp/jpg fallback chain under /showcase/icons/). Prefer showca", "title": "Showcase Catalog Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Full merged catalog + settings + health for ecosystem pid=1. Entries expose icon_path + icon_candidates resolved from project DNA brand leaves (showcase.icon_url, showcase.logo_url) with catalog overr", "write_mode": null}, {"action": "showcase.catalog.list_entries", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.list_entries", "related_tools": ["showcase.catalog.get", "showcase.entry.resolve"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog List Entries"}, "domain_title": "Showcase MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Discover gallery cards without full catalog.get — each row has icon_path for UI/MCP agents. Pair wi…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.get", "showcase.entry.resolve"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "showcase_catalog_list_entries", "semantic_input_mode": "inherit_workflow", "summary": "Lightweight list of showcase catalog cards (merged). Each row includes icon_path + icon_candidates (svg→png→webp→jpg) for gallery and MCP agents.", "title": "Showcase Catalog List Entries", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Discover gallery cards without full catalog.get — each row has icon_path for UI/MCP agents. Pair with showcase.entry.resolve before build/republish.", "write_mode": null}, {"action": "showcase.catalog.patch_entry", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.patch_entry", "mutation_risk": "low", "related_tools": ["showcase.catalog.get", "showcase.catalog.diff_vs_fixture", "showcase.health.probe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Patch Entry"}, "do_not_use_when": "Tenant demo DNA — safe_project_cycle + generation.promote, not catalog upsert on tenant pid.", "domain_title": "Showcase MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Edit title, tagline, hosting_bucket, status, or SEO overrides on one card — merged base, DNA leaf w…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.get", "showcase.catalog.diff_vs_fixture", "showcase.health.probe"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_catalog_patch_entry", "semantic_input_mode": "inherit_workflow", "summary": "Partial update of one merged gallery card on ecosystem DNA (project_id=1). Uses effective catalog (DNA + fixture fill) as base. Patch keys match ShowcaseCatalogEntry fields (title, tagline, hosting_bu", "title": "Showcase Catalog Patch Entry", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "unknown_entry": "Unknown catalog entry_id — sync fixture or showcase.catalog.sync_fixture on ecosystem pid=1", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Tenant demo DNA — safe_project_cycle + generation.promote, not catalog upsert on tenant pid.", "when_to_use": "Edit title, tagline, hosting_bucket, status, or SEO overrides on one card — merged base, DNA leaf write. Gallery updates via catalog_revision without SPA deploy.", "write_mode": null}, {"action": "showcase.catalog.diff_vs_fixture", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.diff_vs_fixture", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Diff Vs Fixture"}, "domain_title": "Showcase MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Drift report missing_in_dna / extra_in_dna before sync_fixture or export_fixture git commit.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "showcase_catalog_diff_vs_fixture", "semantic_input_mode": "inherit_workflow", "summary": "Drift report: DNA catalog entry ids vs git fixture.", "title": "Showcase Catalog Diff Vs Fixture", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Drift report missing_in_dna / extra_in_dna before sync_fixture or export_fixture git commit.", "write_mode": null}, {"action": "showcase.catalog.sync_fixture", "ai_tips": "Materialize git fixture into DNA: mode missing (new ids), align (overwrite shared fields), align_and_prune (drop extra_in_dna). After align modes, applies showcase.catalog.apply_canonical_order (games first, TailRush lead). dry_run previews drift.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "align_and_prune on prod without dry_run — removes DNA-only cards (extra_in_dna).", "anti_patterns": ["align_and_prune on prod without dry_run — removes DNA-only cards (extra_in_dna).", "Editing only public/showcase-catalog.json — does not change live gallery."], "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Materializes showcase_catalog_v1.json into ecosystem DNA; dry_run skips writes.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.sync_fixture", "mutation_risk": "low", "related_tools": ["showcase.catalog.diff_vs_fixture", "showcase.catalog.export_fixture", "showcase.health.probe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Sync Fixture"}, "domain_title": "Showcase MCP domain", "effect": {"conditional_mutate": "Materializes showcase_catalog_v1.json into ecosystem DNA; dry_run skips writes.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Materializes showcase_catalog_v1.json into ecosystem DNA; dry_run skips writes.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Materialize git fixture into DNA: mode missing (new ids), align (overwrite shared fields), align_an…", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.diff_vs_fixture", "showcase.catalog.export_fixture", "showcase.health.probe"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_catalog_sync_fixture", "semantic_input_mode": "inherit_workflow", "summary": "Pull git fixture showcase_catalog_v1.json into ecosystem DNA (pid=1) — no SPA deploy. mode=missing (default): add cards absent from DNA. mode=align: also overwrite shared ids from fixture (hosting_buc", "title": "Showcase Catalog Sync Fixture", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Materialize git fixture into DNA: mode missing (new ids), align (overwrite shared fields), align_and_prune (drop extra_in_dna). After align modes, applies showcase.catalog.apply_canonical_order (games", "write_mode": null}, {"action": "showcase.catalog.export_fixture", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.export_fixture", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Export Fixture"}, "domain_title": "Showcase MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Export merged effective catalog for committing showcase_catalog_v1.json + static mirror.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "showcase_catalog_export_fixture", "semantic_input_mode": "inherit_workflow", "summary": "Export merged catalog as fixture-shaped JSON for git sync.", "title": "Showcase Catalog Export Fixture", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Export merged effective catalog for committing showcase_catalog_v1.json + static mirror.", "write_mode": null}, {"action": "showcase.catalog.delete_entry", "ai_tips": "Remove a stale gallery card from DNA (e.g. rename hosted-game-lab → war-tactics). Does not unpublish tenant /s/ bytes.", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Deleting tenant project or hosting bucket — catalog row only; use tenant ops for /s/ bytes.", "anti_patterns": ["Deleting tenant project or hosting bucket — catalog row only; use tenant ops for /s/ bytes."], "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.delete_entry", "mutation_risk": "high", "related_tools": ["showcase.catalog.diff_vs_fixture", "showcase.catalog.sync_fixture"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Delete Entry"}, "domain_title": "Showcase MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Remove a stale gallery card from DNA (e.g. rename hosted-game-lab → war-tactics). Does not unpublis…", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.diff_vs_fixture", "showcase.catalog.sync_fixture"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "showcase_catalog_delete_entry", "semantic_input_mode": "inherit_workflow", "summary": "Remove one gallery card from ecosystem DNA (project_id=1). Drops entries_by_id, entry_order, and showcase.projects slug map. Does not delete tenant hosting bytes — use generation supply on tenant pid.", "title": "Showcase Catalog Delete Entry", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "unknown_entry": "Unknown catalog entry_id — sync fixture or showcase.catalog.sync_fixture on ecosystem pid=1", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove a stale gallery card from DNA (e.g. rename hosted-game-lab → war-tactics). Does not unpublish tenant /s/ bytes.", "write_mode": null}, {"action": "showcase.catalog.upsert_entry", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.upsert_entry", "mutation_risk": "low", "related_tools": ["showcase.catalog.patch_entry", "showcase.tenant.register"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Upsert Entry"}, "do_not_use_when": "Ecosystem pid=1 fixture supply only — not tenant heal scripts.", "domain_title": "Showcase MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Add or replace a full gallery card on pid=1 DNA. After backend ships new fixture ids, prefer showca…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.patch_entry", "showcase.tenant.register"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_catalog_upsert_entry", "semantic_input_mode": "inherit_workflow", "summary": "Upsert one full ShowcaseCatalogEntry on ecosystem DNA (pid=1). Validates schema (project_slug showcase-*, active+hosting_bucket needs project_id>2). Prefer patch_entry for copy/bucket tweaks; upsert f", "title": "Showcase Catalog Upsert Entry", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Ecosystem pid=1 fixture supply only — not tenant heal scripts.", "when_to_use": "Add or replace a full gallery card on pid=1 DNA. After backend ships new fixture ids, prefer showcase.catalog.sync_fixture mode=missing unless you need a custom row.", "write_mode": null}, {"action": "showcase.settings.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.settings.patch", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Settings Patch"}, "domain_title": "Showcase MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Featured hero card id, public_cache_max_age_s, hire_sku_map — gallery chrome without deploy.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_settings_patch", "semantic_input_mode": "inherit_workflow", "summary": "Patch showcase gallery settings on ecosystem DNA.", "title": "Showcase Settings Patch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Featured hero card id, public_cache_max_age_s, hire_sku_map — gallery chrome without deploy.", "write_mode": null}, {"action": "showcase.catalog.reorder", "ai_tips": "Change /showcase portfolio vs platform section order via entry_order. Run after sync_fixture when adding game cards.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Rewrites ecosystem DNA entry_order for gallery cards.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.reorder", "mutation_risk": "low", "related_tools": ["showcase.catalog.list_entries", "showcase.settings.patch"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Reorder"}, "domain_title": "Showcase MCP domain", "effect": {"conditional_mutate": "Rewrites ecosystem DNA entry_order for gallery cards.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Rewrites ecosystem DNA entry_order for gallery cards.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Change /showcase portfolio vs platform section order via entry_order. Run after sync_fixture when a…", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.list_entries", "showcase.settings.patch"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_catalog_reorder", "semantic_input_mode": "inherit_workflow", "summary": "Set gallery card order (entry_order on ecosystem DNA). Only ids present in DNA entries_by_id are kept; unknown ids are dropped silently.", "title": "Showcase Catalog Reorder", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Change /showcase portfolio vs platform section order via entry_order. Run after sync_fixture when adding game cards.", "write_mode": null}, {"action": "showcase.project.heal_gallery_marks", "ai_tips": "When cards lack a tenant mark — seed showcase.icon_url using BFF icon candidate order (platform monogram before generic /s/…/favicon). Skips real HTTPS/storage marks. dry_run first.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Overwriting custom showcase.icon_url — skips pids that already have a gallery-safe mark.", "anti_patterns": ["Overwriting custom showcase.icon_url — skips pids that already have a gallery-safe mark.", "Replacing catalog icon_path on pid=1 — this writes tenant project DNA only."], "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.project.heal_gallery_marks", "mutation_risk": "low", "related_tools": ["showcase.catalog.list_entries", "showcase.catalog.sync_fixture", "showcase.health.probe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Project Heal Gallery Marks"}, "domain_title": "Showcase MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "When cards lack a tenant mark — seed showcase.icon_url using BFF icon candidate order (platform mon…", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.list_entries", "showcase.catalog.sync_fixture", "showcase.health.probe"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_project_heal_gallery_marks", "semantic_input_mode": "inherit_workflow", "summary": "Seed tenant ``showcase.icon_url`` when no real gallery mark exists — uses the same candidate order as the public BFF (monogram before unprobed /s/…/favicon). Skips tenants that already have HTTPS, sto", "title": "Showcase Project Heal Gallery Marks", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "When cards lack a tenant mark — seed showcase.icon_url using BFF icon candidate order (platform monogram before generic /s/…/favicon). Skips real HTTPS/storage marks. dry_run first.", "write_mode": null}, {"action": "showcase.catalog.apply_canonical_order", "ai_tips": "Fix DNA entry_order when EditFlow leads but games should — TailRush first, then thermomorphs/war-tactics/serpent/kamni, then other portfolio tenants. No card edits.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.apply_canonical_order", "mutation_risk": "low", "related_tools": ["showcase.catalog.sync_fixture", "showcase.catalog.list_entries", "showcase.catalog.reorder"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Catalog Apply Canonical Order"}, "domain_title": "Showcase MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Fix DNA entry_order when EditFlow leads but games should — TailRush first, then thermomorphs/war-ta…", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.sync_fixture", "showcase.catalog.list_entries", "showcase.catalog.reorder"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_catalog_apply_canonical_order", "semantic_input_mode": "inherit_workflow", "summary": "Rewrite ecosystem DNA entry_order so hosted games lead (TailRush first) without changing card payloads — matches /showcase SPA sort.", "title": "Showcase Catalog Apply Canonical Order", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Fix DNA entry_order when EditFlow leads but games should — TailRush first, then thermomorphs/war-tactics/serpent/kamni, then other portfolio tenants. No card edits.", "write_mode": null}, {"action": "showcase.health.probe", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Expecting health stamps for ecosystem_catalog_only backlog cards — they have no /s/ bucket.", "anti_patterns": ["Expecting health stamps for ecosystem_catalog_only backlog cards — they have no /s/ bucket.", "Full-catalog probe in tight MCP sync batch — pass entry_ids to avoid N parallel HTTP probes."], "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.health.probe", "mutation_risk": "low", "related_tools": ["showcase.build.republish_entry", "showcase.sources.sync_status", "showcase.catalog.list_entries"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Health Probe"}, "domain_title": "Showcase MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "After VPS republish or deploy.verify — stamp data.showcase.health when /s/ edge is ok. Scope with e…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.build.republish_entry", "showcase.sources.sync_status", "showcase.catalog.list_entries"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "showcase_health_probe", "semantic_input_mode": "inherit_workflow", "summary": "HTTP-probe canonical /s/{pid}/ buckets for active catalog entries and stamp ecosystem health when edge returns ok. Pass entry_ids to scope probes; omitting probes all active entries with hosting_bucke", "title": "Showcase Health Probe", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After VPS republish or deploy.verify — stamp data.showcase.health when /s/ edge is ok. Scope with entry_ids (e.g. arcanestack, thermomorphs); backlog cards without bucket are skipped.", "write_mode": null}, {"action": "showcase.tenant.register", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.tenant.register", "mutation_risk": "high", "related_tools": ["showcase.catalog.upsert_entry", "showcase.catalog.patch_entry", "showcase.project.heal_gallery_marks"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Tenant Register"}, "domain_title": "Showcase MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Add a new independent_tenant gallery card on pid=1 DNA — live on /showcase without SPA deploy. Does…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.catalog.upsert_entry", "showcase.catalog.patch_entry", "showcase.project.heal_gallery_marks"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "low_write", "safe_action": "showcase_tenant_register", "semantic_input_mode": "inherit_workflow", "summary": "Register an independent tenant on the public showcase (gallery card only).", "title": "Showcase Tenant Register", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add a new independent_tenant gallery card on pid=1 DNA — live on /showcase without SPA deploy. Does not provision /s/ bytes; run agent_next heal + health.probe, then safe_project_cycle on tenant pid.", "write_mode": null}, {"action": "showcase.build.republish_entry", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Tenant flagship DNA — use generation.promote on tenant pid, not platform_proof republish.", "anti_patterns": ["Tenant flagship DNA — use generation.promote on tenant pid, not platform_proof republish.", "independent_tenant catalog cards — tenant_generation_supply jurisdiction."], "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["repo.ops.prod_showcase.gen1"], "id": "showcase.build.republish_entry", "mutation_risk": "high", "related_tools": ["showcase.workspace.hydrate", "hosting.site.build", "hosting.site.edge_health"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Build Republish Entry"}, "do_not_use_when": "Tenant flagship/site bytes — generation.promote on tenant pid, not platform_proof republish.", "domain_title": "Showcase MCP domain", "effect": {"execution_class": "heavy", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "heavy", "genetic_tags": ["core.mcp.showcase.gen1"], "hosting_atoms": {"HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_GIT_PLANE_CHOOSER": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branches dev or main. (2) generation.promote moves 8DNA only (config, fleet, knowledge) — not site bytes. Pass env_uuid on the write params. Skip a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. (3) Platform checkouts agentstack-core and shared often have no git remote — they ship by VPS deploy. Empty origin means do not git push origin. agentstack-frontend tracks agentstack/dev. 'push to dev' is plane 1, not generation.promote and not target=prod."}, "instruction_hint": "Republish one workspace platform_proof via hydrate + hosting.site.build. publish_plane=git_journal …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.workspace.hydrate", "hosting.site.build", "hosting.site.edge_health"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "production_publish", "safe_action": "showcase_build_republish_entry", "semantic_input_mode": "inherit_workflow", "summary": "Republish one platform_proof entry (ops_jurisdiction=showcase_bootstrap, PIDs 1438–1443). Not for tenant_generation_supply — use agentstack_safe_project_cycle.", "title": "Showcase Build Republish Entry", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "enqueue_lock_busy": "Retry hosting.site.build with the same project_id and bucket — the lock has no job_id yet. Do not poll hosting.site.build_status until enqueue returns job_id.", "entry_id_required": "Pass catalog entry_id (e.g. arcanestack, thermomorphs, editflow)", "forbidden": "Ecosystem owner required — auth.get_profile", "hosting_site_missing": "Bootstrap hosting bucket — showcase provisioning / deploy republish", "hydrate_source_missing": "Sync compile plane (deploy.showcase_sync_sources) or rebuild backend image", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "republish_failed": "Inspect data.error — often hydrate_source_missing or build step failure", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Tenant flagship/site bytes — generation.promote on tenant pid, not platform_proof republish.", "when_to_use": "Republish one workspace platform_proof via hydrate + hosting.site.build. publish_plane=git_journal entries skip; push or promote with hosting.git instead.", "workflow_ladder": [{"notes": "Once per bucket (arcanestack-prod on pid 1438).", "step": "hosting.git.init"}, {"notes": "Preview enqueue via post-receive.", "step": "git push agentstack HEAD:dev"}, {"notes": "job_id only — poll until completed.", "step": "hosting.site.build_status"}, {"notes": "ref=dev target=prod after green preview.", "step": "hosting.git.promote_branch"}, {"notes": "DNA only — dry_run first.", "step": "showcase.arcanestack.ensure_rules"}, {"notes": "entry_ids=[arcanestack].", "step": "showcase.health.probe"}], "write_mode": null}, {"action": "showcase.arcanestack.ensure_rules", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "heavy", "genetic_tags": ["repo.ops.prod_showcase.gen1"], "id": "showcase.arcanestack.ensure_rules", "mutation_risk": "low", "related_tools": ["showcase.build.republish_entry", "showcase.entry.resolve", "showcase.health.probe"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Arcanestack Ensure Rules"}, "do_not_use_when": "Routine deploy — use deploy registry or VPS scripts; MCP is post-heal leaf DNA only.", "domain_title": "Showcase MCP domain", "effect": {"execution_class": "heavy", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "heavy", "genetic_tags": ["core.mcp.showcase.gen1"], "hosting_atoms": {"HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_GIT_PLANE_CHOOSER": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branches dev or main. (2) generation.promote moves 8DNA only (config, fleet, knowledge) — not site bytes. Pass env_uuid on the write params. Skip a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. (3) Platform checkouts agentstack-core and shared often have no git remote — they ship by VPS deploy. Empty origin means do not git push origin. agentstack-frontend tracks agentstack/dev. 'push to dev' is plane 1, not generation.promote and not target=prod."}, "instruction_hint": "Post-heal leaf: sync card-game FAP and logic templates onto the catalog proof project. SPA bytes st…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.build.republish_entry", "showcase.entry.resolve", "showcase.health.probe"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_arcanestack_ensure_rules", "semantic_input_mode": "inherit_workflow", "summary": "Leaf-sync card-game FAP and logic templates onto the catalog proof project. Does not publish SPA bytes — those come from the git journal.", "title": "Showcase Arcanestack Ensure Rules", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "enqueue_lock_busy": "Retry hosting.site.build with the same project_id and bucket — the lock has no job_id yet. Do not poll hosting.site.build_status until enqueue returns job_id.", "execution_error": "Read report in the error payload; fix the named rule or FAP leaf, then dry_run again", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Routine deploy — use deploy registry or VPS scripts; MCP is post-heal leaf DNA only.", "when_to_use": "Post-heal leaf: sync card-game FAP and logic templates onto the catalog proof project. SPA bytes stay on the git journal (publish_plane). dry_run first. Not a site republish.", "workflow_ladder": [{"notes": "Once per bucket (arcanestack-prod on pid 1438).", "step": "hosting.git.init"}, {"notes": "Preview enqueue via post-receive.", "step": "git push agentstack HEAD:dev"}, {"notes": "job_id only — poll until completed.", "step": "hosting.site.build_status"}, {"notes": "ref=dev target=prod after green preview.", "step": "hosting.git.promote_branch"}, {"notes": "DNA only — dry_run first.", "step": "showcase.arcanestack.ensure_rules"}, {"notes": "entry_ids=[arcanestack].", "step": "showcase.health.probe"}], "write_mode": null}, {"action": "showcase.workspace.hydrate", "ai_tips": "Bootstrap platform_proof bucket workspace/ from operator sources (same layout tenants use). Re-runs when .showcase_compile_sha drifts; then hosting.workspace.file.put + hosting.site.build.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Tenant buckets — hosting.workspace.init on tenant pid.", "anti_patterns": ["Tenant buckets — hosting.workspace.init on tenant pid.", "Hydrate before SHOWCASE_SOURCES_ROOT sync on VPS — workspace will be empty."], "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Copies archetype sources into hosting workspace bucket.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["repo.ops.prod_showcase.gen1", "core.hosting.bucket.gen1"], "id": "showcase.workspace.hydrate", "mutation_risk": "low", "related_tools": ["hosting.workspace.file.put", "hosting.site.build", "showcase.build.republish_entry"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Workspace Hydrate"}, "do_not_use_when": "Tenant buckets — hosting.workspace.init (+ seed_from_live) on tenant pid; do not use showcase.* hydrate (platform proof bootstrap only).", "domain_title": "Showcase MCP domain", "effect": {"conditional_mutate": "Copies archetype sources into hosting workspace bucket.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Copies archetype sources into hosting workspace bucket.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.showcase.gen1"], "hosting_atoms": {"HOSTING_GIT_JOURNAL_FLOW": "Per-bucket journal: hosting.site.quick_start(slug=…) or hosting.workspace.init (profile node_vite) — quick_start accepts slug/site_id, not bucket_name (validation_error if bucket_name is passed). Then hosting.git.init (bucket_name) → hosting.git.status (bucket_name or site_id from quick_start) → local git push agentstack HEAD:dev (preview) → poll hosting.site.build_status until completed (git post-receive enqueues; do not skip poll). Open /s/{project_id}/{bucket}--dev/. Promote: git push HEAD:main or hosting.git.promote_branch ref=dev target=prod. Vite: tenant journals use `node scripts/site-vite-build.mjs` (or legacy `npx vite build --base ./` for relative subpaths). Platform shell worker sets HOSTING_BUILD_TARGET=dev|prod plus HOSTING_PROJECT_ID/HOSTING_BUCKET_NAME so the script emits `/s/{pid}/{bucket}--dev/` for preview and `/` for prod apex — one algorithm, no raw `vite build --base ./` in deploy/vps/scripts/platform_shell.site.build.yaml. SDK and shared-ui: pin .gitmodules to https://agentstack.tech/api/git/1/sdk.git and .../shared-ui.git — the build symlinks vendor/ onto that one journal and does not clone or import_tree a second copy. Platform shells that already sit beside the monorepo checkout may keep sibling paths. npm: each build runs npm ci in the journal; shared download cache is AGENTSTACK_NPM_CACHE (not App Studio root node_modules — see docs/ai_builder/ROOT_NODE_MODULES_CACHE.md). ACL: git clone=project read; git push=project write. Work Graph: end the commit body with trailer `AgentStack-Task: <node_id>` (repeat the line for several nodes). hosting.git.log and changelog.json return task_ids. Do not store commits on the plan graph; optional agents.plan_patch evidence.git_shas only when the operator wants the reverse index.", "HOSTING_GIT_PLANE_CHOOSER": "Three planes — do not mix. (1) Hosting git: remote name agentstack, URL https://agentstack.tech/api/git/{project_id}/{bucket}.git. Default push is branch dev (preview /s/{pid}/{bucket}--dev/). Live site is branch main, or hosting.git.promote_branch with bucket_id (not bucket), ref=dev, target=prod. Do not delete branches dev or main. (2) generation.promote moves 8DNA only (config, fleet, knowledge) — not site bytes. Pass env_uuid on the write params. Skip a sandbox whose diff rewinds showcase.health. One of fork, diff_vs_prod, gates, promote per sync execute. (3) Platform checkouts agentstack-core and shared often have no git remote — they ship by VPS deploy. Empty origin means do not git push origin. agentstack-frontend tracks agentstack/dev. 'push to dev' is plane 1, not generation.promote and not target=prod."}, "instruction_hint": "Bootstrap platform_proof bucket workspace/ from operator sources (same layout tenants use). Re-runs…", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["hosting.workspace.file.put", "hosting.site.build", "showcase.build.republish_entry"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "showcase_workspace_hydrate", "semantic_input_mode": "inherit_workflow", "summary": "Copy platform_proof archetype sources into bucket workspace/ for MCP edit + site.build.", "title": "Showcase Workspace Hydrate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "dev_not_verified": "Production build requires the prod tree at the current dev branch tip. Push dev, poll hosting.site.build_status until preview succeeds, then target=prod or promote_branch ref=dev.", "enqueue_lock_busy": "Retry hosting.site.build with the same project_id and bucket — the lock has no job_id yet. Do not poll hosting.site.build_status until enqueue returns job_id.", "entry_id_required": "Pass catalog entry_id (e.g. arcanestack, thermomorphs, editflow)", "forbidden": "Ecosystem owner required — auth.get_profile", "hosting_site_missing": "Bootstrap hosting bucket — showcase provisioning / deploy republish", "hydrate_source_missing": "Sync compile plane (deploy.showcase_sync_sources) or rebuild backend image", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Tenant buckets — hosting.workspace.init (+ seed_from_live) on tenant pid; do not use showcase.* hydrate (platform proof bootstrap only).", "when_to_use": "Bootstrap platform_proof bucket workspace/ from operator sources (same layout tenants use). Re-runs when .showcase_compile_sha drifts; then hosting.workspace.file.put + hosting.site.build.", "workflow_ladder": [{"notes": "Once per bucket (arcanestack-prod on pid 1438).", "step": "hosting.git.init"}, {"notes": "Preview enqueue via post-receive.", "step": "git push agentstack HEAD:dev"}, {"notes": "job_id only — poll until completed.", "step": "hosting.site.build_status"}, {"notes": "ref=dev target=prod after green preview.", "step": "hosting.git.promote_branch"}, {"notes": "DNA only — dry_run first.", "step": "showcase.arcanestack.ensure_rules"}, {"notes": "entry_ids=[arcanestack].", "step": "showcase.health.probe"}], "write_mode": null}, {"action": "showcase.sources.sync_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.prod_showcase.gen1"], "id": "showcase.sources.sync_status", "related_tools": ["showcase.sources.sync", "showcase.workspace.hydrate"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Sources Sync Status"}, "domain_title": "Showcase MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Read VPS compile-plane status: manifest sha sidecar (last Windows upload), compile_ready, manifest_…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.sources.sync", "showcase.workspace.hydrate"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "showcase_sources_sync_status", "semantic_input_mode": "inherit_workflow", "summary": "Read VPS showcase-sources sync sidecar (sha256) when present.", "title": "Showcase Sources Sync Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read VPS compile-plane status: manifest sha sidecar (last Windows upload), compile_ready, manifest_in_sync vs repo manifest when both exist. Does not hash the whole tree.", "write_mode": null}, {"action": "showcase.sources.sync", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Expecting API/SCP from backend container — use Deploy Console or deploy-from-windows.ps1.", "anti_patterns": ["Expecting API/SCP from backend container — use Deploy Console or deploy-from-windows.ps1."], "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.prod_showcase.gen1"], "id": "showcase.sources.sync", "related_tools": ["showcase.sources.sync_status", "showcase.workspace.hydrate"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Sources Sync"}, "do_not_use_when": "In-repo sync runs on Windows deploy host — MCP documents deploy.showcase_sync_sources contract.", "domain_title": "Showcase MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Contract-only: no API SCP. Windows deploy.showcase_sync_sources unless SHOWCASE_COMPILE_PLANE_VPS_S…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.sources.sync_status", "showcase.workspace.hydrate"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "read", "safe_action": "showcase_sources_sync", "semantic_input_mode": "inherit_workflow", "summary": "Operator contract for VPS showcase-sources sync. SCP runs via Deploy Console step deploy.showcase_sync_sources (Invoke-ShowcaseSyncSourcesOnVps), not from API.", "title": "Showcase Sources Sync", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "In-repo sync runs on Windows deploy host — MCP documents deploy.showcase_sync_sources contract.", "when_to_use": "Contract-only: no API SCP. Windows deploy.showcase_sync_sources unless SHOWCASE_COMPILE_PLANE_VPS_SOT=1 (agents edit compile tree on VPS).", "write_mode": null}, {"action": "showcase.entry.resolve", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Calling showcase.build.republish_entry for independent_tenant — use hosting.site.build on tenant pid.", "Skipping resolve and guessing plane from entry title — always resolve entry_id first."], "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["repo.ops.prod_showcase.gen1", "core.mcp.self_description.gen1"], "id": "showcase.entry.resolve", "related_tools": ["showcase.build.republish_entry", "showcase.workspace.hydrate", "showcase.sources.sync_status", "hosting.workspace.init", "hosting.site.build", "generation.supply_status"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Showcase Entry Resolve"}, "domain_title": "Showcase MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Before hydrate/republish — route entry_id to showcase_bootstrap vs tenant_generation_supply vs ecos…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "owner_gene": "core.mcp.showcase.gen1", "plane": "Public demos: showcase.catalog.get — not tenant flagship DNA. Ops publish only.", "plane_chooser": "Ecosystem gallery metadata: project_id=1 + showcase.catalog.*. Site bytes (proof + tenant): same hosting contract — bucket workspace/ + site.build.yaml + hosting.site.build. VPS-primary: SHOWCASE_SOURCES_ROOT is compile SoT when SHOWCASE_COMPILE_PLANE_VPS_SOT=1; agents edit workspace via hosting.workspace.*; platform proofs hydrate via showcase.workspace.hydrate. independent_tenant cards: tenant_generation_supply + agentstack_safe_project_cycle — not showcase.build.*.", "related_prompts": ["agentstack_showcase_ops", "agentstack_showcase_vps_ops", "agentstack_showcase_arcanestack_ops"], "related_tools": ["showcase.build.republish_entry", "showcase.workspace.hydrate", "showcase.sources.sync_status", "hosting.workspace.init", "hosting.site.build", "generation.supply_status"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "showcase_entry_resolve", "semantic_input_mode": "inherit_workflow", "summary": "Route a showcase catalog entry_id to operator plane and suggested MCP actions (platform_proof vs independent_tenant).", "title": "Showcase Entry Resolve", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "entry_id_required": "Pass catalog entry_id (e.g. arcanestack, thermomorphs, editflow)", "forbidden": "Ecosystem owner required — auth.get_profile", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "missing_pid_or_bucket": "Entry lacks project_id or hosting_bucket — fix catalog row before republish", "platform_proof_entry_required": "Action is platform_proof only — tenant cards use tenant_generation_supply", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "MCP session required — agentstack_session_setup", "unknown_entry": "Unknown catalog entry_id — sync fixture or showcase.catalog.sync_fixture on ecosystem pid=1", "unknown_entry_kind": "Catalog entry missing entry_kind — fix fixture / DNA upsert", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wrong_jurisdiction": "ops_jurisdiction mismatch for entry_kind — use showcase.entry.resolve plane"}, "when_to_use": "Before hydrate/republish — route entry_id to showcase_bootstrap vs tenant_generation_supply vs ecosystem_catalog_only (backlog cards without /s/). Gallery marks SoT: tenant project DNA showcase.icon_u", "write_mode": null}], "social": [{"action": "social.chat.index_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.index_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Index Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"execution_error": "Retry once; empty entries[] is valid for new users", "forbidden": "social_read cap or operator session required", "unauthorized": "auth.get_profile — MCP context must carry user_id"}, "execution_class": "plain_read", "instruction_hint": "Get the current user's messenger sidebar index — list of channels with pinned/order metadata.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_chat_index_get", "semantic_input_mode": "inherit_workflow", "summary": "Get the current user's messenger sidebar index — list of channels with pinned/order metadata.", "title": "Social Chat Index Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "execution_error": "Retry once; empty entries[] is valid for new users", "forbidden": "social_read cap or operator session required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — MCP context must carry user_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get the current user's messenger sidebar index — list of channels with pinned/order metadata.", "write_mode": null}, {"action": "social.chat.index_put", "ai_tips": "Replace messenger sidebar index (subset-as-delete).", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.index_put", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Index Put"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"forbidden": "social_read cap required", "invalid_parameters": "channel_id and entries required"}, "execution_class": "cheap", "instruction_hint": "Replace the messenger sidebar index (subset-as-delete with If-Match on REST).", "messenger_atoms": ["CHAT_INDEX_PUT"], "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_chat_index_put", "semantic_input_mode": "inherit_workflow", "summary": "Replace the messenger sidebar index (subset-as-delete with If-Match on REST).", "title": "Social Chat Index Put", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap required", "invalid_parameters": "channel_id and entries required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Replace the messenger sidebar index (subset-as-delete with If-Match on REST).", "write_mode": ["replace"], "write_mode_note": "Exception: subset-as-delete with If-Match. A short list can drop missing keys. Do not apply bots-style merge defaults here."}, {"action": "social.chat.history", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.history", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat History"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "social_read cap or channel membership required", "invalid_parameters": "channel_id required", "not_found": "channel_id unknown — social.channels.register or channel_invites.direct"}, "execution_class": "plain_read", "instruction_hint": "Messenger channel history — use social.support.history for support tickets.", "messenger_atoms": ["CHAT_SINCE_SEQ"], "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_chat_history", "semantic_input_mode": "inherit_workflow", "summary": "Read chat history from a messenger channel (AI-accessible).", "title": "Social Chat History", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap or channel membership required", "invalid_parameters": "channel_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown — social.channels.register or channel_invites.direct", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Messenger channel history — use social.support.history for support tickets.", "write_mode": null}, {"action": "social.chat.post", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.post", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Post"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"forbidden": "post_policy or membership denied", "invalid_parameters": "channel_id and body required", "not_found": "channel_id unknown"}, "execution_class": "cheap", "instruction_hint": "In-app messenger message — not project support (psup) thread.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_chat_post", "semantic_input_mode": "inherit_workflow", "summary": "Send a chat message to a messenger channel as the AI agent (authenticated user).", "title": "Social Chat Post", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "post_policy or membership denied", "invalid_parameters": "channel_id and body required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "In-app messenger message — not project support (psup) thread.", "write_mode": null}, {"action": "social.chat.pin", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.pin", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Pin"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Pin a message in a channel.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_chat_pin", "semantic_input_mode": "inherit_workflow", "summary": "Pin a message in a channel.", "title": "Social Chat Pin", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pin a message in a channel.", "write_mode": null}, {"action": "social.chat.unpin", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.unpin", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Unpin"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Unpin a message in a channel.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_chat_unpin", "semantic_input_mode": "inherit_workflow", "summary": "Unpin a message in a channel.", "title": "Social Chat Unpin", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Unpin a message in a channel.", "write_mode": null}, {"action": "social.chat.message_edit", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.message_edit", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Message Edit"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "author-only edit or membership denied", "invalid_parameters": "channel_id, message_id, and body required", "not_found": "message or channel unknown"}, "execution_class": "plain_read", "instruction_hint": "Edit own chat message (author only).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_chat_message_edit", "semantic_input_mode": "inherit_workflow", "summary": "Edit own chat message (author only).", "title": "Social Chat Message Edit", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "author-only edit or membership denied", "invalid_parameters": "channel_id, message_id, and body required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "message or channel unknown", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Edit own chat message (author only).", "write_mode": null}, {"action": "social.chat.message_delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.message_delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Message Delete"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "errors": {"forbidden": "delete_forbidden — author or channel owner per server rules", "invalid_parameters": "channel_id and message_id required", "not_found": "message or channel unknown", "saved_channel_forbidden": "Cannot delete in saved-channel slice — pick live channel"}, "execution_class": "cheap", "instruction_hint": "Delete a chat message (author or channel owner per server rules).", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "social_chat_message_delete", "semantic_input_mode": "inherit_workflow", "summary": "Delete a chat message (author or channel owner per server rules).", "title": "Social Chat Message Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "delete_forbidden — author or channel owner per server rules", "invalid_parameters": "channel_id and message_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "message or channel unknown", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "saved_channel_forbidden": "Cannot delete in saved-channel slice — pick live channel", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete a chat message (author or channel owner per server rules).", "write_mode": null}, {"action": "social.chat.reaction", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.reaction", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Reaction"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "membership or reaction policy denied", "invalid_parameters": "channel_id, message_id, and emoji required", "not_found": "message or channel unknown"}, "execution_class": "plain_read", "instruction_hint": "Apply one server-authoritative reaction on a message (immutable cell per user).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_chat_reaction", "semantic_input_mode": "inherit_workflow", "summary": "Apply one server-authoritative reaction on a message (immutable cell per user).", "title": "Social Chat Reaction", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "membership or reaction policy denied", "invalid_parameters": "channel_id, message_id, and emoji required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "message or channel unknown", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply one server-authoritative reaction on a message (immutable cell per user).", "write_mode": null}, {"action": "social.chat.read_set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.read_set", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Read Set"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Update last-read pointer (read receipt) for a channel.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_chat_read_set", "semantic_input_mode": "inherit_workflow", "summary": "Update last-read pointer (read receipt) for a channel.", "title": "Social Chat Read Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update last-read pointer (read receipt) for a channel.", "write_mode": null}, {"action": "social.chat.read_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.read_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Read Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Get last-read state for a channel for the current user.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_chat_read_get", "semantic_input_mode": "inherit_workflow", "summary": "Get last-read state for a channel for the current user.", "title": "Social Chat Read Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get last-read state for a channel for the current user.", "write_mode": null}, {"action": "social.chat.presence_online", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.presence_online", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Presence Online"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List user IDs currently online (active SSE stream-relay connection) in the home project.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_chat_presence_online", "semantic_input_mode": "inherit_workflow", "summary": "List user IDs currently online (active SSE stream-relay connection) in the home project.", "title": "Social Chat Presence Online", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List user IDs currently online (active SSE stream-relay connection) in the home project.", "write_mode": null}, {"action": "social.friends.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List friends for the current user.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_friends_list", "semantic_input_mode": "inherit_workflow", "summary": "List friends for the current user.", "title": "Social Friends List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List friends for the current user.", "write_mode": null}, {"action": "social.friends.user_ids", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.user_ids", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends User Ids"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Ordered friend user id list.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_friends_user_ids", "semantic_input_mode": "inherit_workflow", "summary": "Ordered friend user id list.", "title": "Social Friends User Ids", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Ordered friend user id list.", "write_mode": null}, {"action": "social.friends.cards", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.cards", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Cards"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Public card fields for each friend.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_friends_cards", "semantic_input_mode": "inherit_workflow", "summary": "Public card fields for each friend.", "title": "Social Friends Cards", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Public card fields for each friend.", "write_mode": null}, {"action": "social.friends.cards_batch", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.cards_batch", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Cards Batch"}, "do_not_use_when": "Only when friend ids are known — list/user_ids first.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Friend cards for specific user ids (must be friends).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_friends_cards_batch", "semantic_input_mode": "inherit_workflow", "summary": "Friend cards for specific user ids (must be friends).", "title": "Social Friends Cards Batch", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Only when friend ids are known — list/user_ids first.", "when_to_use": "Friend cards for specific user ids (must be friends).", "write_mode": null}, {"action": "social.followers.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.followers.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Followers List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "social_read cap required", "invalid_parameters": "home_project_id or user scope", "unauthorized": "auth.get_profile required"}, "execution_class": "plain_read", "instruction_hint": "Users who follow the current user.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Merged timeline: social.merge_feed — not per-channel social.chat.history. Federation graph: social.federation.add before cross-project public publish.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_followers_list", "semantic_input_mode": "inherit_workflow", "summary": "Users who follow the current user.", "title": "Social Followers List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap required", "invalid_parameters": "home_project_id or user scope", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Users who follow the current user.", "write_mode": null}, {"action": "social.privacy.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.privacy.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Privacy Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "project membership required", "unauthorized": "auth.get_profile required"}, "execution_class": "plain_read", "instruction_hint": "Get friend/DM privacy settings.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_privacy_get", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Get friend/DM privacy settings.", "title": "Social Privacy Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project membership required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get friend/DM privacy settings.", "write_mode": null}, {"action": "social.privacy.put", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.privacy.put", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Privacy Put"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"forbidden": "project write/admin required", "invalid_parameters": "privacy leaf shape — review diff before promote", "unauthorized": "auth.get_profile required"}, "execution_class": "cheap", "instruction_hint": "Update privacy settings (incoming_friend_requests, dm_policy).", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_privacy_put", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Update privacy settings (incoming_friend_requests, dm_policy).", "title": "Social Privacy Put", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project write/admin required", "invalid_parameters": "privacy leaf shape — review diff before promote", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update privacy settings (incoming_friend_requests, dm_policy).", "write_mode": null}, {"action": "social.friends.requests_in", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.requests_in", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Requests In"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Incoming friend requests.", "mutation_kind": "none", "next_actions": ["social.friends.request_respond"], "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_friends_requests_in", "semantic_input_mode": "inherit_workflow", "summary": "Incoming friend requests.", "title": "Social Friends Requests In", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Incoming friend requests.", "write_mode": null}, {"action": "social.friends.requests_out", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.requests_out", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Requests Out"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Outgoing friend requests.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_friends_requests_out", "semantic_input_mode": "inherit_workflow", "summary": "Outgoing friend requests.", "title": "Social Friends Requests Out", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Outgoing friend requests.", "write_mode": null}, {"action": "social.friends.request_respond", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.request_respond", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Request Respond"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Accept/reject/subscriber/block on an incoming friend request.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_friends_request_respond", "semantic_input_mode": "inherit_workflow", "summary": "Accept/reject/subscriber/block on an incoming friend request.", "title": "Social Friends Request Respond", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Accept/reject/subscriber/block on an incoming friend request.", "write_mode": null}, {"action": "social.friends.request", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.request", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Request"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Send a friend request (optional source context for public_channel).", "mutation_kind": "none", "next_actions": ["social.friends.requests_out"], "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_friends_request", "semantic_input_mode": "inherit_workflow", "summary": "Send a friend request (optional source context for public_channel).", "title": "Social Friends Request", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Send a friend request (optional source context for public_channel).", "write_mode": null}, {"action": "social.friends.accept", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.accept", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Accept"}, "do_not_use_when": "Prefer social.friends.request_respond when unified respond is available.", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Accept friend request from user_id.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_friends_accept", "semantic_input_mode": "inherit_workflow", "summary": "Accept friend request from user_id.", "title": "Social Friends Accept", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Prefer social.friends.request_respond when unified respond is available.", "when_to_use": "Accept friend request from user_id.", "write_mode": null}, {"action": "social.friends.remove", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.remove", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Remove"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Remove an existing friend.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "low_write", "safe_action": "social_friends_remove", "semantic_input_mode": "inherit_workflow", "summary": "Remove an existing friend.", "title": "Social Friends Remove", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove an existing friend.", "write_mode": null}, {"action": "social.friends.reject", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.reject", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Reject"}, "do_not_use_when": "Prefer social.friends.request_respond for inbox triage.", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Reject a pending friend request.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_friends_reject", "semantic_input_mode": "inherit_workflow", "summary": "Reject a pending friend request.", "title": "Social Friends Reject", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Prefer social.friends.request_respond for inbox triage.", "when_to_use": "Reject a pending friend request.", "write_mode": null}, {"action": "social.friends.cancel", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.cancel", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Cancel"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Cancel outgoing friend request.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_friends_cancel", "semantic_input_mode": "inherit_workflow", "summary": "Cancel outgoing friend request.", "title": "Social Friends Cancel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cancel outgoing friend request.", "write_mode": null}, {"action": "social.friends.block", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.block", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Friends Block"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Block a user.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Friends graph: social.friends.list / user_ids / cards — not social.chat.* DMs. Requests: request → requests_out; inbox requests_in → request_respond (preferred) or accept/reject. Support tickets: social.support.* — not friends.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_friends_block", "semantic_input_mode": "inherit_workflow", "summary": "Block a user.", "title": "Social Friends Block", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Block a user.", "write_mode": null}, {"action": "social.users.public_cards", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.users.public_cards", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Users Public Cards"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Public display cards for user ids (no friendship check).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_users_public_cards", "semantic_input_mode": "inherit_workflow", "summary": "Public display cards for user ids (no friendship check).", "title": "Social Users Public Cards", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Public display cards for user ids (no friendship check).", "write_mode": null}, {"action": "social.users.lookup", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.users.lookup", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Users Lookup"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Find users by id, email, or @username (no email in response).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_users_lookup", "semantic_input_mode": "inherit_workflow", "summary": "Find users by id, email, or @username (no email in response).", "title": "Social Users Lookup", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Find users by id, email, or @username (no email in response).", "write_mode": null}, {"action": "social.party_invite.mint", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Persists short-lived party invite token.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.party_invite.mint", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Party Invite Mint"}, "effect": {"conditional_mutate": "Persists short-lived party invite token.", "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "effect_override": {"conditional_mutate": "Persists short-lived party invite token.", "kind": "mutate", "read_only_hint": false}, "execution_class": "cheap", "instruction_hint": "Mint a short-lived party invite token for a relay room.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_party_invite_mint", "semantic_input_mode": "inherit_workflow", "summary": "Mint a short-lived party invite token for a relay room.", "title": "Social Party Invite Mint", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mint a short-lived party invite token for a relay room.", "write_mode": null}, {"action": "social.party_invite.verify", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.party_invite.verify", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Party Invite Verify"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Verify party invite token (no auth required on REST; MCP still needs project context).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_party_invite_verify", "semantic_input_mode": "inherit_workflow", "summary": "Verify party invite token (no auth required on REST; MCP still needs project context).", "title": "Social Party Invite Verify", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Verify party invite token (no auth required on REST; MCP still needs project context).", "write_mode": null}, {"action": "social.channel_invites.link_token", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.link_token", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Link Token"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Create shareable link token for a channel (owner).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_channel_invites_link_token", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Create shareable link token for a channel (owner).", "title": "Social Channel Invites Link Token", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create shareable link token for a channel (owner).", "write_mode": null}, {"action": "social.channel_invites.direct", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.direct", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Direct"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "channel owner or social_read cap required", "invalid_parameters": "channel_id and invitee user id required", "not_found": "channel_id unknown"}, "execution_class": "plain_read", "instruction_hint": "Create direct channel invite to a user (owner).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_channel_invites_direct", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Create direct channel invite to a user (owner).", "title": "Social Channel Invites Direct", "tool_chains": ["multi_tenant_onboarding"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "channel owner or social_read cap required", "invalid_parameters": "channel_id and invitee user id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Create direct channel invite to a user (owner).", "write_mode": null}, {"action": "social.channel_invites.inbox", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.inbox", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Inbox"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "List pending channel invites for the current user.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_channel_invites_inbox", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "List pending channel invites for the current user.", "title": "Social Channel Invites Inbox", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List pending channel invites for the current user.", "write_mode": null}, {"action": "social.channel_invites.accept", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.accept", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Accept"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Accept a channel invite from inbox.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_channel_invites_accept", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Accept a channel invite from inbox.", "title": "Social Channel Invites Accept", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Accept a channel invite from inbox.", "write_mode": null}, {"action": "social.channel_invites.decline", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.decline", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Decline"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Decline a channel invite.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_channel_invites_decline", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Decline a channel invite.", "title": "Social Channel Invites Decline", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Decline a channel invite.", "write_mode": null}, {"action": "social.channel_invites.redeem", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.redeem", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channel Invites Redeem"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Redeem channel invite token.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_channel_invites_redeem", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Redeem channel invite token.", "title": "Social Channel Invites Redeem", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Redeem channel invite token.", "write_mode": null}, {"action": "social.federation.add", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.federation.add", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Federation Add"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"forbidden": "both projects must grant federation", "invalid_parameters": "peer_project_id required", "unauthorized": "auth.get_profile required"}, "execution_class": "cheap", "instruction_hint": "Add federated open-channel pointer on consumer project.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Merged timeline: social.merge_feed — not per-channel social.chat.history. Federation graph: social.federation.add before cross-project public publish.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_federation_add", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Add federated open-channel pointer on consumer project.", "title": "Social Federation Add", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "both projects must grant federation", "invalid_parameters": "peer_project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Add federated open-channel pointer on consumer project.", "write_mode": null}, {"action": "social.federation.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.federation.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Federation Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "project read on home_project_id", "not_found": "no federation edge — social.federation.add first", "unauthorized": "auth.get_profile required"}, "execution_class": "plain_read", "instruction_hint": "List federation pointers for a consumer project.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Merged timeline: social.merge_feed — not per-channel social.chat.history. Federation graph: social.federation.add before cross-project public publish.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_federation_get", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "List federation pointers for a consumer project.", "title": "Social Federation Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project read on home_project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "no federation edge — social.federation.add first", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List federation pointers for a consumer project.", "write_mode": null}, {"action": "social.channels.register", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.register", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channels Register"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"forbidden": "social_read cap required", "invalid_parameters": "home_project_id and title required", "validation_error": "visibility/post_policy/room_kind invalid"}, "execution_class": "cheap", "instruction_hint": "Create a new messenger channel (group chat, DM, or broadcast).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_channels_register", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Create a new messenger channel (group chat, DM, or broadcast).", "title": "Social Channels Register", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap required", "invalid_parameters": "home_project_id and title required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "validation_error": "visibility/post_policy/room_kind invalid"}, "when_to_use": "Create a new messenger channel (group chat, DM, or broadcast).", "write_mode": null}, {"action": "social.channels.update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.update", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channels Update"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Update channel metadata (owner).", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_channels_update", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Update channel metadata (owner).", "title": "Social Channels Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Update channel metadata (owner).", "write_mode": null}, {"action": "social.channels.delete", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.delete", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channels Delete"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Delete a channel (owner) and unpublish from public index.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "social_channels_delete", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Delete a channel (owner) and unpublish from public index.", "title": "Social Channels Delete", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Delete a channel (owner) and unpublish from public index.", "write_mode": null}, {"action": "social.channels.list", "aliases": ["channels.list", "social.channel.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channels List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"forbidden": "social_read cap or home project membership", "invalid_parameters": "home_project_id required", "unauthorized": "auth.get_profile — list requires signed-in user"}, "execution_class": "plain_read", "instruction_hint": "List all channels in the home project.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_channels_list", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "List all channels in the home project.", "title": "Social Channels List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap or home project membership", "invalid_parameters": "home_project_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — list requires signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List all channels in the home project.", "write_mode": null}, {"action": "social.channels.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Channels Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Get one channel if the current user may access it.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Channel registry: social.channels.register → list → social.chat.post(channel_id). Invites: social.channel_invites.direct → redeem — then chat history on channel_id.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_channels_get", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Get one channel if the current user may access it.", "title": "Social Channels Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Get one channel if the current user may access it.", "write_mode": null}, {"action": "social.entities.expand", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.entities.expand", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Entities Expand"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Batch-resolve channel/surrogate ids to metadata (max 100 ids).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_entities_expand", "semantic_input_mode": "inherit_workflow", "summary": "Batch-resolve channel/surrogate ids to metadata (max 100 ids).", "title": "Social Entities Expand", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Batch-resolve channel/surrogate ids to metadata (max 100 ids).", "write_mode": null}, {"action": "social.pas.public_me_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.pas.public_me_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Pas Public Me Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read Principal Access public slice for current user on a home project.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_pas_public_me_get", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Read Principal Access public slice for current user on a home project.", "title": "Social Pas Public Me Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read Principal Access public slice for current user on a home project.", "write_mode": null}, {"action": "social.pas.public_me_put", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.pas.public_me_put", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Pas Public Me Put"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Replace channels/chats/groups lists in PAS public slice.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_pas_public_me_put", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Replace channels/chats/groups lists in PAS public slice.", "title": "Social Pas Public Me Put", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Replace channels/chats/groups lists in PAS public slice.", "write_mode": null}, {"action": "social.public.quota_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.quota_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Quota Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Social public index quota for current user.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_public_quota_get", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Social public index quota for current user.", "title": "Social Public Quota Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Social public index quota for current user.", "write_mode": null}, {"action": "social.public.me", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.me", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Me"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Public maps from user row (ecosystem.social.public).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_public_me", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Public maps from user row (ecosystem.social.public).", "title": "Social Public Me", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Public maps from user row (ecosystem.social.public).", "write_mode": null}, {"action": "social.public.publish", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.publish", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Publish"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"forbidden": "publish policy or social_read cap denied", "invalid_parameters": "home_project_id and channel_id required", "not_found": "channel_id unknown — social.channels.register first"}, "execution_class": "cheap", "instruction_hint": "Publish a channel/chats/groups entry to public index.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "production_publish", "safe_action": "social_public_publish", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Publish a channel/chats/groups entry to public index.", "title": "Social Public Publish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "publish policy or social_read cap denied", "invalid_parameters": "home_project_id and channel_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown — social.channels.register first", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Publish a channel/chats/groups entry to public index.", "write_mode": null}, {"action": "social.public.unpublish", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.unpublish", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Unpublish"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Remove a public index entry.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "production_publish", "safe_action": "social_public_unpublish", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Remove a public index entry.", "title": "Social Public Unpublish", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove a public index entry.", "write_mode": null}, {"action": "social.public.index", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.index", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Index"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read a page of the public discovery index.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_public_index", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Read a page of the public discovery index.", "title": "Social Public Index", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read a page of the public discovery index.", "write_mode": null}, {"action": "social.public.reconcile", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.reconcile", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Public Reconcile"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Reconcile public maps (privileged role only).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Public maps: social.public.publish / unpublish / me — not social.chat.post. PAS profile row: social.pas.public_me_get / public_me_put. DMs: social.chat.*; support tickets: social.support.*; friends: social.friends.*.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "social_public_reconcile", "semantic_input_mode": "inherit_workflow", "social_atoms": {"GENERATION_ENV_PARITY": "Omit generation_env_uuid — server keeps sandbox head; stale uuid is cleared automatically."}, "summary": "Reconcile public maps (privileged role only).", "title": "Social Public Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Reconcile public maps (privileged role only).", "write_mode": null}, {"action": "social.merge_feed", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "effect_override": {"conditional_mutate": "Merge-read only; no durable social writes.", "kind": "read", "read_only_hint": true}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.merge_feed", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Merge Feed"}, "effect": {"audit_batch_allowed": true, "conditional_mutate": "Merge-read only; no durable social writes.", "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "effect_override": {"conditional_mutate": "Merge-read only; no durable social writes.", "kind": "read", "read_only_hint": true}, "errors": {"forbidden": "social_read cap required", "invalid_parameters": "limit/cursor bounds — not social.chat.history", "unauthorized": "auth.get_profile — merged feed is per user"}, "execution_class": "plain_read", "instruction_hint": "Merge read of multiple channel pointers (reader must access each). Each pointer is the latest 200 m…", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Merged timeline: social.merge_feed — not per-channel social.chat.history. Federation graph: social.federation.add before cross-project public publish.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_merge_feed", "semantic_input_mode": "inherit_workflow", "summary": "Merge read of multiple channel pointers (reader must access each). Each pointer is the latest 200 messages. Page one channel with social.chat.history.", "title": "Social Merge Feed", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "social_read cap required", "invalid_parameters": "limit/cursor bounds — not social.chat.history", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — merged feed is per user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Merge read of multiple channel pointers (reader must access each). Each pointer is the latest 200 messages. Page one channel with social.chat.history.", "write_mode": null}, {"action": "social.admin.chat_sweep", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.chat_sweep", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Chat Sweep"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Run one chat history prune batch. Requires ecosystem owner/admin on project 1.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_chat_sweep", "semantic_input_mode": "inherit_workflow", "summary": "Run one chat history prune batch. Requires ecosystem owner/admin on project 1.", "title": "Social Admin Chat Sweep", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Run one chat history prune batch. Requires ecosystem owner/admin on project 1.", "write_mode": null}, {"action": "social.admin.user_summary", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.user_summary", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin User Summary"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: aggregate friend/request/block counts and messenger prefs summary for a user_id.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_user_summary", "semantic_input_mode": "inherit_workflow", "summary": "Operator: aggregate friend/request/block counts and messenger prefs summary for a user_id.", "title": "Social Admin User Summary", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: aggregate friend/request/block counts and messenger prefs summary for a user_id.", "write_mode": null}, {"action": "social.admin.chat_index_page", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.chat_index_page", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Chat Index Page"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: paginated messenger chat index for a user (cursor/limit).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_chat_index_page", "semantic_input_mode": "inherit_workflow", "summary": "Operator: paginated messenger chat index for a user (cursor/limit).", "title": "Social Admin Chat Index Page", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: paginated messenger chat index for a user (cursor/limit).", "write_mode": null}, {"action": "social.admin.channel_search", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.channel_search", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Channel Search"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: search channel metadata on a home_project_id by substring (id/title).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_channel_search", "semantic_input_mode": "inherit_workflow", "summary": "Operator: search channel metadata on a home_project_id by substring (id/title).", "title": "Social Admin Channel Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: search channel metadata on a home_project_id by substring (id/title).", "write_mode": null}, {"action": "social.admin.directory_search", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.directory_search", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Directory Search"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: unified typeahead — users (8DNA) + channels for a home_project_id.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_directory_search", "semantic_input_mode": "inherit_workflow", "summary": "Operator: unified typeahead — users (8DNA) + channels for a home_project_id.", "title": "Social Admin Directory Search", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: unified typeahead — users (8DNA) + channels for a home_project_id.", "write_mode": null}, {"action": "social.admin.messenger_policy_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.messenger_policy_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Messenger Policy Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: read messenger retention defaults, stored overrides, and merged effective policy.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_messenger_policy_get", "semantic_input_mode": "inherit_workflow", "summary": "Operator: read messenger retention defaults, stored overrides, and merged effective policy.", "title": "Social Admin Messenger Policy Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: read messenger retention defaults, stored overrides, and merged effective policy.", "write_mode": null}, {"action": "social.admin.messenger_policy_set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.messenger_policy_set", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Messenger Policy Set"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Operator: replace messenger_operator_policy on ecosystem project (tiers, temp TTL, sweep ceiling).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_admin_messenger_policy_set", "semantic_input_mode": "inherit_workflow", "summary": "Operator: replace messenger_operator_policy on ecosystem project (tiers, temp TTL, sweep ceiling).", "title": "Social Admin Messenger Policy Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: replace messenger_operator_policy on ecosystem project (tiers, temp TTL, sweep ceiling).", "write_mode": null}, {"action": "social.admin.messenger_client_cache_get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.messenger_client_cache_get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Messenger Client Cache Get"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: read messenger client cache limits (defaults, stored overrides, merged effective).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_messenger_client_cache_get", "semantic_input_mode": "inherit_workflow", "summary": "Operator: read messenger client cache limits (defaults, stored overrides, merged effective).", "title": "Social Admin Messenger Client Cache Get", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: read messenger client cache limits (defaults, stored overrides, merged effective).", "write_mode": null}, {"action": "social.admin.messenger_client_cache_set", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.messenger_client_cache_set", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Messenger Client Cache Set"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Operator: replace data.ecosystem.messenger_client_cache on ecosystem project (media/IDB/OPFS caps).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_admin_messenger_client_cache_set", "semantic_input_mode": "inherit_workflow", "summary": "Operator: replace data.ecosystem.messenger_client_cache on ecosystem project (media/IDB/OPFS caps).", "title": "Social Admin Messenger Client Cache Set", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: replace data.ecosystem.messenger_client_cache on ecosystem project (media/IDB/OPFS caps).", "write_mode": null}, {"action": "social.admin.public_index_status", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.public_index_status", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Public Index Status"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: public index page or reconcile maps (set reconcile=true).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_public_index_status", "semantic_input_mode": "inherit_workflow", "summary": "Operator: public index page or reconcile maps (set reconcile=true).", "title": "Social Admin Public Index Status", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: public index page or reconcile maps (set reconcile=true).", "write_mode": null}, {"action": "social.admin.dm_thread_meta", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.dm_thread_meta", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Dm Thread Meta"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: DM thread metadata (counts, participants) for support; audited.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_dm_thread_meta", "semantic_input_mode": "inherit_workflow", "summary": "Operator: DM thread metadata (counts, participants) for support; audited.", "title": "Social Admin Dm Thread Meta", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: DM thread metadata (counts, participants) for support; audited.", "write_mode": null}, {"action": "social.admin.graph_edges", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.graph_edges", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Graph Edges"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: list friend and blocked edges for a user (capped).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_graph_edges", "semantic_input_mode": "inherit_workflow", "summary": "Operator: list friend and blocked edges for a user (capped).", "title": "Social Admin Graph Edges", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: list friend and blocked edges for a user (capped).", "write_mode": null}, {"action": "social.admin.relay_hints", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.relay_hints", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Relay Hints"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Operator: static hints for stream relay room naming and diagnostics paths.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_admin_relay_hints", "semantic_input_mode": "inherit_workflow", "summary": "Operator: static hints for stream relay room naming and diagnostics paths.", "title": "Social Admin Relay Hints", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: static hints for stream relay room naming and diagnostics paths.", "write_mode": null}, {"action": "social.admin.force_delete_message", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.force_delete_message", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Force Delete Message"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Operator: delete a chat message by id from DNA ring (ecosystem owner). Use dry_run first.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "social_admin_force_delete_message", "semantic_input_mode": "inherit_workflow", "summary": "Operator: delete a chat message by id from DNA ring (ecosystem owner). Use dry_run first.", "title": "Social Admin Force Delete Message", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: delete a chat message by id from DNA ring (ecosystem owner). Use dry_run first.", "write_mode": null}, {"action": "social.admin.reset_messenger_prefs", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.reset_messenger_prefs", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Reset Messenger Prefs"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Operator: clear messenger_prefs for a user (reason required).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_admin_reset_messenger_prefs", "semantic_input_mode": "inherit_workflow", "summary": "Operator: clear messenger_prefs for a user (reason required).", "title": "Social Admin Reset Messenger Prefs", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: clear messenger_prefs for a user (reason required).", "write_mode": null}, {"action": "social.admin.revoke_federation", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.revoke_federation", "mutation_risk": "high", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Revoke Federation"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Operator: remove a federation pointer from consumer to source channel.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "social_admin_revoke_federation", "semantic_input_mode": "inherit_workflow", "summary": "Operator: remove a federation pointer from consumer to source channel.", "title": "Social Admin Revoke Federation", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: remove a federation pointer from consumer to source channel.", "write_mode": null}, {"action": "social.admin.force_close_channel", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.force_close_channel", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Admin Force Close Channel"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "instruction_hint": "Operator: delete channel metadata from project data_channels (ecosystem owner).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "Staff moderation: social.admin.* — requires desk/admin access; not social.support.inbox.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "social_admin_force_close_channel", "semantic_input_mode": "inherit_workflow", "summary": "Operator: delete channel metadata from project data_channels (ecosystem owner).", "title": "Social Admin Force Close Channel", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Operator: delete channel metadata from project data_channels (ecosystem owner).", "write_mode": null}, {"action": "social.chat.delta", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.delta", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Delta"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"delta_failed": "Retry once; verify channel_id and since_seq/since_hlc cursors", "forbidden": "social_read cap or channel membership denied", "invalid_parameters": "channel_id required — discover via social.chat.index_get", "not_found": "channel_id unknown — social.channels.register or invites", "unauthorized": "auth.get_profile — delta requires signed-in reader_user_id"}, "execution_class": "plain_read", "instruction_hint": "Unified incremental delta for a messenger channel — one call returns new messages,", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_chat_delta", "semantic_input_mode": "inherit_workflow", "summary": "Unified incremental delta for a messenger channel — one call returns new messages,", "title": "Social Chat Delta", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "delta_failed": "Retry once; verify channel_id and since_seq/since_hlc cursors", "forbidden": "social_read cap or channel membership denied", "invalid_parameters": "channel_id required — discover via social.chat.index_get", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "channel_id unknown — social.channels.register or invites", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — delta requires signed-in reader_user_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Unified incremental delta for a messenger channel — one call returns new messages,", "write_mode": null}, {"action": "social.chat.crdt_update", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.crdt_update", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Crdt Update"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Apply a Y.js CRDT update to a channel's shared document (bodies / pins / deletes).", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_chat_crdt_update", "semantic_input_mode": "inherit_workflow", "summary": "Apply a Y.js CRDT update to a channel's shared document (bodies / pins / deletes).", "title": "Social Chat Crdt Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Apply a Y.js CRDT update to a channel's shared document (bodies / pins / deletes).", "write_mode": null}, {"action": "social.chat.crdt_state", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "advanced", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.crdt_state", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Chat Crdt State"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read the CRDT snapshot and update log for a channel.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Chat: social.chat.history and social.chat.post.", "plane_chooser": "social.chat.history: pass since_seq for polling; save max seq between calls. social.chat.index_put is subset-as-delete — short entries list drops missing keys; write_mode=replace only. Support tickets use social.support.history, not chat.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_chat_crdt_state", "semantic_input_mode": "inherit_workflow", "summary": "Read the CRDT snapshot and update log for a channel.", "title": "Social Chat Crdt State", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read the CRDT snapshot and update log for a channel.", "write_mode": null}, {"action": "social.support.history", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not use social.chat.history for support tickets — psup threads are social.support.*.", "Call social.support.eligibility before assuming support is enabled."], "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.history", "related_tools": ["social.support.send", "social.support.request_human", "social.chat.history"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support History"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Read caller's psup thread (user plane) — pair with social.support.send.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.send", "social.support.request_human", "social.chat.history"], "required_cap": "project_support", "requires_preflight": false, "risk_class": "read", "safe_action": "social_support_history", "semantic_input_mode": "inherit_workflow", "summary": "Read project support thread for the authenticated user (channel psup_p{pid}_u{uid}).", "support_atoms": {"SUPPORT_ELIGIBILITY_FIRST": "social.support.eligibility before history/send — end_user_support_enabled false returns eligibility_denied on user-plane reads.", "SUPPORT_NOT_CHAT": "Support threads are social.support.* — social.chat.history is messenger DMs, not psup tickets.", "SUPPORT_USER_VS_STAFF": "End users: social.support.history / social.support.send on psup_p{pid}_u{uid}. Staff desk: social.support.inbox / transition / assign — not social.chat.*."}, "title": "Social Support History", "when_blocked": {"channel_not_bound": "support channel not provisioned — social.support.config.patch or owner enables entry gates", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eligibility_denied": "social.support.eligibility — end_user_support_enabled false for project_id; use public lounge flag or enable private support", "forbidden": "project membership required — context.project_id bound to home project", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Read caller's psup thread (user plane) — pair with social.support.send.", "write_mode": null}, {"action": "social.support.send", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_patterns": ["Staff reply needs channel_user_id + desk access — omit target for end-user self send.", "Do not duplicate messenger DM flows — support uses psup channel ids."], "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.send", "related_tools": ["social.support.history", "social.support.request_human"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Send"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Post in psup thread: user message or staff reply when permitted.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.history", "social.support.request_human"], "required_cap": "project_support", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_support_send", "semantic_input_mode": "inherit_workflow", "summary": "Send a message in the user's support thread for a project (user) or staff reply when permitted.", "support_atoms": {"SUPPORT_ELIGIBILITY_FIRST": "social.support.eligibility before history/send — end_user_support_enabled false returns eligibility_denied on user-plane reads.", "SUPPORT_NOT_CHAT": "Support threads are social.support.* — social.chat.history is messenger DMs, not psup tickets."}, "title": "Social Support Send", "when_blocked": {"channel_not_bound": "psup channel missing — enable support entry or social.support.config.patch ai binding", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eligibility_denied": "social.support.eligibility — private support disabled; check end_user_support_enabled", "forbidden": "auth.get_profile — cannot post without authenticated user", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "staff_only": "staff reply with channel_user_id requires support desk access — use user plane send without channel_user_id", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Post in psup thread: user message or staff reply when permitted.", "write_mode": null}, {"action": "social.support.inbox", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_patterns": ["Do not call inbox from user plane — staff membership required.", "User messages: social.support.send without channel_user_id."], "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.inbox", "related_tools": ["social.support.history", "social.support.transition", "social.support.assign"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Social Support Inbox"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"limit": 123, "project_id": 123}, "example_request": {"action": "social.support.inbox", "params": {"limit": 123, "project_id": 123}}, "execution_class": "plain_read", "instruction_hint": "Staff desk: list open support tickets for a project.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.history", "social.support.transition", "social.support.assign"], "required_cap": "project_support", "requires_preflight": false, "risk_class": "read", "safe_action": "social_support_inbox", "semantic_input_mode": "inherit_workflow", "summary": "Staff inbox preview list for a project (requires support access).", "support_atoms": {"SUPPORT_USER_VS_STAFF": "End users: social.support.history / social.support.send on psup_p{pid}_u{uid}. Staff desk: social.support.inbox / transition / assign — not social.chat.*."}, "title": "Social Support Inbox", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project support desk access denied — not project owner/admin/support role", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "staff_only": "social.support.inbox requires support staff membership — resolve_support_access; user plane uses history/send", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Staff desk: list open support tickets for a project.", "write_mode": null}, {"action": "social.support.eligibility", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.eligibility", "related_tools": ["social.support.search_projects", "social.support.history"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Eligibility"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Batch: which home projects expose support lounge vs private psup.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.search_projects", "social.support.history"], "required_cap": "project_support", "requires_preflight": false, "risk_class": "read", "safe_action": "social_support_eligibility", "semantic_input_mode": "inherit_workflow", "summary": "Batch read: for home project ids the user can access, returns whether end-user private support and/or public Messenger support lounge are enabled (channel id psup_pub_p{pid} when public).", "support_atoms": {"SUPPORT_ELIGIBILITY_FIRST": "social.support.eligibility before history/send — end_user_support_enabled false returns eligibility_denied on user-plane reads.", "SUPPORT_USER_VS_STAFF": "End users: social.support.history / social.support.send on psup_p{pid}_u{uid}. Staff desk: social.support.inbox / transition / assign — not social.chat.*."}, "title": "Social Support Eligibility", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "project_ids must be a numeric array (max 80)", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required before eligibility batch", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Batch: which home projects expose support lounge vs private psup.", "write_mode": null}, {"action": "social.support.search_projects", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.search_projects", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Search Projects"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "Find projects the user can contact for support by title query.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_support_search_projects", "semantic_input_mode": "inherit_workflow", "summary": "Search projects the user may contact via support (titles ranked vs query). Returns support entry flags per row.", "support_atoms": {"SUPPORT_ELIGIBILITY_FIRST": "social.support.eligibility before history/send — end_user_support_enabled false returns eligibility_denied on user-plane reads.", "SUPPORT_USER_VS_STAFF": "End users: social.support.history / social.support.send on psup_p{pid}_u{uid}. Staff desk: social.support.inbox / transition / assign — not social.chat.*."}, "title": "Social Support Search Projects", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "limit max 80 — omit q for recent contacts", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — operator session required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Find projects the user can contact for support by title query.", "write_mode": null}, {"action": "social.support.transition", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.transition", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Transition"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Staff: move ticket lifecycle status (open/pending/resolved).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "project_support", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_support_transition", "semantic_input_mode": "inherit_workflow", "summary": "Staff: transition a support ticket lifecycle status (requires support desk access).", "support_atoms": {"SUPPORT_USER_VS_STAFF": "End users: social.support.history / social.support.send on psup_p{pid}_u{uid}. Staff desk: social.support.inbox / transition / assign — not social.chat.*."}, "title": "Social Support Transition", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "support desk access required on project_id", "invalid_status": "TicketStatus enum — same recovery as invalid_transition", "invalid_transition": "TicketStatus enum — open/pending/resolved/closed/reopened", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "staff_only": "staff desk only — social.support.inbox first; user plane cannot transition", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Staff: move ticket lifecycle status (open/pending/resolved).", "write_mode": null}, {"action": "social.support.assign", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.assign", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Assign"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Staff: assign ticket to staff user id or unassign (null).", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "project_support", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_support_assign", "semantic_input_mode": "inherit_workflow", "summary": "Staff: assign a support ticket to a staff user id (or unassign with null).", "support_atoms": {"SUPPORT_USER_VS_STAFF": "End users: social.support.history / social.support.send on psup_p{pid}_u{uid}. Staff desk: social.support.inbox / transition / assign — not social.chat.*."}, "title": "Social Support Assign", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "support desk access required on project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "staff_only": "staff desk only — assignee_user_id must be support staff on project", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Staff: assign ticket to staff user id or unassign (null).", "write_mode": null}, {"action": "social.support.request_human", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.request_human", "related_tools": ["social.support.send", "social.support.history"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Request Human"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "End user: escalate AI/handoff to human staff on current ticket.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.send", "social.support.history"], "required_cap": "project_support", "requires_preflight": false, "risk_class": "read", "safe_action": "social_support_request_human", "semantic_input_mode": "inherit_workflow", "summary": "End user: request a human handoff for the current ticket (pending when allowed).", "title": "Social Support Request Human", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "eligibility_denied": "private support disabled — social.support.eligibility first", "forbidden": "caller must own the psup thread for project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "End user: escalate AI/handoff to human staff on current ticket.", "write_mode": null}, {"action": "social.support.config.patch", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.social.support.gen1"], "id": "social.support.config.patch", "mutation_risk": "low", "related_tools": ["social.support.ai_binding_health", "agents.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Config Patch"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "instruction_hint": "Bind one project agent as support AI. Do not also set chat triggers on that agent.", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.ai_binding_health", "agents.get"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "social_support_config_patch", "semantic_input_mode": "inherit_workflow", "summary": "Merge project support config (ai_agent_uuid, ai_mode, entry gates). Owner or admin.", "support_atoms": {"SUPPORT_AI_BINDING": "social.support.config.patch binds one project agent — confirm with social.support.ai_binding_health; channel_not_bound when ai_agent_uuid missing."}, "title": "Social Support Config Patch", "when_blocked": {"channel_not_bound": "ai_agent_uuid must reference a project-scoped agent — agents.get before patch; social.support.ai_binding_health after bind", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project owner or admin required — not end-user self-service", "invalid_parameters": "patch object required with partial support config keys", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Bind one project agent as support AI. Do not also set chat triggers on that agent.", "write_mode": null}, {"action": "social.support.ai_binding_health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.social.support.gen1"], "id": "social.support.ai_binding_health", "related_tools": ["social.support.config.patch", "agents.get"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Social Support Ai Binding Health"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "instruction_hint": "After social.support.config.patch, confirm the bound agent and mode.", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "plane": "Support inbox: social.support.inbox.", "plane_chooser": "User plane: social.support.eligibility → social.support.history / social.support.send. Staff plane: social.support.inbox — requires support desk access on the project. Messenger DMs use social.chat.*; support tickets use social.support.*, not social.chat.history.", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.config.patch", "agents.get"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "social_support_ai_binding_health", "semantic_input_mode": "inherit_workflow", "summary": "Read support AI binding health (agent, mode, warnings).", "support_atoms": {"SUPPORT_AI_BINDING": "social.support.config.patch binds one project agent — confirm with social.support.ai_binding_health; channel_not_bound when ai_agent_uuid missing.", "SUPPORT_ELIGIBILITY_FIRST": "social.support.eligibility before history/send — end_user_support_enabled false returns eligibility_denied on user-plane reads."}, "title": "Social Support Ai Binding Health", "when_blocked": {"channel_not_bound": "no ai_agent_uuid in support config — social.support.config.patch with agents.list id", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project read membership required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After social.support.config.patch, confirm the bound agent and mode.", "write_mode": null}], "stackscript": [{"action": "stackscript.fuel.quote", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.stackscript.engine.gen1"], "id": "stackscript.fuel.quote", "mutation_risk": "low", "related_tools": ["stackscript.fuel.purchase", "finance.pay.execute", "script.profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stackscript Fuel Quote"}, "do_not_use_when": "Quote only — does not grant fuel; stackscript.fuel.purchase or finance.pay after quote.", "domain_title": "Stackscript MCP domain", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Tariff + buffs + prepaid balance preview — no wallet debit", "effect_depends_on_params": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "buyer_mismatch": "buyer_user_id must match the MCP session user_id", "fuel_units_invalid": "fuel_units must be a positive integer", "invalid_parameters": "Check fuel_units (positive integer) and context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.stackscript.gen1"], "instruction_hint": "Quote prepaid StackScript VM fuel (ecosystem.metrics prepaid balance) — not LLM compute_credits. Pa…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.stackscript", "owner_gene": "core.mcp.stackscript.gen1", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_stackscript"], "related_tools": ["stackscript.fuel.purchase", "finance.pay.execute", "script.profile"], "required_cap": "stackscript_read", "requires_preflight": false, "risk_class": "read", "safe_action": "stackscript_fuel_quote", "semantic_input_mode": "inherit_workflow", "summary": "Quote a StackScript fuel top-up pack (prepaid VM fuel, not LLM compute credits).", "title": "Stackscript Fuel Quote", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "buyer_mismatch": "buyer_user_id must match the MCP session user_id", "fuel_units_invalid": "fuel_units must be a positive integer", "invalid_parameters": "Check fuel_units (positive integer) and context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id"}, "when_not_to_use": "Quote only — does not grant fuel; stackscript.fuel.purchase or finance.pay after quote.", "when_to_use": "Quote prepaid StackScript VM fuel (ecosystem.metrics prepaid balance) — not LLM compute_credits. Pair with finance.pay intent stackscript_fuel_pack or stackscript.fuel.purchase after settlement.", "write_mode": null}, {"action": "stackscript.fuel.purchase", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1"], "id": "stackscript.fuel.purchase", "mutation_risk": "low", "related_tools": ["stackscript.fuel.quote", "script.profile", "buffs.get_effective_limits"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stackscript Fuel Purchase"}, "do_not_use_when": "Not for monthly tier upgrade — buffs/commerce rails; quote first via stackscript.fuel.quote.", "domain_title": "Stackscript MCP domain", "effect": {"audit_batch_allowed": true, "conditional_mutate": "Commerce rail top-up for VM fuel — mutates wallet; use stackscript.fuel.quote before purchase in agent loops", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "buyer_mismatch": "buyer_user_id must match the MCP session user_id and the quote buyer", "fuel_grant_failed": "Quote consumed but prepaid grant failed — support with quote_id", "fuel_units_mismatch": "fuel_units must match quoted pack size", "invalid_parameters": "Pass quote_id, quote_hash, and fuel_units from stackscript.fuel.quote", "project_id_mismatch": "quote project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "quote_expired": "Re-run stackscript.fuel.quote", "quote_hash_mismatch": "Pass quote_hash from stackscript.fuel.quote response", "quote_not_found": "Re-run stackscript.fuel.quote — quote expired or wrong worker"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.stackscript.gen1"], "instruction_hint": "Grant quoted fuel_units to prepaid balance — prefer finance.pay.execute with intent stackscript_fue…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.stackscript", "owner_gene": "core.mcp.stackscript.gen1", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_stackscript"], "related_tools": ["stackscript.fuel.quote", "script.profile", "buffs.get_effective_limits"], "required_cap": "stackscript_run", "requires_preflight": false, "risk_class": "low_write", "safe_action": "stackscript_fuel_purchase", "semantic_input_mode": "inherit_workflow", "summary": "Apply a quoted StackScript fuel pack to project prepaid balance.", "title": "Stackscript Fuel Purchase", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "buyer_mismatch": "buyer_user_id must match the MCP session user_id and the quote buyer", "fuel_grant_failed": "Quote consumed but prepaid grant failed — support with quote_id", "fuel_units_mismatch": "fuel_units must match quoted pack size", "invalid_parameters": "Pass quote_id, quote_hash, and fuel_units from stackscript.fuel.quote", "project_id_mismatch": "quote project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "quote_expired": "Re-run stackscript.fuel.quote", "quote_hash_mismatch": "Pass quote_hash from stackscript.fuel.quote response", "quote_not_found": "Re-run stackscript.fuel.quote — quote expired or wrong worker"}, "when_not_to_use": "Not for monthly tier upgrade — buffs/commerce rails; quote first via stackscript.fuel.quote.", "when_to_use": "Grant quoted fuel_units to prepaid balance — prefer finance.pay.execute with intent stackscript_fuel_pack; use this when wallet/card rail already settled.", "write_mode": null}, {"action": "stackscript.wallet.replay", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "stackscript.wallet.replay", "mutation_risk": "low", "related_tools": ["script.run", "script.profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stackscript Wallet Replay"}, "do_not_use_when": "Only when script.run returned wallet_repair_path — not for normal script.run recovery.", "domain_title": "Stackscript MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "ledger_apply_failed": "Ledger still rejected wallet_ops — fix balances then retry", "project_id_mismatch": "Repair leaf project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "repair_not_found": "Pass wallet_repair_path from legacy script.run wallet_commit_failed response", "repair_not_pending": "Leaf status is not pending — may already be completed", "wallet_commit_failed": "Ledger rejected ops — inspect commerce ledger", "wallet_insufficient_funds": "Top up balances before replaying wallet_ops", "wallet_replay_failed": "Repair leaf has no wallet_ops to replay", "wallet_user_required": "Repair row missing user_id — replay with operator session"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.stackscript.gen1"], "instruction_hint": "Legacy only: replay wallet_ops from wallet_repair_path when that leaf exists. Ledger-first script.r…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.stackscript", "owner_gene": "core.mcp.stackscript.gen1", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_stackscript"], "related_tools": ["script.run", "script.profile"], "required_cap": "stackscript_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "stackscript_wallet_replay", "semantic_input_mode": "inherit_workflow", "summary": "Replay pending wallet_ops from a wallet_repair DNA leaf after script.run wallet_commit_failed.", "title": "Stackscript Wallet Replay", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "ledger_apply_failed": "Ledger still rejected wallet_ops — fix balances then retry", "project_id_mismatch": "Repair leaf project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "repair_not_found": "Pass wallet_repair_path from legacy script.run wallet_commit_failed response", "repair_not_pending": "Leaf status is not pending — may already be completed", "wallet_commit_failed": "Ledger rejected ops — inspect commerce ledger", "wallet_insufficient_funds": "Top up balances before replaying wallet_ops", "wallet_replay_failed": "Repair leaf has no wallet_ops to replay", "wallet_user_required": "Repair row missing user_id — replay with operator session"}, "when_not_to_use": "Only when script.run returned wallet_repair_path — not for normal script.run recovery.", "when_to_use": "Legacy only: replay wallet_ops from wallet_repair_path when that leaf exists. Ledger-first script.run does not enqueue wallet repair — use script.profile + retry.", "write_mode": null}, {"action": "stackscript.dna.replay", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "stackscript", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.stackscript.engine.gen1", "core.mcp.tools.gen1"], "id": "stackscript.dna.replay", "mutation_risk": "low", "related_tools": ["script.run", "script.profile"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stackscript Dna Replay"}, "do_not_use_when": "Only when commit_failed / db_unavailable returned dna_repair_path — not for routine edits (projects.patch_data / generation cycle).", "domain_title": "Stackscript MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "db_unavailable": "Retry after retry_after_ms — DNA repair leaf read hit a pool blip", "dna_replay_failed": "Repair leaf has no write_set to replay", "project_id_mismatch": "Repair leaf project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "repair_not_found": "Pass dna_repair_path from script.run commit_failed response", "repair_not_pending": "Leaf status is not pending — may already be completed"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.stackscript.gen1"], "instruction_hint": "After script.run commit_failed when ledger already applied — replay write_set from dna_repair_path …", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.stackscript", "owner_gene": "core.mcp.stackscript.gen1", "related_prompts": ["agentstack_agentcrush_remediation_v1", "agentstack_stackscript"], "related_tools": ["script.run", "script.profile"], "required_cap": "stackscript_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "stackscript_dna_replay", "semantic_input_mode": "inherit_workflow", "summary": "Replay pending write_set from a dna_repair DNA leaf after script.run commit_failed.", "title": "Stackscript Dna Replay", "when_blocked": {"auth_required": "MCP operator session required — Connect (G-A174) or /agentstack-authorize", "db_unavailable": "Retry after retry_after_ms — DNA repair leaf read hit a pool blip", "dna_replay_failed": "Repair leaf has no write_set to replay", "project_id_mismatch": "Repair leaf project_id must match context.project_id", "project_id_required": "Bind context.project_id before script.*", "project_not_found": "Unknown project or not a member — bind context.project_id", "repair_not_found": "Pass dna_repair_path from script.run commit_failed response", "repair_not_pending": "Leaf status is not pending — may already be completed"}, "when_not_to_use": "Only when commit_failed / db_unavailable returned dna_repair_path — not for routine edits (projects.patch_data / generation cycle).", "when_to_use": "After script.run commit_failed when ledger already applied — replay write_set from dna_repair_path leaf (no wallet ops). Then script.profile and retry script.run with a new idempotency_key if needed.", "write_mode": null}], "storage": [{"action": "storage.get_quota", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not use this for /s/ site files — that is hosting.project.status.", "anti_patterns": ["Do not use this for /s/ site files — that is hosting.project.status.", "scope=user is the member row inside the project, not a personal account outside it.", "quota_mode=both enforces the member cap and the project pool; -1 means unlimited."], "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.get_quota", "related_tools": ["storage.get_project_usage_summary", "projects.get_project"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Get Quota"}, "do_not_use_when": "Checking hosting archive or snapshot room — use hosting.project.status.", "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Check quota before storage.upload.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.get_project_usage_summary", "projects.get_project"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_get_quota", "semantic_input_mode": "inherit_workflow", "summary": "Returns storage quota for the current user or project slice: used/limit bytes, tier_basis (project_owner vs fallback), owner_user_id. Pass project_id or rely on API key / session project. scope=user (", "title": "Storage Get Quota", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project read or owner/admin for scope=project", "insufficient_permissions": "project membership with storage:read cap", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.login — session user required", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Checking hosting archive or snapshot room — use hosting.project.status.", "when_to_use": "Check quota before storage.upload.", "write_mode": null}, {"action": "storage.get_project_usage_summary", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.get_project_usage_summary", "related_tools": ["storage.get_quota"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Get Project Usage Summary"}, "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Dashboards and agents that need project-wide storage consumption.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.get_quota"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_get_project_usage_summary", "semantic_input_mode": "inherit_workflow", "summary": "Owner/admin: total permanent/temp bytes across all members and project slice, plus project_pool_limit_bytes from the project billing tier.", "title": "Storage Get Project Usage Summary", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project owner or admin for aggregate usage", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Dashboards and agents that need project-wide storage consumption.", "write_mode": null}, {"action": "storage.get_hub_summary", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.get_hub_summary", "related_tools": ["storage.get_project_usage_summary"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Get Hub Summary"}, "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Storage hub overview dashboards and agents.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.get_project_usage_summary"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_get_hub_summary", "semantic_input_mode": "inherit_workflow", "summary": "Hub v4 aggregate: permanent/temp totals, hosting bytes, pool cap, sites count.", "title": "Storage Get Hub Summary", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "ecosystem admin for hub rollup", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Storage hub overview dashboards and agents.", "write_mode": null}, {"action": "storage.upload", "aliases": ["storage.put", "storage.put_file", "storage.upload_file", "storage.write"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "This action does not upload bytes. POST /api/storage/upload with the multipart contract.", "anti_patterns": ["This action does not upload bytes. POST /api/storage/upload with the multipart contract.", "Do not put site HTML here. Use hosting.deploy_files or hosting.files.put.", "Check storage.get_quota before a large file."], "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.upload", "related_tools": ["storage.get_quota", "storage.list_files", "storage.delete_file"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Upload"}, "do_not_use_when": "Editing a file already served from the site bucket on /s/.", "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "conditional_mutate": "MCP returns POST /api/storage/upload multipart contract only — no bytes on execute", "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Before attaching binaries — agents upload via REST, not MCP body.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Quota/list/delete via storage.* MCP; bytes via POST /api/storage/upload — never invent an MCP upload body. Full RBAC × storage matrix: deferred fixture.", "related_tools": ["storage.get_quota", "storage.list_files", "storage.delete_file"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_upload", "semantic_input_mode": "inherit_workflow", "summary": "Binary upload uses REST POST /api/storage/upload (multipart/form-data). This MCP action returns the contract + quota gate — call storage.get_quota first.", "title": "Storage Upload", "when_blocked": {"batch_semantic_anchor_required": "Should not fire after plain_read effect — if seen, use options.execution_intent=direct or discovery.describe storage.upload effect.execution_class", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "file_too_large": "reduce size or use hosting.files.put for /s/ site bytes", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "quota_exceeded": "REST 413 — storage.get_quota first; verify file, project_id, scope", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_quota": "storage.get_quota — delete via storage.delete_file or upgrade tier", "upload_failed": "read REST detail (413 vs 400); confirm multipart fields", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Editing a file already served from the site bucket on /s/.", "when_to_use": "Before attaching binaries — agents upload via REST, not MCP body.", "workflow_ladder": ["storage.get_quota project_id + scope=user (or scope=project for the shared row)", "Read quota_mode and project_pool_limit_bytes — both means member cap and project pool", "POST /api/storage/upload multipart: file, folder, project_id, scope", "Bots staff/broadcast/bus outbound: folder bots__outbound → attachments[] on bots.staff_reply, bots.bus.reply, bots.bus.send, or bots.bus.deliver. Do not paste the file body into text", "Agent run input: folder fleet__runs__inbound → attachments[] on agents.run", "Run output artifacts: fleet__runs__outbound or agents.graph_file_put (not MCP upload metadata alone)", "storage.list_files folder=_ to confirm the card id", "After agents.graph_file_put: storage.list_files with folder_key + file_id from storage_roundtrip_hint"], "write_mode": null}, {"action": "storage.list_files", "aliases": ["storage.files.list", "storage.folders.list", "storage.get", "storage.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "folder=_ is the root. Omit folder only when you need every folder.", "anti_patterns": ["folder=_ is the root. Omit folder only when you need every folder.", "Site tree listing is hosting.bucket.files.list, not storage.list_files.", "Graph artifacts: use storage_roundtrip_hint.folder from agents.graph_file_put, not folder=_ alone.", "No storage.preview_text — SPA FileTextPreviewPane reads the public /uploaded_files path; agents read linked graph files via agents.graph_file_get."], "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.list_files", "related_tools": ["storage.get_quota", "storage.delete_file"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage List Files"}, "do_not_use_when": "Listing pages of a hosted site — use hosting.bucket.files.list.", "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "List attachments in project storage scope.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.get_quota", "storage.delete_file"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_list_files", "semantic_input_mode": "inherit_workflow", "summary": "Lists files in an ecosystem storage folder for the current user or project slice. Pass folder key (use '_' for root) or omit to list all folders (heavy). Set include_folders=1 to return folder_index f", "title": "Storage List Files", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project membership with storage:read cap", "invalid_parameters": "project_id required — bind context.project_id", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_not_to_use": "Listing pages of a hosted site — use hosting.bucket.files.list.", "when_to_use": "List attachments in project storage scope.", "write_mode": null}, {"action": "storage.delete_file", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "anti_pattern": "Deleting a storage card does not remove a hosted /s/ file.", "anti_patterns": ["Deleting a storage card does not remove a hosted /s/ file."], "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.delete_file", "mutation_risk": "high", "related_tools": ["storage.list_files", "storage.get_quota"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Delete File"}, "domain_title": "Storage MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Remove blob — irreversible.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_tools": ["storage.list_files", "storage.get_quota"], "required_cap": "storage.write", "requires_preflight": true, "risk_class": "destructive", "safe_action": "storage_delete_file", "semantic_input_mode": "inherit_workflow", "summary": "Deletes a file from ecosystem storage (JSON registry + blob). Requires write access for user scope; owner/admin for project scope.", "title": "Storage Delete File", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "insufficient_permissions": "project write or storage:delete cap", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "storage.list_files folder=_ — confirm card id", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_quota": "delete does not free project pool until reconcile completes", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Remove blob — irreversible.", "write_mode": null}, {"action": "storage.scan", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.scan", "related_tools": ["storage.reconcile", "storage.list_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Scan"}, "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Diagnose empty storage UI or disk↔DNA drift before reconcile.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.reconcile", "storage.list_files"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_scan", "semantic_input_mode": "inherit_workflow", "summary": "Project RBAC: compare on-disk files with 8DNA storage registry for the resolved row. scope=user (default) scans caller member row; scope=project scans project slice (user_id=0). Prefer over storage.ad", "title": "Storage Scan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project admin or owner for project scope", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_scan_failed": "retry or narrow folder scope", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Diagnose empty storage UI or disk↔DNA drift before reconcile.", "write_mode": null}, {"action": "storage.reconcile", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_batch_note": "Default param slice may omit options.goal; mutating param keys in mutates_when require a batch semantic anchor.", "audit_batch_param_sensitive": true, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.reconcile", "mutates_when": {"dry_run": false}, "related_tools": ["storage.scan"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Reconcile"}, "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "audit_batch_param_sensitive": true, "conditional_mutate": "dry_run=true evaluates; dry_run=false deletes orphans", "effect_depends_on_params": true, "execution_class": "cheap", "generation": false, "kind": "destructive", "mutates_when": {"dry_run": false}, "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "example_params": {"delete_disk_orphans": true, "dry_run": true, "index_disk_orphans": true, "project_id": 123, "purge_dna_ghosts": true, "recalculate_quota": true, "scope": "example_string"}, "example_request": {"action": "storage.reconcile", "params": {"delete_disk_orphans": true, "dry_run": true, "index_disk_orphans": true, "project_id": 123, "purge_dna_ghosts": true, "recalculate_quota": true, "scope": "example_string"}}, "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "After storage.scan shows orphans or ghosts.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_tools": ["storage.scan"], "required_cap": "storage.read", "requires_preflight": true, "risk_class": "destructive", "rollback": [], "safe_action": "storage_reconcile", "semantic_input_mode": "inherit_workflow", "summary": "Project RBAC: fix disk↔8DNA drift for the resolved row (dry_run default true). scope=user requires write; scope=project requires owner/admin. Prefer over storage.admin_reconcile for tenants.", "title": "Storage Reconcile", "verification": ["storage.scan"], "verify": [{"action": "storage.scan", "predicate": "named resource is visible"}], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "project admin or owner for project scope", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_reconcile_failed": "check trace_id and storage admin_scan", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "After storage.scan shows orphans or ghosts.", "write_mode": null}, {"action": "storage.admin_scan", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.admin_scan", "related_tools": ["storage.scan", "storage.reconcile", "storage.list_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Admin Scan"}, "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Cross-tenant operator hub only; tenants use storage.scan.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.scan", "storage.reconcile", "storage.list_files"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_admin_scan", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem admin (platform hub): compare on-disk files with 8DNA storage registry for (project_id, dna_user_id). Tenants: use storage.scan.", "title": "Storage Admin Scan", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_scan_failed": "ops trace — compare on-disk vs 8DNA index", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cross-tenant operator hub only; tenants use storage.scan.", "write_mode": null}, {"action": "storage.admin_reconcile", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.admin_reconcile", "related_tools": ["storage.reconcile", "storage.scan"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Admin Reconcile"}, "domain_title": "Storage MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Cross-tenant operator hub only; tenants use storage.reconcile.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.reconcile", "storage.scan"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "storage_admin_reconcile", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem admin (platform hub): fix disk↔8DNA drift for any row. Tenants: use storage.reconcile with scope.", "title": "Storage Admin Reconcile", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "storage_reconcile_failed": "dry_run first; see admin_scan", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Cross-tenant operator hub only; tenants use storage.reconcile.", "write_mode": null}, {"action": "storage.admin_list_rows", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.admin_list_rows", "related_tools": ["storage.admin_scan", "storage.list_files"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Admin List Rows"}, "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Pick a storage row before admin scan/reconcile or file ops.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.admin_scan", "storage.list_files"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_admin_list_rows", "semantic_input_mode": "inherit_workflow", "summary": "Ecosystem admin: list 8DNA rows with data.ecosystem.storage (project_id, dna_user_id, file counts, bytes).", "title": "Storage Admin List Rows", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "ecosystem owner required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Pick a storage row before admin scan/reconcile or file ops.", "write_mode": null}, {"action": "storage.bind_entity", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.bind_entity", "related_tools": ["agents.graph_file_put", "agents.graph_file_list", "storage.list_files", "storage.list_by_entity"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Bind Entity"}, "domain_title": "Storage MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Link an uploaded file to a CRM deal, contact, or other entity.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["agents.graph_file_put", "agents.graph_file_list", "storage.list_files", "storage.list_by_entity"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "storage_bind_entity", "semantic_input_mode": "inherit_workflow", "summary": "Attach entity_ref to a storage file card.", "title": "Storage Bind Entity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "entity_type and entity_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "storage.list_files — confirm file id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Link an uploaded file to a CRM deal, contact, or other entity.", "write_mode": null}, {"action": "storage.list_by_entity", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.list_by_entity", "related_tools": ["agents.graph_file_list", "agents.graph_file_get", "storage.list_files", "storage.bind_entity"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage List By Entity"}, "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "List attachments for a deal or contact after storage.bind_entity.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["agents.graph_file_list", "agents.graph_file_get", "storage.list_files", "storage.bind_entity"], "required_cap": "storage.read", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_list_by_entity", "semantic_input_mode": "inherit_workflow", "summary": "List files bound to an entity_ref.", "title": "Storage List By Entity", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "entity_type and entity_id required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "not_found": "entity has no bound files", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "List attachments for a deal or contact after storage.bind_entity.", "write_mode": null}, {"action": "storage.import_from_url", "aliases": ["storage.import_url", "storage.upload_from_url"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "anti_pattern": "Do not use for /s/ HTML assets — use hosting.bucket.file.import_url.", "anti_patterns": ["HTTPS-only; SSRF blocked (no localhost/private IPs). Max 10 MiB.", "Bots attachments: prefer storage.import_from_url or REST upload, then file_id in bots.bus.deliver.", "Hosted /s/ bytes: hosting.bucket.file.import_url — not storage."], "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.import_from_url", "mutation_risk": "low", "related_tools": ["storage.get_quota", "storage.list_files", "hosting.site.import_archive"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Storage Import From Url"}, "domain_title": "Storage MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Server-side HTTPS fetch into ecosystem storage (SSRF-safe, project write cap). Site trees and ZIP d…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "owner_gene": "core.mcp.storage.gen1", "plane": "Blobs: storage.get_quota, then REST POST /api/storage/upload. List: storage.list_files folder=_.", "plane_chooser": "Bytes upload on REST. MCP lists folder '_' . An empty file list is valid.", "related_tools": ["storage.get_quota", "storage.list_files", "hosting.site.import_archive"], "required_cap": "storage.write", "requires_preflight": false, "risk_class": "read", "safe_action": "storage_import_from_url", "semantic_input_mode": "inherit_workflow", "summary": "Server-side HTTPS fetch into ecosystem storage (SSRF-safe, project write cap). Site trees and ZIP dist: hosting.site.import_archive or hosting.bucket.file.import_url. Max 10 MiB per call — same order ", "title": "Storage Import From Url", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Server-side HTTPS fetch into ecosystem storage (SSRF-safe, project write cap). Site trees and ZIP dist: hosting.site.import_archive or hosting.bucket.file.import_url. Max 10 MiB per call — same order", "write_mode": null}], "stream": [{"action": "stream.relay.list_rooms", "aliases": ["stream.relay.rooms.list", "stream_relay.list_rooms", "stream_relay.rooms.list"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "simple", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "stream.relay.list_rooms", "related_tools": ["stream.relay.create_room", "stream.relay.ws_ticket"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stream Relay List Rooms", "visitor_callable": true}, "do_not_use_when": "Not for qm: ephemeral rooms — use rooms.poll_events.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"execution_error": "Relay or room runtime failed — retry once; for qm: rooms use poll fallback. → next: rooms.poll_events", "invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "unauthorized": "MCP context missing user_id — auth.get_profile or hosted session. → next: auth.get_profile"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Inventory relay DNA rooms — before create_room or ws_ticket.", "mutation_kind": "none", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["stream.relay.create_room", "stream.relay.ws_ticket"], "required_cap": "social_read", "requires_preflight": false, "risk_class": "read", "safe_action": "stream_relay_list_rooms", "semantic_input_mode": "inherit_workflow", "summary": "List stream relay rooms for the active project (same service as REST GET /api/stream-relay/rooms).", "title": "Stream Relay List Rooms", "when_blocked": {"execution_error": "Relay DNA read failed — retry once", "invalid_parameters": "project_id", "unauthorized": "auth.get_profile"}, "when_not_to_use": "Not for qm: ephemeral rooms — use rooms.poll_events.", "when_to_use": "Inventory relay DNA rooms — before create_room or ws_ticket.", "write_mode": null}, {"action": "stream.relay.ws_ticket", "aliases": ["relay.ws_ticket", "stream_relay.ws_ticket", "ws.ticket"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1"], "id": "stream.relay.ws_ticket", "related_tools": ["rooms.quick_match", "rooms.poll_events"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stream Relay Ws Ticket", "visitor_callable": true}, "do_not_use_when": "Not before rooms.quick_match seats you (qm: room_id). Not for script-only coop without relay room.", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"authority_is_stackscript": "Server tick owns board DNA — clients read relay_envelope.body; use script.room.tick on authority, not client state_update. → next: script.room.tick", "execution_error": "Relay or room runtime failed — retry once; for qm: rooms use poll fallback. → next: rooms.poll_events", "hosted_app_required": "Player path: mint hosted session cookie, then rooms.* on /s/{pid}/mcp. → next: discovery.describe", "invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match", "message_too_large": "Relay frame exceeds room max_message_size — shrink the lockstep payload; do not retry the same blob. → next: stream.relay.ws_ticket", "not_a_participant": "Only seated players may poll or open ws_ticket — rooms.quick_match first. → next: rooms.quick_match", "rate_limit_exceeded": "Inbound relay rate window is full — back off; do not tight-loop broadcast. → next: rooms.poll_events", "room_not_joinable": "For quick match use room_id from rooms.quick_match (qm:… prefix). For persisted relay rooms use stream.relay.create_room first. → next: rooms.quick_match", "unauthorized": "MCP context missing user_id — auth.get_profile or hosted session. → next: auth.get_profile", "ws_ticket_failed": "JWT mint failed — retry rooms.quick_match then ws_ticket; fall back to rooms.poll_events. → next: rooms.poll_events"}, "examples": [{"action": "stream.relay.ws_ticket", "params": {"project_id": 2052, "room_id": "qm:wt-match:1v1:qm_a1b2c3d4e5f67890", "ttl_seconds": 60}}], "execution_class": "plain_read", "genetic_tags": ["core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Mint short-lived JWT for wss …/stream-relay/ws/rooms/{room_id}?token= — never put API keys in the q…", "mutation_kind": "none", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["rooms.quick_match", "rooms.poll_events"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "stream_relay_ws_ticket", "semantic_input_mode": "inherit_workflow", "summary": "Mint a short-lived JWT for wss://…/api/stream-relay/ws/rooms/{room_id}?token=… Do not put API keys in the WS query. Polling fallback: rooms.poll_events.", "title": "Stream Relay Ws Ticket", "when_blocked": {"authority_is_stackscript": "script.room.tick — server tick owns the board; unwrap relay_envelope.body only", "execution_error": "rooms.poll_events", "hosted_app_required": "POST /api/hosted-apps/{pid}/session", "invalid_parameters": "project_id, user_id, room_id", "match_not_found": "Match missing on this worker or expired. Retry the same /s/{pid}/mcp cookie (sticky). rooms.quick_match only when worker_local is false. → next: rooms.quick_match", "message_too_large": "Relay frame exceeds room max_message_size — shrink the lockstep payload; do not retry the same blob. → next: stream.relay.ws_ticket", "not_a_participant": "rooms.quick_match first — ws_ticket requires QM seat", "rate_limit_exceeded": "Inbound relay rate window is full — back off; do not tight-loop broadcast. → next: rooms.poll_events", "room_not_joinable": "Use room_id from rooms.quick_match (qm:…)", "unauthorized": "auth.get_profile or hosted session", "ws_ticket_failed": "Retry ws_ticket; fallback poll"}, "when_not_to_use": "Not before rooms.quick_match seats you (qm: room_id). Not for script-only coop without relay room.", "when_to_use": "Mint short-lived JWT for wss …/stream-relay/ws/rooms/{room_id}?token= — never put API keys in the query.", "write_mode": null}, {"action": "stream.relay.create_room", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "authority_matrix": "| Pattern | Authority | Transport |\n| Nahual coop-2P (scalar) | Host sim + puppet; script scalars | `script.run` + idempotency + `expected_revision` (no full room log) |\n| War Tactics / board | Revision leaves SoT | `createStackScriptMatchClient` + leaf poll |\n| THERMO / lockstep arcade | Relay room log | `rooms.quick_match` → `stream.relay.ws_ticket` |\n", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.games.quick_match.gen1"], "id": "stream.relay.create_room", "related_tools": ["stream.relay.ws_ticket", "stream.relay.list_rooms"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Stream Relay Create Room", "visitor_callable": false}, "do_not_use_when": "Not for quick_match netplay — rooms.quick_match creates qm: rooms.", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"execution_error": "Relay or room runtime failed — retry once; for qm: rooms use poll fallback. → next: rooms.poll_events", "invalid_parameters": "Need project_id + authenticated user_id + script_id (and match_id for poll/leave). → next: auth.get_profile", "room_create_failed": "Could not allocate relay room — retry or lower concurrent matches. → next: rooms.quick_match", "unauthorized": "MCP context missing user_id — auth.get_profile or hosted session. → next: auth.get_profile"}, "execution_class": "cheap", "genetic_tags": ["core.games.quick_match.gen1", "core.mcp.self_description.gen1"], "instruction_hint": "Persist relay room for StackScript room.host — then stream.relay.ws_ticket.", "mutation_kind": "entity", "plane_chooser": "Pick one plane — do not mix DNA coop with QM relay unless the showcase cookbook says so:\n• **Competitive / netplay (WT, Serpent, qm:)** `rooms.quick_match` → `rooms.poll_events` → `stream.relay.ws_ticket` → lockstep `broadcast` with `{np:1}` wire; optional `script.run` public exports. **WS reconnect:** seats stay ~12s after socket drop (`QUICK_MATCH_RELAY_LEAVE_GRACE_SEC`); relay connect refreshes `QUICK_MATCH_SEAT_STALE_SEC` liveness — poll alone is not enough for WS-only.\n• **Multi-worker:** in-process QM is sticky per worker — nginx session affinity on `/s/*` MCP + relay WS or players split across workers (`match_not_found`).\n• **Script-only co-op (Nahual nhl.*):** guest `script.run` on `public_run` exports — no `rooms.*` unless the cookbook adds qm:; hosted opens use NeuralCache runtime L1 (`timings.neural_defer=true`, `dna_persisted=false` until flush) — see `stackscript` plane_chooser / `docs_nav` gene `core.stackscript.mp1646.gen1`. Concurrent opens queue per-project defer plus per-match advisory (`runtime match_id` or `input.advisory_scope` / `coop_advisory_scope`).\n• **Custom host lobby:** `rooms.create` + `rooms.join_by_code` (signed-in host).\nRuntime routing: `agentstack.execute` / `discovery.describe` — not `docs_nav.search` for tools.", "related_tools": ["stream.relay.ws_ticket", "stream.relay.list_rooms"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "stream_relay_create_room", "semantic_input_mode": "inherit_workflow", "summary": "Create a stream relay room (DNA ecosystem.stream_relay.rooms) for multiplayer hosts.", "title": "Stream Relay Create Room", "when_blocked": {"execution_error": "stream.relay.list_rooms", "invalid_parameters": "room_id + authenticated user", "room_create_failed": "Retry or stream.relay.list_rooms for collisions", "unauthorized": "auth.get_profile"}, "when_not_to_use": "Not for quick_match netplay — rooms.quick_match creates qm: rooms.", "when_to_use": "Persist relay room for StackScript room.host — then stream.relay.ws_ticket.", "write_mode": null}], "system": [{"action": "system.ping", "aliases": ["discovery.health"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "system", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.system.gen1"], "id": "system.ping", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "System Ping"}, "domain_title": "System MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "examples": [{"request": {"params": {}, "tool": "system.ping"}, "response": {"pong": true, "status": "ok", "timestamp": "2026-01-01T00:00:00Z"}}], "execution_class": "plain_read", "genetic_tags": ["core.mcp.system.gen1"], "instruction_hint": "Use to verify MCP server connectivity.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.system", "owner_gene": "core.mcp.system.gen1", "requires_preflight": false, "risk_class": "read", "safe_action": "system_ping", "semantic_input_mode": "inherit_workflow", "summary": "Health check tool — always succeeds, no authentication required.", "title": "System Ping", "when_to_use": "Use to verify MCP server connectivity.", "write_mode": null}, {"action": "system.version", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "system", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.system.gen1"], "id": "system.version", "semantic_input_mode": "inherit_workflow", "source": "live", "title": "System Version"}, "domain_title": "System MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.system.gen1"], "instruction_hint": "Smoke / deploy matrix version probe — same auth as system.ping.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.system", "owner_gene": "core.mcp.system.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "system_version", "semantic_input_mode": "inherit_workflow", "summary": "Platform core version string (deploy probes; prefer over removed legacy aliases).", "title": "System Version", "when_to_use": "Smoke / deploy matrix version probe — same auth as system.ping.", "write_mode": null}], "time": [{"action": "time.log", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "time", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.time.gen1"], "id": "time.log", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Time Log"}, "domain_title": "Time MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.time.gen1"], "instruction_hint": "Record billable or internal minutes on a deal or project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.time", "owner_gene": "core.mcp.time.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "requires_preflight": false, "risk_class": "low_write", "safe_action": "time_log", "semantic_input_mode": "inherit_workflow", "summary": "Log a time entry (minutes) optionally linked to crm_deal.", "title": "Time Log", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Record billable or internal minutes on a deal or project.", "write_mode": null}, {"action": "time.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "time", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.time.gen1"], "id": "time.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Time List"}, "domain_title": "Time MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.time.gen1"], "instruction_hint": "Audit recent time logs before time.report.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.time", "owner_gene": "core.mcp.time.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "requires_preflight": false, "risk_class": "read", "safe_action": "time_list", "semantic_input_mode": "inherit_workflow", "summary": "List recent time entries.", "title": "Time List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit recent time logs before time.report.", "write_mode": null}, {"action": "time.report", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "time", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.time.gen1"], "id": "time.report", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Time Report"}, "domain_title": "Time MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.time.gen1"], "instruction_hint": "Summarize billable minutes for invoicing or goals.progress.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.time", "owner_gene": "core.mcp.time.gen1", "plane": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "plane_chooser": "Calendar: calendar.events. Time: time.list. Goals: goals.list. Books: finance.expense.list on money.expenses.", "requires_preflight": false, "risk_class": "read", "safe_action": "time_report", "semantic_input_mode": "inherit_workflow", "summary": "Aggregate time report for project.", "title": "Time Report", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Summarize billable minutes for invoicing or goals.progress.", "write_mode": null}], "trust": [{"action": "trust.check", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "agents", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.agentnet.erc8004.gen1"], "id": "trust.check", "related_tools": ["trust.feedback", "agents.fleet_diagnostics"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Trust Check"}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"invalid_parameters": "project_id and agent_id required", "not_found": "agent not found in project fleet", "trust_surface_unavailable": "trust rollup unavailable"}, "examples": [{"name": "Fleet agent trust rollup", "request": {"params": {"agent_id": "agent-uuid-example", "project_id": 1}, "tool": "trust.check"}, "response": {"data": {"trust_surface": {"agent_id": "agent-uuid-example"}}, "success": true}}], "execution_class": "plain_read", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Read-only trust summary before high-risk fleet or external agent handoff.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["trust.feedback", "agents.fleet_diagnostics"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "trust_check", "semantic_input_mode": "inherit_workflow", "summary": "Read-only agent trust surface (metrics + optional ERC-8004 reputation rollup).", "title": "Trust Check", "when_blocked": {"invalid_parameters": "project_id and agent_id required", "not_found": "agent not found in project fleet", "trust_surface_unavailable": "trust rollup unavailable"}, "when_to_use": "Read-only trust summary before high-risk fleet or external agent handoff.", "write_mode": null}, {"action": "trust.feedback", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.agentnet.erc8004.gen1"], "id": "trust.feedback", "related_tools": ["trust.check"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Trust Feedback"}, "domain_title": "Diagnostics MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"invalid_parameters": "agent_on_chain_id and score required", "service_cap_denied": "mcp_write cap required", "trust_feedback_failed": "feedback persistence failed", "unauthorized": "session required"}, "examples": [{"name": "Post-run reputation feedback", "request": {"params": {"agent_on_chain_id": 42, "receipt_hash": "0xabc", "score": 85}, "tool": "trust.feedback"}, "response": {"data": {"average_score": 85.0, "feedback_count": 1}, "success": true}}], "execution_class": "cheap", "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Structured operator feedback into trust registry (advisory; RBAC required).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_work_graph", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_tenant_business_assistant"], "related_tools": ["trust.check"], "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "trust_feedback", "semantic_input_mode": "inherit_workflow", "summary": "Record L0 reputation feedback for an on-chain agent id (sybil: one row per receipt).", "title": "Trust Feedback", "when_blocked": {"invalid_parameters": "agent_on_chain_id and score required", "service_cap_denied": "mcp_write cap required", "trust_feedback_failed": "feedback persistence failed", "unauthorized": "session required"}, "when_to_use": "Structured operator feedback into trust registry (advisory; RBAC required).", "write_mode": null}], "user": [{"action": "user.apikeys.create", "aliases": ["apikeys.create_user"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "user.apikeys.create", "mutation_risk": "low", "related_tools": ["user.apikeys.list", "user.apikeys.revoke", "apikeys.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "User Apikeys Create"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"limit_exceeded": "max_user_api_keys", "project_required": "agent PAT needs project_id", "unauthorized": "No user on the credential"}, "execution_class": "cheap", "instruction_hint": "Mint a user or agent PAT for REST/MCP. Prefer agent + agent_runner for Cursor.", "mutation_kind": "entity", "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "related_tools": ["user.apikeys.list", "user.apikeys.revoke", "apikeys.create"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "user_apikeys_create", "semantic_input_mode": "inherit_workflow", "summary": "Create a personal AgentStack PAT on the signed-in user (ecosystem identity).", "title": "User Apikeys Create", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "limit_exceeded": "max_user_api_keys", "project_required": "agent PAT needs project_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user on the credential", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Mint a user or agent PAT for REST/MCP. Prefer agent + agent_runner for Cursor.", "write_mode": null}, {"action": "user.apikeys.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.auth.hub.gen1"], "id": "user.apikeys.list", "related_tools": ["user.apikeys.create", "user.apikeys.revoke"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "User Apikeys List"}, "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"unauthorized": "No user on the credential"}, "execution_class": "plain_read", "instruction_hint": "Audit personal and agent PATs.", "mutation_kind": "none", "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "related_tools": ["user.apikeys.create", "user.apikeys.revoke"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "user_apikeys_list", "semantic_input_mode": "inherit_workflow", "summary": "List personal PATs (metadata only). Optional project_id filters agent keys scoped to that project.", "title": "User Apikeys List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user on the credential", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Audit personal and agent PATs.", "write_mode": null}, {"action": "user.apikeys.revoke", "aliases": ["user.apikeys.delete"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "user.apikeys.revoke", "mutation_risk": "high", "related_tools": ["user.apikeys.create", "user.apikeys.list"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "User Apikeys Revoke"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "errors": {"key_not_found": "Unknown key_id", "unauthorized": "No user"}, "execution_class": "cheap", "instruction_hint": "Revoke a leaked or unused PAT.", "mutation_kind": "entity", "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_tools": ["user.apikeys.create", "user.apikeys.list"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "user_apikeys_revoke", "semantic_input_mode": "inherit_workflow", "summary": "Revoke (soft-delete) a personal PAT by key_id.", "title": "User Apikeys Revoke", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_not_found": "Unknown key_id", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Revoke a leaked or unused PAT.", "write_mode": null}, {"action": "user.apikeys.rotate", "aliases": ["apikeys.rotate"], "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.auth.hub.gen1"], "id": "user.apikeys.rotate", "related_tools": ["user.apikeys.create", "user.apikeys.revoke"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "User Apikeys Rotate"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "errors": {"key_not_found": "Unknown key_id", "unauthorized": "No user"}, "execution_class": "cheap", "instruction_hint": "Rotate a PAT without changing scope/caps.", "mutation_kind": "none", "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "related_tools": ["user.apikeys.create", "user.apikeys.revoke"], "required_cap": "project_admin", "requires_preflight": true, "risk_class": "destructive", "safe_action": "user_apikeys_rotate", "semantic_input_mode": "inherit_workflow", "summary": "Rotate a personal PAT; returns a new secret once.", "title": "User Apikeys Rotate", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_not_found": "Unknown key_id", "preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps).", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rotate a PAT without changing scope/caps.", "write_mode": null}, {"action": "user.apikeys.update", "aliases": ["apikeys.update"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.user.gen1"], "id": "user.apikeys.update", "related_tools": ["user.apikeys.list", "user.apikeys.rotate"], "semantic_input_mode": "inherit_workflow", "source": "live", "title": "User Apikeys Update"}, "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"key_not_found": "Unknown key_id", "unauthorized": "No user"}, "execution_class": "cheap", "instruction_hint": "Rename or deactivate a PAT without rotating the secret.", "mutation_kind": "entity", "plane": "Keys: apikeys.create with service_caps (null caps are rejected in prod). List: apikeys.list.", "plane_chooser": "Programmatic access: apikeys.create with explicit service_caps (null rejected in prod). Bearer operator session skips key creation. Revoke: apikeys.delete. List: apikeys.list.", "related_tools": ["user.apikeys.list", "user.apikeys.rotate"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "user_apikeys_update", "semantic_input_mode": "inherit_workflow", "summary": "Update PAT metadata (name and/or status). Caps change requires rotate or create.", "title": "User Apikeys Update", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "key_not_found": "Unknown key_id", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "No user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Rename or deactivate a PAT without rotating the secret.", "write_mode": null}], "vertical_demo": [{"action": "vertical_demo.seed_plan", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "vertical_demo", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "id": "vertical_demo.seed_plan", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vertical Demo Seed Plan"}, "domain_title": "Vertical Demo MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "instruction_hint": "Preview demo CRM/expense seed before vertical_demo.seed_apply.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vertical_demo", "owner_gene": "core.mcp.vertical_demo.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "vertical_demo_seed_plan", "semantic_input_mode": "inherit_workflow", "summary": "Dry-run demo seed for vertical workspace.", "title": "Vertical Demo Seed Plan", "when_to_use": "Preview demo CRM/expense seed before vertical_demo.seed_apply.", "write_mode": null}, {"action": "vertical_demo.seed_apply", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "vertical_demo", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "id": "vertical_demo.seed_apply", "mutation_risk": "low", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vertical Demo Seed Apply"}, "domain_title": "Vertical Demo MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "instruction_hint": "Populate showcase demo data after vertical_demo.seed_plan.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vertical_demo", "owner_gene": "core.mcp.vertical_demo.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "vertical_demo_seed_apply", "semantic_input_mode": "inherit_workflow", "summary": "Apply demo CRM deals, contacts, expenses, goals.", "title": "Vertical Demo Seed Apply", "when_to_use": "Populate showcase demo data after vertical_demo.seed_plan.", "write_mode": null}, {"action": "vertical_demo.seed_clear", "annotations": {"destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "vertical_demo", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "id": "vertical_demo.seed_clear", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vertical Demo Seed Clear"}, "domain_title": "Vertical Demo MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "destructive", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "destructive", "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "instruction_hint": "Reset demo seed data before re-applying vertical_demo.seed_apply.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vertical_demo", "owner_gene": "core.mcp.vertical_demo.gen1", "platform_atoms": {"PREFLIGHT_BEFORE_MUTATE": "Effect medium+ or financial/destructive: run preflight.check with context.project_id bound before mutate. session_ready and service_caps surface in preflight — not retry loops."}, "preflight_action": "preflight.check", "required_cap": "mcp_read", "requires_preflight": true, "risk_class": "destructive", "safe_action": "vertical_demo_seed_clear", "semantic_input_mode": "inherit_workflow", "summary": "Remove demo-tagged entities.", "title": "Vertical Demo Seed Clear", "when_blocked": {"preflight_blocked": "See blockers[] — supply, RBAC, or FAP denied.", "service_cap_denied": "API key service cap — apikeys.create (full_project) or OAuth reconnect. Owner/admin on execute project_id may get automatic L1 widen — verify auth.get_profile credential_plane (key_preview, granted_service_caps)."}, "when_to_use": "Reset demo seed data before re-applying vertical_demo.seed_apply.", "write_mode": null}, {"action": "vertical_demo.repair_due_dates", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "vertical_demo", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "id": "vertical_demo.repair_due_dates", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vertical Demo Repair Due Dates"}, "domain_title": "Vertical Demo MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "instruction_hint": "Heal hosted vertical dashboard when projects exist but due-soon is empty.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vertical_demo", "owner_gene": "core.mcp.vertical_demo.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "low_write", "safe_action": "vertical_demo_repair_due_dates", "semantic_input_mode": "inherit_workflow", "summary": "Set stage-based due_at on CRM deals missing a deadline (idempotent).", "title": "Vertical Demo Repair Due Dates", "when_to_use": "Heal hosted vertical dashboard when projects exist but due-soon is empty.", "write_mode": null}], "vertical_workspace": [{"action": "vertical_workspace.bootstrap", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "vertical_workspace", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_workspace.gen1"], "id": "vertical_workspace.bootstrap", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vertical Workspace Bootstrap"}, "domain_title": "Vertical Workspace MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.mcp.vertical_workspace.gen1"], "instruction_hint": "One-shot freelancer ops setup right after project create.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vertical_workspace", "owner_gene": "core.mcp.vertical_workspace.gen1", "related_prompts": ["agentstack_hosted_vertical"], "required_cap": "project_admin", "requires_preflight": false, "risk_class": "low_write", "safe_action": "vertical_workspace_bootstrap", "semantic_input_mode": "inherit_workflow", "summary": "Bootstrap vertical workspace after register: CRM pipeline preset, persona leaf, freelancer logic templates (idempotent).", "title": "Vertical Workspace Bootstrap", "when_to_use": "One-shot freelancer ops setup right after project create.", "write_mode": null}], "vision": [{"action": "vision.inspect", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "vision", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.vision.domain.gen1"], "id": "vision.inspect", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vision Inspect"}, "domain_title": "Vision MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"https_fetch_disabled": "Enable project policy allow_https or use storage.upload + vision.inspect source=storage.", "ssrf_blocked": "Private/metadata hosts blocked — use storage blob or approved CDN URL.", "storage_id_required": "Pass storage_id from storage.upload — no raw file:// paths.", "vision_worker_unavailable": "Start vision-worker profile or set VISION_INLINE_STUB=1 for stub metrics."}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.vision.gen1", "core.vision.domain.gen1"], "instruction_hint": "OpenCV-style metrics for one image; prefer storage.upload blob over raw URL.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vision", "owner_gene": "core.mcp.vision.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "vision_inspect", "semantic_input_mode": "inherit_workflow", "summary": "Inspect one image (metrics envelope). storage_id preferred over https.", "title": "Vision Inspect", "when_blocked": {"https_fetch_disabled": "Enable project policy allow_https or use storage.upload + vision.inspect source=storage.", "ssrf_blocked": "Private/metadata hosts blocked — use storage blob or approved CDN URL.", "storage_id_required": "Pass storage_id from storage.upload — no raw file:// paths.", "vision_worker_unavailable": "Start vision-worker profile or set VISION_INLINE_STUB=1 for stub metrics."}, "when_to_use": "OpenCV-style metrics for one image; prefer storage.upload blob over raw URL.", "write_mode": null}, {"action": "vision.extract", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "vision", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.vision.domain.gen1"], "id": "vision.extract", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vision Extract"}, "domain_title": "Vision MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"trace_not_found": "Run vision.inspect or vision.pipeline.run first — trace_id expires with worker memory."}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.vision.gen1", "core.vision.domain.gen1"], "instruction_hint": "Run after vision.inspect; dry_run before live.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vision", "owner_gene": "core.mcp.vision.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "vision_extract", "semantic_input_mode": "inherit_workflow", "summary": "Extract structured fields (product_photo.v1) from an inspected asset.", "title": "Vision Extract", "when_blocked": {"trace_not_found": "Run vision.inspect or vision.pipeline.run first — trace_id expires with worker memory."}, "when_to_use": "Run after vision.inspect; dry_run before live.", "write_mode": null}, {"action": "vision.trace.get", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "vision", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.vision.domain.gen1"], "id": "vision.trace.get", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vision Trace Get"}, "domain_title": "Vision MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "errors": {"trace_not_found": "Run vision.inspect or vision.pipeline.run first — trace_id expires with worker memory."}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.vision.gen1", "core.vision.domain.gen1"], "instruction_hint": "Fetch trace steps + decisions for a pipeline run.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vision", "owner_gene": "core.mcp.vision.gen1", "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "vision_trace_get", "semantic_input_mode": "inherit_workflow", "summary": "Return vision pipeline trace steps.", "title": "Vision Trace Get", "when_blocked": {"trace_not_found": "Run vision.inspect or vision.pipeline.run first — trace_id expires with worker memory."}, "when_to_use": "Fetch trace steps + decisions for a pipeline run.", "write_mode": null}, {"action": "vision.pipeline.run", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "vision", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.vision.domain.gen1"], "id": "vision.pipeline.run", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vision Pipeline Run"}, "domain_title": "Vision MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"storage_id_required": "Pass storage_id from storage.upload — no raw file:// paths.", "vision_worker_unavailable": "Start vision-worker profile or set VISION_INLINE_STUB=1 for stub metrics."}, "execution_class": "cheap", "genetic_tags": ["core.mcp.vision.gen1", "core.vision.domain.gen1"], "instruction_hint": "Always dry_run=true before billing live perceive steps.", "kind": "mcp_domain", "mutation_kind": "entity", "next_actions": ["vision.trace.get", "vision.inspect"], "onboarding_tier": "domain_playbook", "organ_id": "mcp.vision", "owner_gene": "core.mcp.vision.gen1", "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "vision_pipeline_run", "semantic_input_mode": "inherit_workflow", "summary": "Run a named vision pipeline (dry_run recommended).", "title": "Vision Pipeline Run", "when_blocked": {"storage_id_required": "Pass storage_id from storage.upload — no raw file:// paths.", "vision_worker_unavailable": "Start vision-worker profile or set VISION_INLINE_STUB=1 for stub metrics."}, "when_to_use": "Always dry_run=true before billing live perceive steps.", "write_mode": null}, {"action": "vision.ask", "ai_tips": "Human-in-the-loop question — delivers notification (mutate, not read-only). Pair with agents.approve_run when gated.", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "vision", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.vision.domain.gen1"], "id": "vision.ask", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Vision Ask"}, "domain_title": "Vision MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "errors": {"auth_required": "Operator Bearer session required before vision.ask can notify.", "channel_not_linked": "Target user has no linked bot channel — use in_app or enroll via bots.go_live.", "invalid_parameters": "question and project_id are required; use dry_run to preview deliver eligibility.", "operator_notify_failed": "notifications.deliver failed — check projects.get_notify_policy and channel prefs."}, "execution_class": "cheap", "genetic_tags": ["core.mcp.vision.gen1", "core.vision.domain.gen1"], "instruction_hint": "Delivers operator notification — not read-only; pair with agents.approve_run when gated.", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vision", "owner_gene": "core.mcp.vision.gen1", "required_cap": "mcp_write", "requires_preflight": false, "risk_class": "low_write", "safe_action": "vision_ask", "semantic_input_mode": "inherit_workflow", "summary": "Ask human operator a vision question (notification + optional agents.approve_run).", "title": "Vision Ask", "when_blocked": {"auth_required": "Operator Bearer session required before vision.ask can notify.", "channel_not_linked": "Target user has no linked bot channel — use in_app or enroll via bots.go_live.", "invalid_parameters": "question and project_id are required; use dry_run to preview deliver eligibility.", "operator_notify_failed": "notifications.deliver failed — check projects.get_notify_policy and channel prefs."}, "when_to_use": "Delivers operator notification — not read-only; pair with agents.approve_run when gated.", "write_mode": null}], "wallets": [{"action": "wallets.balance", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.balance", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Balance"}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Player soft-currency balances (commerce_iap ledger), not AgentPay wallets.list. Hosted: prefer GET …", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "wallets_balance", "semantic_input_mode": "inherit_workflow", "summary": "Player soft-currency balances (commerce_iap ledger), not AgentPay wallets.list. Hosted: prefer GET /api/commerce/iap/balances or sdk getBalances.", "title": "Wallets Balance", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Player soft-currency balances (commerce_iap ledger), not AgentPay wallets.list. Hosted: prefer GET /api/commerce/iap/balances or sdk getBalances.", "write_mode": null}, {"action": "wallets.ledger.list", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.ledger.list", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Ledger List"}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Append-only IAP ledger entries for the signed-in player. Hosted: GET /api/commerce/iap/ledger or sd…", "kind": "mcp_domain", "mutation_kind": "none", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "wallets_ledger_list", "semantic_input_mode": "inherit_workflow", "summary": "Append-only IAP ledger entries for the signed-in player. Hosted: GET /api/commerce/iap/ledger or sdk listIapLedger.", "title": "Wallets Ledger List", "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden": "Own player scope only — omit user_id on hosted; orders list is shop.orders.list.", "forbidden_cross_user": "Hosted session: omit user_id — ledger uses the signed-in player only.", "forbidden_operator_user_id": "Omit user_id to read your own IAP ledger on MCP, or add project_admin to service_caps to read another player's ledger.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Append-only IAP ledger entries for the signed-in player. Hosted: GET /api/commerce/iap/ledger or sdk listIapLedger.", "write_mode": null}, {"action": "wallets.spend", "ai_tips": "Spend at configured sink; idempotency_key required. Hosted: POST /api/commerce/iap/spend or sdk spendAtIapSink.", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.spend", "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Spend"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "example_params": {"idempotency_key": "example_string", "project_id": 123, "sink_id": "example_string"}, "example_request": {"action": "wallets.spend", "params": {"idempotency_key": "example_string", "project_id": 123, "sink_id": "example_string"}}, "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1", "core.commerce.tenant_iap_shop.gen1", "core.commerce.tenant_iap.gen1", "sdk.commerce.hosted.gen1"], "instruction_hint": "Spend at configured sink; idempotency_key required. Hosted: POST /api/commerce/iap/spend or sdk spe…", "kind": "mcp_domain", "mutation_kind": "body", "navigation_hints": {"plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…"}, "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Hosted game IAP: shop.products.list → shop.checkout.create (server price). Visitors must not call p…", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "rollback": [], "safe_action": "wallets_spend", "semantic_input_mode": "inherit_workflow", "summary": "Spend at configured sink; idempotency_key required. Hosted: POST /api/commerce/iap/spend or sdk spendAtIapSink.", "title": "Wallets Spend", "verification": ["wallets.balance", "wallets.ledger.list"], "verify": [{"action": "wallets.balance", "predicate": "named resource is visible"}, {"action": "wallets.ledger.list", "predicate": "named resource is visible"}], "when_blocked": {"auth_required": "POST /api/auth/anonymous/provision then Bearer; BFF and MCP share auth.", "context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "idempotency_key_required": "Generate stable UUID per checkout or spend attempt.", "insufficient_funds": "Player balance too low for sink cost.", "invalid_debit": "Ledger debit vector invalid for sink — owner shop.sinks.upsert.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "project_scope_mismatch": "Hosted cookie project_id must match params.project_id.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "sell_disabled": "Live checkout off — add IAP SKU (shop.products.upsert), clear sell_enabled:false, or enable commerce_iap/ladder.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "sink_mismatch": "Idempotency key was already used for a different sink_id — use a new key.", "sink_not_found": "Owner defines sink via shop.sinks.upsert.", "spend_partial_state": "Prior spend left partial debits — ops reconcile before retry.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_sync_failed": "Ledger debited; wallet sync failed — retry or ops reconcile (compensating entry).", "wallet_withdraw_failed": "Transient ledger error — retry spend with same idempotency_key."}, "when_to_use": "Spend at configured sink; idempotency_key required. Hosted: POST /api/commerce/iap/spend or sdk spendAtIapSink.", "write_mode": null}, {"action": "wallets.list", "aliases": ["wallets.get"], "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.list", "related_tools": ["wallets.create", "payments.get_balance", "wallets.deposit", "wallets.transfer"], "semantic_input_mode": "inherit_workflow", "source": "handler", "title": "Wallets List"}, "domain_title": "Shop MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "example_params": {"project_id": 123, "user_id": 123}, "example_request": {"action": "wallets.list", "params": {"project_id": 123, "user_id": 123}}, "execution_class": "plain_read", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Enumerate wallets before deposit, transfer, or balance check.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["wallets.create", "payments.get_balance", "wallets.deposit", "wallets.transfer"], "required_cap": "payments", "requires_preflight": false, "risk_class": "read", "safe_action": "wallets_list", "semantic_input_mode": "inherit_workflow", "summary": "List wallets for a project (and optionally user).", "title": "Wallets List", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "wallets.list — project_id, currency, and wallet_id params required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_service_unavailable": "Backoff then retry; agentstack_diagnose if it persists"}, "when_to_use": "Enumerate wallets before deposit, transfer, or balance check.", "write_mode": null}, {"action": "wallets.create", "aliases": ["wallets.create_wallet", "wallets.ensure", "wallets.update_wallet"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.create", "mutation_risk": "low", "related_tools": ["wallets.list", "wallets.deposit", "payments.get_balance"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Create"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Provision a wallet before deposit or transfer. A personal USD/USDT wallet is project 1. A tenant pr…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["wallets.list", "wallets.deposit", "payments.get_balance"], "required_cap": "payments", "requires_preflight": false, "risk_class": "low_write", "safe_action": "wallets_create", "semantic_input_mode": "inherit_workflow", "summary": "Create a wallet for a project or user.", "title": "Wallets Create", "tool_chains": ["project_bootstrap", "economy_setup", "economy_setup"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "wallets.list — project_id, currency, and wallet_id params required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_service_unavailable": "Backoff then retry; agentstack_diagnose if it persists"}, "when_to_use": "Provision a wallet before deposit or transfer. A personal USD/USDT wallet is project 1. A tenant project wallet is custom currency only. Real money does not sit on tenant data.money.", "write_mode": null}, {"action": "wallets.deposit", "aliases": ["wallets.top_up"], "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.deposit", "mutation_risk": "low", "related_tools": ["wallets.list", "payments.get_balance", "wallets.transfer"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Deposit"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Credit a wallet. Virtual balances stay on the project. USD and USDT credit a personal wallet on pro…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["wallets.list", "payments.get_balance", "wallets.transfer"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "safe_action": "wallets_deposit", "semantic_input_mode": "inherit_workflow", "summary": "Deposit funds to a wallet.", "title": "Wallets Deposit", "tool_chains": ["project_bootstrap", "economy_setup"], "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "forbidden_for_visitor": "Hosted visitor cookie — use shop.checkout.create, not wallets.deposit", "idempotency_key_required": "Pass idempotency_key on every wallets.deposit (replay-safe)", "invalid_amount": "amount must be positive — wallets.list for balance first", "invalid_parameters": "wallets.list — project_id, currency, and wallet_id params required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_not_found": "wallets.list — wallet_id before deposit; wallets.create if none", "wallet_service_unavailable": "Backoff then retry; agentstack_diagnose if it persists"}, "when_to_use": "Credit a wallet. Virtual balances stay on the project. USD and USDT credit a personal wallet on project 1, or the project treasury wallet (data.ecosystem.money, origin treasury). They never land on te", "write_mode": null}, {"action": "wallets.transfer", "annotations": {"destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false}, "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "effect": {"audit_batch_allowed": false, "audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "execution_class": "cheap", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.transfer", "mutation_risk": "low", "related_tools": ["wallets.list", "payments.get_balance", "payments.create"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Wallets Transfer"}, "domain_title": "Shop MCP domain", "effect": {"execution_class": "cheap", "generation": false, "kind": "mutate", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "mutate", "execution_class": "cheap", "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Move a balance between two wallets. Virtual currency stays on the project. USD and USDT move only o…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.shop", "owner_gene": "core.commerce.marketplace.gen1", "plane": "Money: payments.get_balance and wallets.list. Checkout is AgentPay. Tenant subscription: webhook/C24 auto-grant after payments.create — not buffs.apply_buff.", "plane_chooser": "Money: payments.get_balance and wallets.list. Hosted tenant IAP: shop.checkout.create (server SKU price) — not bare payments.create currency_pack. AgentPay treasury/card: payments.create → payments.get. Catalog: assets.list → assets.create — do not replace data.assets.items[]. Tier gates: buffs.get_effective_limits before retrying checkout.", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["wallets.list", "payments.get_balance", "payments.create"], "required_cap": "payments", "requires_preflight": true, "risk_class": "financial", "safe_action": "wallets_transfer", "semantic_input_mode": "inherit_workflow", "summary": "Transfer funds between wallets (same project).", "title": "Wallets Transfer", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "invalid_parameters": "wallets.list — project_id, currency, and wallet_id params required", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project.", "wallet_service_unavailable": "Backoff then retry; agentstack_diagnose if it persists"}, "when_to_use": "Move a balance between two wallets. Virtual currency stays on the project. USD and USDT move only on project 1, or between treasury wallets on the same project. A tenant to_wallet_id for those codes m", "write_mode": null}], "web_push": [{"action": "web_push.get_health", "annotations": {"destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true}, "capability_descriptor": {"complexity": "simple", "domain": "notifications", "effect": {"audit_batch_allowed": true, "audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "plain_read", "external_side_effect": false, "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "web_push.get_health", "related_tools": ["notifications.subscribe_push", "notifications.send_push", "notifications.cancel_push", "notifications.list_prefs"], "semantic_input_mode": "inherit_workflow", "source": "overlay", "title": "Web Push Get Health"}, "domain_title": "Notifications MCP domain", "effect": {"audit_batch_allowed": true, "execution_class": "plain_read", "generation": false, "kind": "read", "semantic_input_mode": "inherit_workflow"}, "effect_kind": "read", "execution_class": "plain_read", "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Per-user Web Push VAPID + delivery readiness.", "kind": "mcp_domain", "mutation_kind": "none", "notify_channels": [{"action": "bots.list", "id": "fleet", "tip": "List project bots. A channel with no connection cannot deliver. Attach with bots.attach_channel kind=telegram|max|whatsapp|instagram|slack|discord|sms."}, {"action": "bots.go_live", "id": "live", "tip": "go_live registers the channel webhook. Inbound user messages arrive there. Preview a reply with bots.simulate. Do not poll a second inbox for the bot."}, {"action": "notifications.list_prefs", "id": "link", "tip": "The user must open that bot and run /login so channel identity is stored. Without external_user_id, deliver returns no_channel_target. Prefs can turn a channel off."}, {"action": "projects.get_notify_policy", "id": "project_policy", "tip": "Project-level Resend/SMTP and mandatory categories before bulk email. Patch with projects.put_notify_policy or projects.patch_data under config.notifications.* — not notifications.list_prefs."}, {"action": "notifications.deliver", "id": "send", "tip": "One call, explicit channels: email, push, in_app, webhook, telegram, max, whatsapp, instagram, slack, discord, sms, or bot. OS-only push remains notifications.send_push. Admin SMTP test remains messaging.send_email. User @agentstack.tech mailbox: messaging.inbox.reply / messaging.mail.send — not this action."}, {"action": "notifications.inbox_list", "id": "inbox", "tip": "In-app copies of notices. Bot transcripts stay on the bot conversation."}], "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "owner_gene": "core.mcp.notifications.gen1", "plane": "OS push: notifications.send_push. Email and bots: notifications.deliver.", "plane_chooser": "Channels: email, telegram, max, whatsapp, instagram. User /login in the bot first. Personal @agentstack.tech mail: messaging.mailbox.claim → inbox.list/get → inbox.reply or mail.send — not notifications.deliver.", "recipe_id": "mcp_notify_channels_v1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.subscribe_push", "notifications.send_push", "notifications.cancel_push", "notifications.list_prefs"], "required_cap": "mcp_read", "requires_preflight": false, "risk_class": "read", "safe_action": "web_push_get_health", "semantic_input_mode": "inherit_workflow", "summary": "Per-user Web Push health (same payload as GET /api/push/health): VAPID, canDeliver, subscription/outbox counts, process-local worker stats.", "title": "Web Push Get Health", "when_blocked": {"context_project_override_denied": "context.project_id targets a project your Bearer cannot override — use auth.switch_project + membership, or apikeys with cross_project for ecosystem ops.", "jwt_misaligned_ok": "jwt_project_aligned=false is normal for user-scoped OAuth when context.project_id is your tenant and mutation_allowed=true — continue; do not switch_project.", "jwt_project_mismatch": "Bearer JWT project differs from context.project_id for writes — switch + apply Bearer.", "scope_leak_denied": "Step params.project_id does not match options.context.project_id — align before mutate.", "session_setup_required": "Bind context.project_id first — recipe mcp_session_setup or agentstack_session_setup prompt.", "unauthorized": "auth.get_profile — push health is per signed-in user", "use_context_not_switch": "session_ready with a different execute_context_project_id — set context.project_id and rerun preflight; do not loop auth.switch_project."}, "when_to_use": "Per-user Web Push VAPID + delivery readiness.", "write_mode": null}]}, "entrypoint": "agentstack.execute", "execute_budget": {"agents_run_wait_is_heavy": true, "async": {"enable": "options.async=true", "lease_ms": 1200000, "poll_action": "discovery.job_status", "poll_rest": "GET /mcp/jobs/{job_id}"}, "control_plane_actions": ["agents.plan_claim", "agents.plan_get", "agents.plan_patch", "agents.work_next", "auth.get_profile", "discovery.describe", "preflight.check"], "cpu_heavy_actions": ["agents.graph_health", "agents.plan_apply_proposal", "agents.plan_execute", "agents.plan_process_backlog", "agents.plan_propose", "agents.plan_recovery_scan", "context.get", "diagnostics.consistency.scan", "generation.diff", "generation.diff_vs_prod", "generation.gates", "genetic.reindex", "projects.limits.get", "projects.readiness.get", "script.put", "script.recompile_version", "showcase.arcanestack.ensure_rules", "showcase.build.republish_entry"], "heavy_actions": ["bots.simulate", "commerce.ai.generate_products", "commerce.ai.magic_fill", "knowledge.playground"], "heavy_prefixes": ["ai_builder.generate"], "max_steps": 50, "max_sync_heavy_actions": 1, "packs": {"batch.v1": {"schema_keys": ["recipe_id", "recipe_params", "goal", "goal_text", "focus_node_id", "plan_execute_mode", "routed_goal", "semantic_strict", "observed", "density", "workflow_run_id", "enforce_approval", "async", "stopOnError", "continueOnError", "executionMode", "idempotency_key", "envelope", "instruction_hash"], "step_idempotency_note": "Per-step idempotency_key defaults to {batch idempotency_key}:{step_id} when batch-level idempotency_key is set (replay-safe retries).", "step_schema_keys": ["dependsOn", "depends_on", "if", "idempotency_key"], "wire_only_in_catalog": ["semantic_contract", "publish_asked"]}, "result.v1": {"hoist_note": "Workflow fields hoist to JSON-RPC structuredContent (parity with jsonrpc_handler._EXECUTE_INVERSE_FIELD_KEYS).", "schema_keys": ["ok", "data", "error_code", "message", "recovery", "execution_mode", "job_id", "poll", "agent_os", "observed", "goal_verification", "workflow_completion", "workflow_run_id", "workflow_state_key", "instruction_packet", "next_step", "inverse_resume", "workflow_diagnostics", "completion"]}, "session.v1": {"defaults": {"options.envelope": "compact", "options.stopOnError": true}, "note": "Locale and user_id come from the session; do not invent user_id.", "passthrough_context": ["generation_env_uuid", "generation_calver_label", "sandbox_generation", "traffic_weight", "flow_id", "locale", "client_locale"], "required_wire": ["context.project_id"]}, "version": 1}, "rule": "One expensive action per sync agentstack.execute (LLM-heavy or CPU-heavy: plan_propose, plan_apply_proposal, plan_recovery_scan, context.get, generation.diff_vs_prod, generation.gates, generation.diff). Cheap spine steps agents.work_next and agents.plan_get may share the 120s mcp_batch; agents.plan_claim and work_next(claim=true) need mcp_write. Do not pack six bots.simulate into one execute.", "single_heavy_lane": "ai_stream", "single_heavy_lane_ms": 180000, "single_heavy_timeout_ms": 180000, "sync_lane": "mcp_batch", "sync_lane_ms": 120000, "timeout_ms": 120000}, "mcp_executable_total": 1025, "principal_visible_total": 982, "public_total": 903, "registry_public_doc_total": 903, "registry_revision": "268207e20a900ad5", "registry_total": 1025, "rest_catalog_total": 59, "schemas_mode": "none", "total_actions": 1041, "version": "2.0", "write_modes": {"directed_ops": {"dry_run": "Preview without DNA write (returns leaf_sha256).", "expected_sha256": "Optimistic concurrency on the leaf before ops.", "max_ops": 16, "missing": "error | skip when anchor/replacement misses.", "op_kinds": ["append", "delete", "fuzzy_replace", "insert_after", "insert_at", "insert_before", "merge", "move", "prepend", "replace", "search_replace", "set", "unified_diff", "upsert"], "param": "ops", "tools": ["projects.patch_data", "projects.patch_my_data"]}, "doc": "agentstack-core/mcp/WRITE_MODES.md", "errors": {"ambiguous_anchor": "Multiple matches; narrow find, set count, or use json_view text window.", "anchor_not_found": "where/find did not match any list row or substring.", "commands_empty_blocked": "Refusing to wipe bot_spec.commands to [].", "content_shrink_blocked": "New KB body is much shorter than the indexed doc; pass allow_shrink.", "index_out_of_range": "List index or move target is out of range for the leaf.", "leaf_path_invalid": "Bracket paths do not support ops; use dot paths or write_mode replace.", "metadata_patch_failed": "KB body persisted but RAG metadata update failed.", "patch_apply_failed": "unified_diff did not apply, including fuzzy; GET and retry.", "patch_too_large": "unified_diff payload over cap; prefer search_replace.", "plan_ops_text_mode": "Text op needs replacements, find/replace, or unified_diff on the op.", "prompt_shrink_blocked": "New plan_instructions / system_preamble is much shorter than the stored field. GET knowledge.prompt.get and send the full string, or write_mode=append, or allow_shrink=true.", "replacement_not_found": "find is not in the stored text; nothing was written.", "revision_conflict": "expected_sha256 mismatch on hosting.bucket.file.patch — file.get for content_sha256.", "text_anchor_miss": "Fuzzy anchor did not match; narrow find or use json_view window.", "text_revision_conflict": "expected_sha256 mismatch — projects.get_data (or dry_run) then retry with fresh digest.", "use_path_updates": "Partial agent_spec with write_mode=merge requires path_updates.", "write_mode_invalid": "Unknown write_mode token.", "write_mode_unsupported": "This payload cannot use that mode (e.g. merge on markdown body)."}, "modes": {"append": "Document body: concatenate after the existing joined text.", "delete": "Explicit remove of named keys/items (incoming = delete set). A short replace list is never treated as delete.", "merge": "PATCH / protein merge_keyed: overlay by key (trigger, uid). Never drops siblings missing from the payload.", "patch": "Alias of merge (REST PATCH / path_updates / OperationType.DELTA).", "prepend": "Document body: concatenate before the existing joined text.", "replace": "PUT snapshot: incoming list/body is the full new value. Studio command Publish uses this. Empty collection is blocked.", "search_replace": "Preferred text edit. replacements: [{find, replace}] on the stored string. No prior GET when the substring is known. Missing find → replacement_not_found, no write.", "unified_diff": "Unified diff against the stored string. Fuzzy context match (same as App Studio) unless strict_diff=true.", "upsert": "Merge plus insert missing keys. Same as merge for bot commands.", "write": "Alias of replace (full document body)."}, "mutation_kinds": {"body": "Document text: prefer search_replace (find/replace) or unified_diff (fuzzy). append/prepend add. replace is the full body and is shrink-guarded.", "collection": "Keyed list: write_mode merge|upsert|replace|delete.", "entity": "CRUD verb in the action name (.create/.update/.delete). No write_mode.", "none": "Read-only or no collection/body/path payload.", "path": "One PathAtom / DNA leaf: projects.patch_data or path_updates."}, "param": "write_mode", "prompt": "agentstack_write_modes", "protein": {"diff_op_kinds": ["set", "delete", "merge_keyed", "upsert_entity"], "operation_type": ["get", "create", "update", "delete", "delta"]}, "required_when": "Writing a collection (bot commands, keyed lists), a document body (knowledge.content.patch text), or a prompt field (knowledge.prompt.patch plan_instructions / system_preamble). Metadata-only patches may omit it. Path writes use projects.patch_data (REST PATCH /projects/{id}/data).", "rest": {"DELETE": "delete (dedicated route or write_mode=delete)", "If-Match": "lost-update guard (CRM stage, social chat index)", "PATCH": "merge / path_updates / protein DELTA / PATCH /projects/{id}/data", "PUT": "replace snapshot"}, "rule": "Always pass write_mode for collection/body writes. Omitting it infers a safe default (merge a partial command list; replace a KB body or prompt field with a shrink guard). A known phrase is search_replace, not a full replace. Never send one command, one markdown section, or a 7-line plan_instructions stub as a full replace. Nested project.data leaves: projects.patch_data, not projects.update_project.", "text_editor": {"prefer": "search_replace", "prompt": "agentstack_write_modes", "replacements": [{"find": "stored phrase", "replace": "new phrase"}], "tools": {"agents.update": "path_updates leaf value {replacements} or {unified_diff} on a string", "ai_builder.source.patch": "replacements, symbols, or unified diff — one of them", "bots.commands.upsert": "commands[].replacements edits reply_text; buttons stay", "bots.set_brain": "replacements edits fallback_text", "bots.update": "commands[].replacements edits reply_text; agreement.replacements edits body", "hosting.bucket.file.patch": "write_mode=search_replace + replacements", "knowledge.chunk.patch": "chunk doc_id + replacements (full parent doc) or text segment replace", "knowledge.content.patch": "write_mode=search_replace + replacements (or unified_diff)", "knowledge.prompt.patch": "write_mode=search_replace + field=plan_instructions|system_preamble", "logic.update": "replacements + text_field=description|name", "projects.patch_data": "write_mode=search_replace + replacements (or unified_diff); or value={replacements} on the string leaf; or ops[] (≤16) on one path with dry_run / expected_sha256", "projects.patch_my_data": "same as projects.patch_data on member-private slice"}}, "tools": {"agents.plan_archive_branch": "body", "agents.update": "section and path_updates default to merge (objects merge, lists replace). write_mode=replace sets the section or leaf wholesale. A full agent_spec without section/path_updates is a replace. write_mode=merge with only a partial agent_spec is rejected.", "assets.import": "collection", "bots.bus.settings.set": "path", "bots.bus.webhook.disconnect": "path", "bots.commands.upsert": "Always merge-by-trigger; never replaces the menu.", "bots.reply_source.set": "path", "bots.reset_message_quota": "path", "bots.set_brain": "Wire agent/logic/RAG. fallback_text: replacements or unified_diff on the stored line.", "bots.update": "Pass write_mode with commands. Prefer bots.commands.upsert for one command.", "channels.route": "path", "checklist.set": "checklist.set replaces the full items list — write_mode defaults to replace.", "commerce.checkout.session": "body", "docs.schema.define": "path", "docs.schema.delete": "path", "finance.pay.quote": "body", "hosting.bucket.file.get": "Read UTF-8 text + content_sha256 (≤2MB) when you need the bytes. search_replace does not require this first. Use bucket_name or bucket_id (same resolver as hosting.files.put).", "hosting.bucket.file.patch": "search_replace does not need a prior GET. write_mode: replace|append|prepend|unified_diff|search_replace — not storage.upload. dry_run previews; expected_sha256 mismatch → revision_conflict. Omit bucket_id on the primary site. Identical bytes skip the write and gzip. A real change refreshes the .gz sibling. Do not delete it. 8DNA nested config leaves use projects.patch_data ops, not bucket bytes.", "hosting.deploy_files": "Batch publish many paths (≤50/call). Not for single CSS line — use file.patch. After publish poll hosting.site.edge_health.", "hosting.files.put": "Full-file PUT for one path. A small text edit is hosting.bucket.file.patch, not a GET and not dry_run. Not storage.upload — this writes the live site bucket tree.", "knowledge.chunk.patch": "Chunk id from content.get; editor applies to parent document text.", "knowledge.config.patch": "body", "knowledge.content.patch": "text is a full body unless write_mode=append|prepend. GET the document first; shrinking a long body needs allow_shrink=true. SDK Studio sets allow_shrink for operator save — AI must GET first.", "knowledge.policy_templates.apply": "body", "knowledge.prompt.patch": "omit-unset keeps unsent keys only. A sent plan_instructions / system_preamble replaces that entire string. GET first; write_mode=append for a new bullet; search_replace edits field without a full paste; stub replace → prompt_shrink_blocked.", "logic.update": "triggers/space/schedulers are keyed lists: pass write_mode. Prefer path_updates for one node.", "preflight.check": "path", "projects.patch_data": "Leaf path SET (REST PATCH /projects/{id}/data). write_mode=replace sets the path; merge overlays an object; delete removes it. String leaves: search_replace / unified_diff or ops batch on one path. patches[]: sequential leaves; 2+ plain replace SET may use one atomic txn. ops and dry_run apply to one path only.", "projects.patch_my_data": "Member-private leaf SET/merge/delete. Same string editor, ops batch, and dry_run as projects.patch_data (read ladder: projects.get_my_data).", "projects.put_notify_policy": "path", "shop.checkout.create": "body", "shop.fulfill": "body", "shop.orders.cancel": "body", "shop.orders.reconcile_stale": "body", "shop.refund": "body", "shop.sandbox.simulate": "body", "shop.sinks.upsert": "body", "shop.webhooks.subscribe": "body", "showcase.catalog.apply_canonical_order": "body", "showcase.catalog.delete_entry": "body", "showcase.catalog.reorder": "path", "showcase.catalog.sync_fixture": "path", "showcase.project.heal_gallery_marks": "body", "showcase.workspace.hydrate": "body", "social.chat.index_put": "Exception: subset-as-delete with If-Match. A short list can drop missing keys. Do not apply bots-style merge defaults here.", "vision.ask": "body", "wallets.spend": "body"}}}